Skip to main content

Listar modelos

Recupere a lista de modelos disponíveis no Model Studio. Você pode filtrar por provedor do modelo, tipo de modalidade, capacidade do modelo e modo de implantação, e obter informações como preços e comprimento de contexto.

  • Singapura
  • China (Pequim)
  • China (Hong Kong)
  • Alemanha (Frankfurt)
  • Japão (Tóquio)
  • EUA (Virgínia)
GEThttps://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/models

Cabeçalhos da solicitação

AuthorizationStringObrigatório
Use o formato Bearer <API Key>. Na página de gerenciamento de chaves de API da região selecionada, selecione um workspace e obtenha a chave de API.

Parâmetros de consulta

nameStringOpcional
Busca aproximada pelo nome do modelo. Exemplo: qwen
modelStringOpcional
Correspondência exata pelo ID do modelo. Exemplo: qwen3.8-max
languageStringOpcional
Idioma da resposta. Valores válidos: zh-CN (Chinês), en-US (Inglês).
page_noIntegerOpcional
Número da página, começando em 1. Valor padrão: 1. Incremente page_no para obter as páginas seguintes. Consulte total em output para saber quando todos os modelos correspondentes foram recuperados.
page_sizeIntegerOpcional
Número de modelos por página. Valor padrão: 20.
providersArray[String]Opcional
Filtrar por provedor de modelo. O parâmetro provider do SDK Python DashScope 2.x filtra apenas a página atual no cliente. O valor de total_count continua sendo o total anterior à filtragem.
  • qwen: Qwen
  • deepseek: DeepSeek
  • zhipu-ai: Zhipu AI
  • wan: Wan
  • moonshot-ai: Moonshot AI
  • mini-max: MiniMax
  • kling: Kling AI
  • vidu: Vidu
  • pixverse: PixVerse
  • xiaomi: Xiaomi
  • tripo: Tripo
  • happyhorse: HappyHorse
  • qwen-domain-model: Modelo de Domínio Qwen
Exemplo: providers=qwen&providers=deepseek
inference_providersArray[String]Opcional
Filtrar por provedor de inferência.
  • aliyun-bailian: Alibaba Cloud Model Studio
  • alibaba-cloud-modelstudio: Alibaba Cloud Model Studio
  • siliconflow: SiliconFlow
  • moonshot: Kimi
  • mini-max: MiniMax
  • kling: Kling AI
  • vidu: Vidu
  • pixverse: PixVerse
  • vanchin: Kuaishou Wanqing
  • xiaomi: Xiaomi MiMo
  • zhipu-ai: Zhipu AI
  • tripo: Tripo
capabilitiesArray[String]Opcional
Filtrar por tipo de modalidade.Use a API HTTP para aplicar esse filtro. Para passar vários valores, repita o nome do parâmetro, por exemplo capabilities=TG&capabilities=Reasoning, para encontrar modelos que ofereçam geração de texto ou raciocínio.
  • TG: Geração de Texto
  • Reasoning: Raciocínio Avançado
  • VU: Compreensão Visual
  • IG: Geração de Imagens
  • VG: Geração de Vídeo
  • ASR: Reconhecimento de Fala
  • TTS: Texto para Fala
  • TR: Embedding de Texto
  • ME: Embedding Multimodal
  • Multimodal-Omni: Omni
  • Realtime-Omni: Omni em Tempo Real
  • Realtime-Text-to-Speech: Texto para Fala em Tempo Real
  • Realtime-ASR: Reconhecimento de Fala em Tempo Real
  • Realtime-Audio-Translate: Tradução de Áudio em Tempo Real
  • 3D-generation: Geração 3D
  • Realtime-Chatting: Chat de Voz em Tempo Real
Exemplo: capabilities=TG&capabilities=Reasoning
featuresArray[String]Opcional
Filtrar por capacidade do modelo. Use a API HTTP para aplicar esse filtro.
  • function-calling: Chamada de Função
  • structured-outputs: Saídas Estruturadas
  • web-search: Pesquisa na Web
  • prefix-completion: Conclusão de Prefixo
  • cache: Cache de Contexto
  • batch: Inferência em Lote
  • fine-tuning: Ajuste Fino
  • model-experience: Playground de Modelos
context_windowIntegerOpcional
Filtra por comprimento de contexto. Retorna modelos cujo comprimento de contexto é estritamente menor que o valor especificado. Exemplo: 20000.
service_siteStringOpcional
Filtrar por modo de implantação. Se não especificado, modelos de todos os modos de implantação serão retornados.
  • global: Global
  • international: Internacional (excluindo a China Continental)
  • asia-pacific-china: China Continental
  • cn-hongkong: China (Hong Kong)
  • european-union: União Europeia
  • united-states: Estados Unidos
  • japan: Japão
supportsArray[String]Opcional
Filtrar por caso de uso suportado. Valor padrão: inference.
  • inference: Modelos que suportam inferência
  • deploy: Modelos que suportam implantação
