特定のモデルデプロイの詳細を取得します。
前提条件
-
「モデルデプロイの概要」および「API を使用したモデルデプロイ」をお読みいただき、Alibaba Cloud Model Studio でモデルをデプロイするための基本的な手順を理解している必要があります。
-
Alibaba Cloud Model Studio の API キーを設定している必要があります。詳細については、「API キーの取得」をご参照ください。
モデルデプロイの取得
エンドポイント
GET https://dashscope-intl.aliyuncs.com/api/v1/deployments/{deployed_model}
リクエスト例
次のコマンドを使用して、特定のモデルデプロイの詳細を取得します。
curl "https://dashscope-intl.aliyuncs.com/api/v1/deployments/qwen-plus-202305099980-fac9-sample" \
--header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
--header 'Content-Type: application/json'
リクエストパラメーター
|
パラメーター |
タイプ |
場所 |
必須 |
説明 |
|
deployed_model |
String |
path |
必須 |
モデルデプロイの一意の識別子です。デプロイの作成 API または デプロイのリスト表示 API のレスポンスからこの値を取得できます。 |
レスポンス例
リクエストが成功すると、次のデータが返されます。
{
"request_id": "66a855f0-a6fe-4b05-9786-fb30c7c6782d",
"output": {
"deployed_model": "emo-35b3f106-sample01",
"gmt_create": "2025-06-17T11:00:38",
"gmt_modified": "2025-06-17T11:06:13",
"status": "RUNNING",
"model_name": "emo",
"base_model": "emo",
"base_capacity": 1,
"capacity": 1,
"ready_capacity": 1,
"workspace_id": "llm-v71tlv3***",
"charge_type": "post_paid",
"creator": "175805416***",
"modifier": "175805416***"
}
}
レスポンスパラメーター
レスポンスパラメーターの説明については、「モデルデプロイタスクの作成」をご参照ください。
エラー
エラーレスポンス例
{
"request_id": "ca218d57-b91b-46b2-bd35-c41c6287bcf4",
"message": "Model: qwen-plus-20230703-cx7f not found!",
"code": "NotFound"
}
レスポンスパラメーター
|
フィールド |
タイプ |
説明 |
|
request_id |
String |
リクエストの一意の識別子で、システムによって生成されます。 |
|
code |
String |
エラーコードです。 |
|
message |
String |
エラーメッセージです。 |
次の表に、この API の一般的なエラーコードを示します。
|
エラーコード |
エラーメッセージ |
原因 |
|
NotFound |
Model: xxx not found! |
|
|
Conflict |
Deployed model xxx already exists, please specify a suffix. |
The specified suffix is already in use. |
|
InvalidParameter |
Invalid capacity (xx), capacity must be larger than or equal to 0 and multiples of 1 and less than 1000! |
You specified an invalid value for the capacity parameter. |