Migre sua aplicação Anthropic para o Model Studio alterando três configurações. Este tópico aborda os parâmetros de requisição e resposta com exemplos de código.
api_key: Substitua pela Model Studio API key.base_url: Substitua por um endpoint do Model Studio listado abaixo.model: Substitua pelo nome de um modelo suportado, comoqwen3.7-plus.
- Singapore
- China (Beijing)
- Germany (Frankfurt)
- US (Virginia)
- Japan (Tokyo)
base_url:https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropicURL da requisição HTTP:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic/v1/messages{WorkspaceId} pelo seu workspace ID real.
Autenticação: Informe sua Model Studio API key no header x-api-key ou no header Authorization: Bearer.
Request Body |
Python |
model string (Required)Nome do modelo. Modelos suportados:
Supported Models Qwen-Max: qwen4-max, qwen3.8-max, qwen3.7-max, qwen3.7-max-2026-05-20, qwen3.7-max-2026-06-08Qwen-Plus: qwen3.7-plus, qwen3.7-plus-2026-05-26, qwen3.6-plus, qwen3.6-plus-2026-04-02, qwen3.5-plus, qwen3.5-plus-2026-04-20, qwen3.5-plus-2026-02-15, qwen-plus, qwen-plus-latestQwen-Flash: qwen3.8-flash, qwen3.7-flash, qwen3.7-flash-2026-07-15, qwen3.6-flash, qwen3.6-flash-2026-04-16, qwen3.5-flash, qwen3.5-flash-2026-02-23, qwen-flash, qwen-flash-2025-07-28Qwen-Coder: qwen3-coder-flashQwen-VL: qwen3-vl-plusQwen Open-Source Models: qwen3.6-27b, qwen3.5-397b-a17b, qwen3.5-122b-a10b, qwen3.5-27b, qwen3.5-35b-a3b, qwen3.8-2.4t-a95b, qwen3.8-27bThird-Party Modelsdeepseek-v4-pro, deepseek-v4-pro-0813, deepseek-v4-flash-0731, kimi-k3.1-pro, kimi-k3, kimi-k2.7-code, kimi-k2.5, glm-5.1, glm-5, MiniMax-M2.5, deepseek-v4.1-flash-1017 | |
max_tokens integer (Required)
| |
system string or array (Optional)Prompt de sistema que define o comportamento do modelo. system é um parâmetro de nível superior — o array messages não aceita a função system.Uma string equivale a um único bloco type="text". Utilize um array para marcar pontos de interrupção de cache de prompt.
Properties type string (Required)Valor fixo: text.text string (Required)O texto do prompt de sistema.cache_control object (Optional)Ponto de interrupção para cache de prompt. Em caso de acerto de cache, as requisições subsequentes são cobradas pela taxa de leitura de cache. Contém apenas type, fixado em ephemeral.
Propriedades (Qwen4) Compatível apenas com qwen4-max. Os marcadores dos blocos Qwen4 também aceitam ttl: 5m ou 1h, com padrão 5m. Consulte Cache explícito (Qwen4).type string (Obrigatório)ephemeralttl string (Opcional)TTL do cache. Aceita 5m e 1h; o padrão é 5m. | |
messages array (Required)O array de mensagens, organizado em turnos alternados de user/assistant.
messages array element role string (Required)A função da mensagem. Valores válidos: user, assistant.content string or array (Required)String de texto simples ou array de conteúdo estruturado. Uma string corresponde a um único bloco de content com type="text".
content array element types
thinking (qwen4-max) type stringthinkingthinking stringsignature stringResumo do raciocínio e assinatura criptografada. Reenvie o bloco thinking completo sem alterações nas solicitações seguintes.
Properties type string (Required)Valor fixo: text.text string (Required)O conteúdo textual.cache_control object (Optional)Ponto de interrupção para cache de prompt. Contém apenas type, fixado em ephemeral.
Propriedades (Qwen4) Compatível apenas com qwen4-max. Os marcadores dos blocos Qwen4 também aceitam ttl: 5m ou 1h, com padrão 5m. Consulte Cache explícito (Qwen4).type string (Obrigatório)ephemeralttl string (Opcional)TTL do cache. Aceita 5m e 1h; o padrão é 5m.
document (qwen4-max) type string (Required)Valor fixo: document.source object (Required)A origem dos dados da PDF.
Properties type string (Required)base64media_type stringO tipo MIME da PDF, como application/pdf. Obrigatório quando type for base64.data stringOs dados da PDF codificados em Base64. Obrigatório quando type for base64.
Properties type string (Required)Valor fixo: image.source object (Required)A origem dos dados da imagem.
Properties type string (Required)Valores válidos: url (URL pública da imagem), base64 (codificado em Base64).url stringA URL pública da imagem. Obrigatório quando type for url.media_type stringO tipo MIME da imagem, como image/jpeg. Obrigatório quando type for base64.data stringOs dados da imagem codificados em Base64. Obrigatório quando type for base64.
Properties type string (Required)Valor fixo: video.source object (Required)A origem dos dados de vídeo.
Properties type string (Required)Valores válidos: url (URL pública do vídeo), base64 (codificado em Base64).url stringA URL pública do vídeo. Obrigatório quando type for url.media_type stringO tipo MIME do vídeo, como video/mp4. Obrigatório quando type for base64.data stringOs dados do vídeo codificados em Base64. Obrigatório quando type for base64.messages[].content, use um bloco de conteúdo type: "document", defina source.type como url e especifique a URL do arquivo PDF em source.url.Para entrada por URL, type é obrigatório e tem o valor fixo document; source é um objeto obrigatório. Dentro de source, type é uma string obrigatória definida como url, e url é uma string obrigatória que contém a URL do arquivo PDF.Este exemplo usa a região de Singapura. Substitua {WorkspaceId} pelo ID do seu espaço de trabalho e defina a variável de ambiente DASHSCOPE_API_KEY com sua chave de API do Model Studio.
Properties type string (Required)Valor fixo: tool_use.id string (Required)Identificador único da chamada de ferramenta, usado para associar o resultado em um tool_result subsequente.name string (Required)O nome da ferramenta invocada.input object (Required)Os parâmetros de entrada da chamada de ferramenta. A estrutura é determinada pelo input_schema da ferramenta correspondente em tools.cache_control object (Optional)Ponto de interrupção para cache de prompt. Contém apenas type, fixado em ephemeral. O conteúdo da chamada de ferramenta participa do prefixo de cache.
Propriedades (Qwen4) Compatível apenas com qwen4-max. Os marcadores dos blocos Qwen4 também aceitam ttl: 5m ou 1h, com padrão 5m. Consulte Cache explícito (Qwen4).type string (Obrigatório)ephemeralttl string (Opcional)TTL do cache. Aceita 5m e 1h; o padrão é 5m.
Properties type string (Required)Valor fixo: tool_result.tool_use_id string (Required)Corresponde ao id no bloco tool_use.content string (Required)Conteúdo retornado pela ferramenta.cache_control object (Optional)Ponto de interrupção para cache de prompt. Contém apenas type, fixado em ephemeral.
Propriedades (Qwen4) Compatível apenas com qwen4-max. Os marcadores dos blocos Qwen4 também aceitam ttl: 5m ou 1h, com padrão 5m. Consulte Cache explícito (Qwen4).type string (Obrigatório)ephemeralttl string (Opcional)TTL do cache. Aceita 5m e 1h; o padrão é 5m. | |
cache_control object (Opcional)Compatível apenas com qwen4-max. Ativa o cache automático na raiz; pontos manuais também podem ser definidos nos blocos de conteúdo. type é fixado em ephemeral. Envie parâmetros não padrão da raiz por extra_body no SDK Python, ou diretamente no SDK Node.js e curl. Consulte Cache explícito (Qwen4).
Propriedades type string (Obrigatório)ephemeralttl string (Opcional)TTL do cache. Aceita 5m e 1h; o padrão é 5m.boolean (Optional)Ativa ou desativa o streaming. Valor padrão: false. | |
temperature number (Optional)Controla a diversidade do texto gerado. Intervalo de valores: [0, 2). Valores mais altos produzem resultados mais aleatórios.Este intervalo difere do intervalo oficial da Anthropic, que é [0,0, 1,0]. Ao migrar da Anthropic, verifique o valor deste parâmetro. | |
top_p number (Optional)Limiar de probabilidade para amostragem nuclear.Tanto | |
top_k integer (Optional)Tamanho do conjunto de candidatos durante a amostragem. | |
stop_sequences array (Optional)Sequências de texto que acionam a parada da geração. A saída termina antes da sequência correspondente.Após uma correspondência, o stop_reason na resposta ainda será end_turn, e a resposta não incluirá a sequência encontrada. | |
thinking object (Optional)kimi-k3.1-pro ativa o pensamento por padrão.Configuração de extended thinking. Quando ativado, o modelo raciocina antes de responder, e a resposta inclui blocos de conteúdo do tipo thinking. Nem todos os modelos suportam o modo de raciocínio.
Properties type string (Required)Valores válidos: enabled (ativa o modo de raciocínio), disabled (desativa o modo de raciocínio).budget_tokens integer (Optional, to be deprecated)
Este parâmetro será descontinuado. Para novas integrações, utilize Máximo de tokens para o processo de raciocínio. A relação com max_tokens depende do modelo; consulte a descrição do parâmetro max_tokens. Um orçamento maior permite análises mais detalhadas em questões complexas. Entra em vigor quando type é enabled.display string (opcional)qwen4-max: "summarized". Resumo e criptografia do raciocínio.Por padrão, o raciocínio completo é retornado. Quando ativado, o raciocínio original deixa de ser retornado em texto simples: o resumo serve para exibição e o conteúdo criptografado para restaurar o histórico. | |
tools array (Optional)Definições de ferramentas para function calling.
tools array element name string (Required)O nome da ferramenta.description string (Optional)A descrição da função da ferramenta.input_schema object (Required)A definição JSON Schema dos parâmetros de entrada da ferramenta.kimi-k3.1-pro (implantado no Alibaba Cloud Model Studio) suporta web_search e web_fetch em Pequim, Singapura, EUA (Virgínia), Alemanha (Frankfurt), Japão (Tóquio) e China (Hong Kong).deepseek-v4.1-flash-1017 suporta as ferramentas de pesquisa na web web_search e de obtenção de páginas web web_fetch. Para os requisitos e exemplos de requisições compatíveis com Anthropic, consulte Extrator web. | |
qwen4-max: web_search, web_fetch.Adicione a ferramenta com o nome web_fetch a tools e inclua a ferramenta com o nome web_search na mesma solicitação. O endpoint é https://{WorkspaceId}.{region}.maas.aliyuncs.com/apps/anthropic.
web_fetch (qwen4-max) type stringweb_fetch_20250910name stringweb_fetchmax_uses integerobject (Optional)Estratégia de seleção de ferramentas:
| |
output_config object (Optional)
Properties effort string (Optional)qwen4-maxValores aceitos: low, high (padrão) e xhigh.medium é mapeado para high; max é mapeado para xhigh.Controla a intensidade de inferência dos modelos. Os valores válidos e padrões variam conforme o modelo.Para kimi-k3.1-pro (implantado no Alibaba Cloud Model Studio), o padrão é max. Os valores suportados são max (raciocínio profundo), high (raciocínio aprimorado), medium (raciocínio moderado) e low (raciocínio leve).
object (Optional)Configuração de saída estruturada. Quando habilitada, o modelo retorna uma string JSON. O comportamento varia conforme o modelo:
Properties type string (Required)Valor fixo: json_schema.schema object (Required)Objeto JSON Schema que segue a especificação padrão. Deve incluir type (tipo de dado), properties (definições de campos), required (array de nomes de campos obrigatórios) e additionalProperties (deve ser definido como false). |
Non-streaming Response | Response ExampleO exemplo de resposta abaixo usa qwen3.8-max para ilustrar os campos da resposta. | |||||||||||||||||||||||||||||||||||||||||||||||
id stringIdentificador único da mensagem. | ||||||||||||||||||||||||||||||||||||||||||||||||
type stringValor fixo: message. | ||||||||||||||||||||||||||||||||||||||||||||||||
role stringValor fixo: assistant. | ||||||||||||||||||||||||||||||||||||||||||||||||
model stringO modelo utilizado para geração. | ||||||||||||||||||||||||||||||||||||||||||||||||
content arrayO array de conteúdo.
content array element types Text
Properties type stringValor fixo: text.text stringA resposta textual gerada pelo modelo.
Properties type stringValor fixo: thinking.thinking stringO raciocínio do modelo antes da resposta final.signature stringqwen4-max, thinking.display="summarized": O bloco thinking de Anthropic Messages contém o resumo thinking e a signature criptografada. O streaming envia primeiro thinking_delta, depois signature_delta completo; texto ou ferramentas vêm após o fechamento do bloco. A signature pode estar vazia se a criptografia falhar ou não houver raciocínio.thinking.display != "summarized": Atualmente fixado como uma string vazia.
Properties type stringValor fixo: tool_use.id stringIdentificador único da chamada de ferramenta, usado para corresponder ao tool_result.name stringO nome da ferramenta invocada.input objectOs parâmetros de entrada da chamada de ferramenta.web_fetch_tool_result)
Resultado da busca de página
| ||||||||||||||||||||||||||||||||||||||||||||||||
stop_reason stringMotivo da interrupção da geração. Valores válidos: end_turn (conclusão normal), max_tokens (limite de tokens atingido), tool_use (chamada de ferramenta). | ||||||||||||||||||||||||||||||||||||||||||||||||
stop_sequence stringSempre null. | ||||||||||||||||||||||||||||||||||||||||||||||||
usage objectEstatísticas de uso de tokens.Em chamadas com streaming, o campo usage do evento message_start contém apenas input_tokens e output_tokens. Os quatro campos completos são retornados no evento message_delta.
Properties input_tokens integerTokens de entrada.output_tokens integerTokens de saída.cache_creation_input_tokens integerTokens consumidos para criação de cache.cache_read_input_tokens integerTokens consumidos em leituras de cache.server_tool_use object
server_tool_use web_search_requests integerNúmero de solicitações de pesquisa web.web_fetch_requests integerNúmero de solicitações de busca de páginas web.
Propriedades (Qwen4) Consulte Cache explícito (Qwen4).input_tokens integerApenas tokens de entrada que não são lidos nem gravados no cache. A entrada total é a soma deste campo, das leituras e das gravações no cache.output_tokens integerTokens de saída.cache_creation_input_tokens integerTokens consumidos para criação de cache.cache_read_input_tokens integerTokens consumidos em leituras de cache.server_tool_use object
server_tool_use web_search_requests integerNúmero de solicitações de pesquisa web.web_fetch_requests integerNúmero de solicitações de busca de páginas web.objectDetalhes de gravação no cache por TTL. A soma dos tokens dos dois TTLs equivale ao total gravado no cache nesta solicitação.
Propriedades ephemeral_5m_input_tokens integerTokens gravados em um cache de 5 minutos.ephemeral_1h_input_tokens integerTokens gravados em um cache de 1 hora.objectDetalhes de leitura do cache. cached_tokens é igual a cache_read_input_tokens; não some os dois valores.
Propriedades cached_tokens integerTokens de entrada lidos do cache. |
Streaming Response | Streaming response exampleO exemplo de resposta abaixo usa qwen3.8-max para ilustrar os campos da resposta. |
message_startPrimeiro evento do fluxo, marca o início da mensagem.
Properties type stringValor fixo: message_start.message objectO objeto inicial da mensagem. content é um array vazio, e usage contém apenas input_tokens e output_tokens. | |
content_block_startMarca o início de um bloco de conteúdo.
Properties type stringValor fixo: content_block_start.index integerÍndice baseado em zero correspondente à posição no array content.content_block objectO objeto inicial do bloco de conteúdo. O valor de type é text, thinking ou tool_use, server_tool_use, web_search_tool_result, web_fetch_tool_result. Para o tipo tool_use, o campo input é um objeto vazio neste evento, e os parâmetros de entrada completos são montados a partir dos deltas content_block_delta subsequentes. | |
content_block_deltaAtualização incremental do bloco de conteúdo. Múltiplos deltas são enviados por bloco.
Properties type stringValor fixo: content_block_delta.index integerO índice do bloco de conteúdo associado.delta objectObjeto delta. Valores de type:
| |
content_block_stopMarca o fim de um bloco de conteúdo.
Properties type stringValor fixo: content_block_stop.index integerO índice do bloco de conteúdo finalizado. | |
message_deltaEnviado após o término de todos os blocos de conteúdo. Contém o motivo da parada e o uso final de tokens.
Properties type stringValor fixo: message_delta.delta objectContém stop_reason e stop_sequence. Para valores válidos, consulte a tabela de Resposta Sem Streaming acima.usage objectEstatísticas completas de uso de tokens, incluindo input_tokens, output_tokens, cache_creation_input_tokens e cache_read_input_tokens. | |
message_stopEvento final, marca o encerramento da mensagem.
Properties type stringValor fixo: message_stop.Além disso, respostas em streaming enviam periodicamente eventos de ping ({"type":"ping"}) para manter a conexão ativa. Os clientes podem ignorá-los. |
FAQ
Após configurar o Claude Desktop ou Claude Code, o teste de conexão falha comModel discovery — Gateway /v1/models returned HTTP 404, ou a URL da requisição contém/v1/v1/models. Como resolver?
O recurso de descoberta de modelos de clientes como Claude Desktop e Claude Code adiciona automaticamente /v1/models à URL base configurada. Verifique os dois pontos a seguir:
- Não termine a URL base com/v1/: ela deve terminar em
/apps/anthropic(por exemplo, para China (Beijing) usehttps://dashscope.aliyuncs.com/apps/anthropic; consulte as informações de endpoint acima para outras regiões). Se você inserir incorretamente.../apps/anthropic/v1/, o cliente anexará/v1/modelse produzirá o caminho duplicado/v1/v1/models, que retorna HTTP 404. Portanto, ao receber um erro 404, verifique primeiro se a URL real da requisição contém um/v1/v1/duplicado; nesse caso, remova o/v1/final da URL base. - Adicione modelos manualmente para pular a descoberta: o endpoint compatível com Anthropic do Model Studio fornece apenas a Messages API (
/v1/messages) e não oferece um endpoint de lista de modelos (/v1/models), logo a requisição de descoberta também retorna 404. Adicione modelos manualmente (por exemplo,qwen3.7-plus) na seção Models do cliente para evitar a descoberta automática.