Get deployment details-Alibaba Cloud Model Studio(Model Studio)-阿里云帮助中心

This operation retrieves the details of a specific deployment.

Prerequisites

You have read Introduction to model deployment and Deploy a model by using APIs and are familiar with the basic steps for model deployment on the Alibaba Cloud Model Studio platform.
You have configured your Model Studio API key. For more information, see Get API key.

Get a model deployment

Endpoint

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

Request example

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

curl "https://dashscope.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 get this value from the response of the Create deployment or List deployments operation.

Response example

A successful request returns the following response:

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

See the response parameters of the Create a model deployment operation.

Error responses

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	The unique ID for the request.
code	String	The error code.
message	String	The error message.

A failed request might return one of the following errors:

Error code	Error message	Error reason
NotFound	Model: xxx not found!	The model specified for the new deployment does not exist. The model associated with the specified deployment does not exist.
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 number of capacity units when creating or updating the deployment.