全部產品
Search

搜尋本產品

    Platform For AI：CreateService - 建立服務

    文件中心

    Platform For AI：CreateService - 建立服務

    更新時間：Dec 23, 2025

    建立PAI-EAS服務。

    介面說明

    請確保在使用該介面前，已充分瞭解 EAS 產品的收費方式和價格。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    eas:CreateService

    create

    *全部資源

    *

    		 無 無

    請求文法

    POST /api/v2/services HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    body

    string

    否

    請求 body。其中關鍵請求參數配置說明，請參見下方的表 1. 請求 Body 參數和表 2. metadata 參數。更多參數配置詳情，請參見服務模型所有相關參數說明。

    鏡像部署服務： { "name": "foo", "metadata": { "instance": 2, "memory": 7000, "cpu": 4 }, "containers": [ { "image": "****", "script": "**** --listen=0.0.0.0 --server_port=8000 --headless", "port": 8000 } ], "storage": [ { "oss": { "path": "oss://examplebuket/data111/", "readOnly": false }, "properties": { "resource_type": "model" }, "mount_path": "/data" } ] } 鏡像部署AI-Web應用： { "name": "foo", "metadata": { "instance": 1, "memory": 7000, "cpu": 4, "enable_webservice": true }, "containers": [ { "image": "****", "script": "**** --listen=0.0.0.0 --server_port=8000 --headless", "port": 8000 } ], "storage": [ { "oss": { "path": "oss://examplebucket/data111/", "readOnly": false }, "properties": { "resource_type": "model" }, "mount_path": "/data" } ] } 模型+processor部署服務： { "metadata": { "instance": 1, "memory": 7000, "cpu": 4 }, "name": "foo", "model_config": {}, "processor_type": "python", "processor_path": "oss://****", "processor_entry": "a.py", "model_path": "oss://****" }
    Develop

    string

    否

    是否進入開發模式。

    枚舉值：

    • true :

      進入開發模式

    • false :

      不進入開發模式

    true
    Labels

    object

    否

    使用者自訂標籤。

    string

    否

    標籤。

    {"key":"value"}
    WorkspaceId

    string

    否

    工作空間 ID。

    123456

    表 1. 請求 Body 參數

    名稱類型是否必選說明
    nameString是服務名稱，在同一個地區內全域唯一。
    tokenString否指定用於訪問鑒權的 Token 字串，若不指定則按generate_token自動產生。
    model_pathString否模型相關的檔案，支援 HTTP 和 OSS 兩種格式，HTTP 地址需為 Public 可訪問的。若為 OSS 地址，則輸入可以是目錄或者檔案；若檔案為.tar.gz、.tar.bz2、.zip等壓縮包，會自動解壓。
    role_arnstring否model_path或processor_path為 OSS 地址時，需要指定用於 OSS 授權的 role_arn，role_arn 的擷取參數 Role_ARN。
    oss_endpointString否model_path或processor_path為 OSS 地址時，需要指定 OSS Bucket 對應的 endpoint。
    model_entryString否模型的入口檔案，若不指定，則使用model_path中的檔案名稱，可以包含任意檔案，主檔案的路徑會傳遞給 Processor 中的Load()函數。
    processor_pathString是Processor 相關的檔案包，支援本地檔案和 HTTP 連結地址，若檔案為.tar.gz、.tar.bz2、.zip等壓縮包，會自動解壓。
    processor_entryString否C、C++、Python 類型必選。Processor 的主檔案，其中包含了預測所需要Load()函數和Process()函數的實現。
    processor_mainclassString否Java 類型必選。Processor 的主檔案，JAR 包中的 mainclass。
    processor_typeString是processor 實現的語言，目前已支援 C、C++、Java、Python。
    metadataDict否服務的 meta 資訊。詳見下表 2。
    cloudDict否目前只有指定機型部署時會用到，傳參的樣式為"cloud":{"computing":{"instance_type": "ecs.gxxxxxx.large"}}。
    containersList否自訂鏡像部署。如果 Processor 部署無法滿足需求，可以使用自訂鏡像部署，詳情請參見服務部署：自訂鏡像。
    說明

    model_path 和 processor_path 為輸入模型資料和 processor 資料的資料來源，支援 HTTP 和 OSS 兩種資料來源，使用 test 命令進行本地調試時支援本地檔案和目錄。

    • 若使用 HTTP 地址，則需要將相關檔案打包成.tar.gz、.tar.bz2、.zip 等壓縮包，可上傳至 OSS 並產生 HTTP 地址。

    • 若使用 OSS 地址，則輸入可以是目錄，也可以是檔案。

    表 2. metadata 參數

    名稱類型是否必選描述樣本值
    instanceInt否服務啟動的 Worker 數目。1
    cpuInt否每個 Worker 需要的 CPU 數目。1
    gpuInt否每個 Worker 需要的 GPU 數目。0
    memoryInt否每個 Worker 需要的記憶體大小，單位為 MB。1000
    resourceString否服務所屬的資源群組。eas-r-aaabbbccc
    rpc.worker_threadsInt否每個 Instance 中用於並發處理請求的線程數。5
    rpc.max_queue_sizeInt否請求處理時隊列的最大長度，隊列滿時新請求會被以 450 狀態代碼丟棄。64
    rpc.keepaliveInt否請求的逾時時間，單位為毫秒。5000
    rpc.rate_limitInt否單一實例請求限流的 QPS 值，單一實例 QPS 超出該值後的請求會被返回 429 丟棄。0
    releaseBool否若為 true，則要建立一個灰階發布服務。false

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    40325405-579C-4D82****
    ServiceId

    string

    新建立服務的服務 ID。

    eas-m-aaxxxddf
    ServiceName

    string

    新建立服務的服務名字。

    yourname
    Status

    string

    新服務的目前狀態。

    Creating
    Region

    string

    新建立服務所屬的地區 ID。

    cn-shanghai
    InternetEndpoint

    string

    新建立服務的公網 Endpoint。

    http://pai-eas.vpc.cn-shanghai.****
    IntranetEndpoint

    string

    新建立服務的內網 Endpoint。

    http://pai-eas.cn-shanghai.****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "40325405-579C-4D82****",
  "ServiceId": "eas-m-aaxxxddf",
  "ServiceName": "yourname",
  "Status": "Creating",
  "Region": "cn-shanghai",
  "InternetEndpoint": "http://pai-eas.vpc.cn-shanghai.****",
  "IntranetEndpoint": "http://pai-eas.cn-shanghai.****"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。