deployment_methodsArray[String]Opcional
Filtrar por método de implantação.
  • ptu: Unidade de Taxa de Transferência Provisionada
deployment_ptu_service_tiersArray[String]Opcional
Filtrar por tipo de PTU. Você também deve definir deployment_methods para incluir ptu.

Parâmetros da resposta

codeString | null
Código de erro. O valor é null quando a consulta é bem-sucedida.
messageString | null
Mensagem de erro. O valor é null quando a consulta é bem-sucedida.
successBoolean
Indica se a consulta foi bem-sucedida.
outputObject
Lista de modelos e informações de paginação.
totalNumber
Número total de modelos correspondentes. O SDK Python DashScope 2.x fornece esse valor no campo total_count do objeto retornado.
page_noNumber
Número da página atual.
page_sizeNumber
Número de itens por página.
modelsArray[Object]
Lista de modelos. Cada elemento é um objeto de modelo. Cada exemplo de resposta mostra um modelo. A quantidade de modelos, os detalhes e os preços dependem da resposta real.
modelString
ID do modelo, usado para especificar o modelo nas chamadas de API.
nameString
Nome de exibição do modelo.
descriptionString
Descrição do modelo.
providerString
Provedor do modelo, como qwen.
capabilitiesArray[String]
Tipos de modalidade suportados pelo modelo. Os valores são os mesmos do parâmetro de solicitação capabilities.
inference_providerString
Provedor de inferência, como aliyun-bailian.
featuresArray[String]
Capacidades suportadas pelo modelo. Os valores são os mesmos do parâmetro de solicitação features.
pricesArray[Object]
Preços do modelo por faixa de cobrança.
pricesArray[Object]
Lista de preços desta faixa.
  • type: Item de cobrança.
  • price: Preço unitário.
  • price_unit: Unidade, por exemplo, por milhão de tokens.
  • price_name: Descrição do preço, por exemplo, Entrada.
range_nameString
Nome da faixa de cobrança. O valor é Default para preço fixo ou uma faixa como 32k<Input<=128k para preços escalonados.
published_timeString
Data de lançamento do modelo no formato yyyy-MM-dd HH:mm:ss. Pode ser null.
inference_metadataObject
Informações de modalidade de entrada e saída do modelo. Contém os seguintes campos:
  • request_modality (Array[String]): Modalidades de entrada. Valores válidos: Text, Image, Audio, Video.
  • response_modality (Array[String]): Modalidades de saída. Mesmos valores válidos acima.
model_infoObject
Informações sobre o comprimento de contexto do modelo. Um valor de null indica sem limite ou não aplicável. Contém os seguintes campos:
  • context_window (Integer): Comprimento total da janela de contexto
  • max_input_tokens (Integer): Máximo de tokens de entrada
  • max_output_tokens (Integer): Máximo de tokens de saída
  • max_reasoning_tokens (Integer): Máximo de tokens de raciocínio
  • reasoning_max_input_tokens (Integer): Máximo de tokens de entrada para raciocínio
  • reasoning_max_output_tokens (Integer): Máximo de tokens de saída para raciocínio
equivalent_snapshotString
O modelo de snapshot correspondente.
inference_offline_infoObject
Informações sobre a desativação da inferência. Cada entrada ($) contém o campo a seguir.
offline_timeDate
Data e hora estimadas da desativação.
request_idString
ID da solicitação para solução de problemas.
  • Consulta padrão
  • Consultar por ID do modelo
  • Consultar por provedor do modelo
  • Consultar por capacidade
curl
curl --get "https://WorkspaceId.ap-southeast-1.maas.aliyuncs.com/api/v1/models" \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -d "page_no=1" \
    -d "page_size=20"
Exemplo
{
    "code": null,
    "message": null,
    "success": true,
    "output": {
        "total": 168,
        "page_no": 1,
        "page_size": 20,
        "models": [
            {
                "model": "qwen3.8-max",
                "name": "Qwen3.8-Max",
                "description": "The Max model in the Qwen3 series, designed for complex agent scenarios.",
                "features": [
                    "function-calling",
                    "structured-outputs",
                    "web-search"
                ],
                "prices": [
                    {
                        "prices": [
                            {
                                "type": "input_token",
                                "price": "2",
                                "price_unit": "per million tokens",
                                "price_name": "Input"
                            },
                            {
                                "type": "output_token",
                                "price": "8",
                                "price_unit": "per million tokens",
                                "price_name": "Output"
                            }
                        ],
                        "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,
                    "reasoning_max_input_tokens": null,
                    "reasoning_max_output_tokens": null
                }
            }
        ]
    },
    "request_id": "ID real da solicitação"
}

Códigos de erro

Se a chamada falhar, uma mensagem de erro será retornada. Para mais informações sobre códigos de erro e soluções, consulte Mensagens de erro.