建立匯入任務

建立一個新的模型匯入任務。

前提條件

已配置百鍊的 API-KEY，請參考擷取API Key。
已建立 OSS Bucket，並完成百鍊平台的 OSS 授權。詳見模型匯入中的使用前提。
模型檔案已上傳至 OSS Bucket，並符合匯入要求與限制。

公用要求標頭

所有介面均需在 HTTP Header 中攜帶以下欄位：

Header	說明
Authorization	`Bearer ${DASHSCOPE_API_KEY}`，API-KEY 的擷取請參考擷取API Key。
Content-Type	`application/json`

提交一個模型匯入任務。系統將對模型檔案進行結構和安全校正，確保檔案能夠正常部署。

地址

POST https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import

請求樣本

curl -X POST "https://dashscope-intl.aliyuncs.com/api/v1/custom_models/import" \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header "Content-Type: application/json" \
    --data '{
        "model_name": "qwen3-32b",
        "display_name": "我的 LoRA 調優模型",
        "source": "oss",
        "weight_type": "lora",
        "storage_info": {
            "bucket_name": "my-model-bucket",
            "object_key": "models/qwen3-32b-lora/"
        }
    }'

請求參數

參數	類型	傳參方式	必選	說明
model_name	String	body	是	基本模型的名稱。對應控制台基本模型欄位。當前支援的模型請參見支援匯入的基本模型。樣本：`qwen3-32b`。
display_name	String	body	否	匯入模型的顯示名稱，對應控制台模型名稱欄位。最多50個字元。不傳時預設使用基本模型名稱。
source	String	body	是	匯入來源。對應控制台匯入來源欄位。當前僅支援 `oss`（從 OSS 匯入）。響應中返回大寫 `OSS`。
weight_type	String	body	是	調優類型。`full` 表示全參調優模型，`lora` 表示 LoRA 調優模型。
storage_info	Object	body	是	匯入來源的儲存資訊。
storage_info.bucket_name	String	body	是	OSS Bucket 名稱。對應控制台Bucket欄位。
storage_info.object_key	String	body	是	模型檔案所在 OSS 路徑首碼，需以 `/` 結尾。樣本：`models/qwen3-32b-lora/`。

響應樣本

{
    "request_id": "6c6b****-3fea-****-bc26-c9e2********",
    "output": {
        "job_id": "937b****-2a4f-****-8abe-c2fa********",
        "model_name": "qwen3-32b-offline-20240101-abc1",
        "display_name": "我的 LoRA 調優模型",
        "source": "OSS",
        "weight_type": "lora",
        "storage_info": {
            "bucket_name": "my-model-bucket",
            "object_key": "models/qwen3-32b-lora/"
        },
        "status": "PENDING",
        "gmt_create": "2024-01-01T12:00:00.000+00:00"
    }
}

響應參數

參數	類型	說明
request_id	String	請求 ID。
output.job_id	String	匯入任務 ID，可用於查詢匯入任務詳情、列舉匯入任務和刪除匯入任務介面。
output.model_name	String	系統產生的模型標識，格式為基本模型名稱加時間戳記尾碼。
output.display_name	String	匯入模型的顯示名稱。
output.source	String	匯入來源，傳回值為大寫 `OSS`。
output.weight_type	String	調優類型。
output.storage_info	Object	匯入來源的儲存資訊，包含 `bucket_name` 和 `object_key`。
output.status	String	任務狀態。參見任務狀態說明。
output.gmt_create	String	任務建立時間，ISO 8601 格式。樣本：`2024-01-01T12:00:00.000+00:00`。

異常響應

當請求發生錯誤時，介面將返回如下格式的錯誤響應：

{
    "request_id": "ca21****-b91b-****-bd35-c41c********",
    "code": "OperationDenied",
    "message": "The import job is currently running and cannot be deleted."
}

錯誤碼

錯誤碼	說明
InvalidParameter	請求參數無效。例如必填參數缺失、參數格式錯誤或參數值不合法。
NotFound	指定的資源不存在。例如 job_id 不存在、無權訪問或基本模型不支援匯入。
OperationDenied	操作被拒絕。例如對 RUNNING 狀態的任務執行刪除操作。
InvalidApiKey	API-KEY 無效或未提供。
InternalError	系統內部錯誤，請稍後重試。