Deployment details - Alibaba Cloud Model Studio - Alibaba Cloud Documentation Center

Retrieves the details of a specific model deployment.

Prerequisites

You have read Introduction to model deployment and Use the API for model deployment and are familiar with the basic steps for deploying models on Model Studio.
You have configured an API key for Model Studio. For more information, see Obtain an API key.

Get a model deployment

Endpoint

GET https://dashscope-intl.aliyuncs.com/api/v1/deployments/{deployed_model}

Request example

Use the following command to retrieve the details of a specific model deployment:

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'

Request parameters

Parameter	Type	Location	Required	Description
deployed_model	String	path	Yes	The unique identifier for the model deployment. You can obtain this value from the response of the Create a deployment or List deployments operation.

Response example

A successful request returns the following data:

{
  "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***"
  }
}

Response parameters

For descriptions of the response parameters, see Create a model deployment task.

Errors

Error response example

{
    "request_id": "ca218d57-b91b-46b2-bd35-c41c6287bcf4",
    "message": "Model: qwen-plus-20230703-cx7f not found!",
    "code": "NotFound"
}

Response parameters

Field	Type	Description
request_id	String	A unique identifier for the request, generated by the system.
code	String	The error code.
message	String	The error message.

The following table describes the common error codes for this operation.

Error code	Error message	Cause
NotFound	Model: xxx not found!	You specified a non-existent model when creating a deployment. You specified a non-existent deployment when retrieving, updating, or deleting a deployment.
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.