Skip to main content
更多

查詢模型列表

調用 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"
}

錯誤碼

如果調用失敗，會返回錯誤資訊。更多錯誤碼及解決方案，請參見錯誤資訊。
使用 API
文本產生
映像產生
視頻產生
音頻
即時多模態
Realtime API
  • 概述
向量與排序
更多模型
工具包/架構
模型生產
檔案管理
更多