Alibaba Cloud Model Studio：查詢模型列表

調用 GET /api/v1/models 介面查詢百鍊平台上可用的模型列表，支援按模型作者、模態類型、模型能力、部署模式等條件式篩選，並擷取模型的定價和上下文長度等資訊。

前提條件

已建立 API Key 並配置為環境變數 DASHSCOPE_API_KEY。配置方法請參見配置API Key到環境變數。

請求說明

• HTTP 方法：GET

• 請求地址

  調用時請將 {WorkspaceId} 替換為您的業務空間 ID。

  地區	Endpoint
  華北2（北京）	https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/models
  新加坡	https://dashscope-intl.aliyuncs.com/api/v1/models
  中國香港	https://cn-hongkong.dashscope.aliyuncs.com/api/v1/models
  日本（東京）	https://{WorkspaceId}.ap-northeast-1.maas.aliyuncs.com/api/v1/models
  德國（法蘭克福）	https://{WorkspaceId}.eu-central-1.maas.aliyuncs.com/api/v1/models
  美國（維吉尼亞）	https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/api/v1/models

• 認證方式

  在請求 Header 中設定 Authorization: Bearer {API_KEY}。

請求參數

所有參數均通過 Query String 傳遞。

參數	類型	必選	描述
name	String	否	按模型名稱進行模糊搜尋。樣本：qwen
model	String	否	按模型 ID 進行精確查詢。樣本：qwen3-max
language	String	否	返回結果的語言。可選值：zh-CN（中文）、en-US（英文）。
page_no	Integer	否	頁碼，從 1 開始。預設值：1。
page_size	Integer	否	每頁返回的模型數量。預設值：20。
providers	Array[String]	否	供應商，可選值 qwen：阿里巴巴-千問 zhipu-ai：智譜AI wan：阿里巴巴-萬相 qwen-domain-model：阿里巴巴-領域模型 mini-max：MiniMax moonshot-ai：月之暗面 deepseek：DeepSeek happyhorse：阿里巴巴-HappyHorse kling：可靈AI pixverse：PixVerse vidu：Vidu tripo：Tripo xiaomi：小米MiMo
inference_providers	Array[String]	否	按推理服務供應商篩選。可選值： aliyun-bailian：阿里雲百鍊 alibaba-cloud-modelstudio：Alibaba Cloud Model Studio siliconflow：矽基流動 moonshot：Kimi mini-max：MiniMax kling：Kling AI vidu：Vidu pixverse：PixVerse vanchin：快手萬擎 xiaomi：小米MiMo zhipu-ai：Zhipu AI tripo：Tripo
capabilities	Array[String]	否	模型類型，可選值 Reasoning :深度思考 VU :視覺理解 IG :圖片產生 VG :視頻產生 ASR :語音辨識 TTS :語音合成 ME :多模態向量 Realtime-Omni :即時全模態 Multimodal-Omni :全模態 Realtime-Text-to-Speech :即時語音合成 TG :文本產生 TR :文本向量 Realtime-ASR :即時語音辨識 Realtime-Audio-Translate :即時語音翻譯 3D-generation :3D 產生 Realtime-Chatting :即時語音對話
features	Array[String]	否	模型能力，可選值 model-experience :模型體驗 function-calling :function calling structured-outputs :結構化輸出 web-search :連網搜尋 prefix-completion :首碼續寫 cache :cache緩衝 batch :批量推理 fine-tuning :模型調優
context_window	Integer	否	按上下文長度篩選，返回上下文長度大於等於該值的模型。樣本：20000
service_site	String	否	按部署模式篩選。不傳時返回所有部署模式的模型。可選值： global：全球 international：國際 asia-pacific-china：中國 cn-hongkong：中國香港 european-union：歐盟 united-states：美國 japan：日本
supports	Array[String]	否	按模型支援的應用情境篩選。預設值：inference。可選值： inference：支援推理的模型 deploy：支援部署的模型
deployment_methods	Array[String]	否	按部署方式篩選。可選值： ptu：預置輸送量（Provisioned Throughput Unit）
deployment_ptu_service_tiers	Array[String]	否	按 PTU 類型篩選，使用時需同時設定 deployment_methods 包含 ptu。

返回參數

參數	類型	描述
request_id	String	請求 ID，用於問題排查。
output.total	Number	合格模型總數。
output.page_no	Number	當前頁碼。
output.page_size	Number	每頁條數。
output.models[].model	String	模型 ID，用於 API 呼叫時指定模型。
output.models[].name	String	模型的名稱。
output.models[].description	String	模型的功能描述。
output.models[].provider	String	模型作者，如 qwen。
output.models[].inference_provider	String	推理服務供應商，如 aliyun-bailian。
output.models[].capabilities	Array[String]	模型支援的模態類型，取值與請求參數 capabilities 一致。
output.models[].features	Array[String]	模型支援的能力列表，取值與請求參數 features 一致。
output.models[].published_time	String	模型發布時間，格式：yyyy-MM-dd HH:mm:ss。可能為 null。
output.models[].inference_metadata	Object	模型的輸入輸出模態資訊，包含以下欄位： request_modality（Array[String]）：輸入模態，可選值為 Text、Image、Audio、Video。 response_modality（Array[String]）：輸出模態，可選值同上。
output.models[].model_info	Object	模型的上下文長度資訊，包含以下欄位（值為 null 表示無限制或不適用）： context_window（Integer）：上下文視窗總長度 max_input_tokens（Integer）：最大輸入 Token 數 max_output_tokens（Integer）：最大輸出 Token 數 max_reasoning_tokens（Integer）：最大推理 Token 數 reasoning_max_input_tokens（Integer）：最大輸入（思考） reasoning_max_output_tokens（Integer）：最大輸出（思考）
output.models[].prices	Array[Object]	模型定價資訊。每個元素包含： range_name（String）：分段名稱。如無分段計費則為 Default，如有分段則為具體區間（如 32k<Input<=128k）。 prices（Array[Object]）：價格列表，每項包含 type（計費項目）、price（單價）、price_unit（單位，如"每百萬tokens"）、price_name（價格描述，如"輸入"）。
output.models[].equivalent_snapshot	String	對應的快照模型

請求樣本

樣本一：查詢所有文本產生模型

curl "https://dashscope-intl.aliyuncs.com/api/v1/models?capabilities=TG&page_no=1&page_size=20" \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header "Content-Type: application/json"

樣本二：查詢 Qwen 系列的推理模型

curl "https://dashscope-intl.aliyuncs.com/api/v1/models?providers=qwen&capabilities=TG&capabilities=Reasoning&page_no=1&page_size=100" \
    --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
    --header "Content-Type: application/json"

返回樣本

{
    "code": null,
    "message": null,
    "success": true,
    "output": {
        "total": 168,
        "page_no": 1,
        "page_size": 10,
        "models": [
            {
                "model": "qwen3-max",
                "name": "通義千問3-Max",
                "description": "通義千問3系列Max模型，適配情境更加複雜的智能體需求。",
                "features": [
                    "function-calling",
                    "structured-outputs",
                    "web-search"
                ],
                "prices": [
                    {
                        "prices": [
                            {
                                "type": "input_token",
                                "price": "2",
                                "price_unit": "每百萬tokens",
                                "price_name": "輸入"
                            },
                            {
                                "type": "output_token",
                                "price": "8",
                                "price_unit": "每百萬tokens",
                                "price_name": "輸出"
                            }
                        ],
                        "range_name": "Default"
                    }
                ],
                "published_time": "2025-11-11 12:00:00",
                "inference_metadata": {
                    "response_modality": ["Text"],
                    "request_modality": ["Text"]
                },
                "model_info": {
                    "context_window": 131072,
                    "max_input_tokens": 130048,
                    "max_output_tokens": 16384,
                    "max_reasoning_tokens": null
                }
            },
            {
                "model": "qwen-image-max",
                "name": "Qwen-Image-Max",
                "description": "通義千問映像產生模型Max系列。",
                "features": ["model-experience"],
                "prices": [
                    {
                        "prices": [
                            {
                                "type": "image_number",
                                "price": "0.075",
                                "price_unit": "每張",
                                "price_name": "映像產生"
                            }
                        ],
                        "range_name": "Default"
                    }
                ],
                "published_time": null,
                "inference_metadata": {
                    "response_modality": ["Image"],
                    "request_modality": ["Text"]
                },
                "model_info": {
                    "context_window": null,
                    "max_input_tokens": null,
                    "max_output_tokens": null,
                    "max_reasoning_tokens": null
                }
            }
        ]
    },
    "request_id": "d5f5201f-ee7a-9e3d-8569-bc0eedec21f9"
}

錯誤碼

如果調用失敗，會返回錯誤資訊。更多錯誤碼及解決方案，請參見錯誤資訊。