FlowModels

Entender os IDs de modelo: o formato provedor/modelo

Publicado em 11. novembro 2026

No FlowModels, você informa o modelo em cada requisição, no campo model. O valor é sempre o identificador completo de provedor e modelo, por exemplo:

Identificador Provedor Modelo
openai/gpt-5.6-luna OpenAI gpt-5.6-luna
anthropic/claude-sonnet-5-5 Anthropic claude-sonnet-5-5
xai/grok-4.7 xAI grok-4.7
groq/openai/gpt-oss-120b Groq openai/gpt-oss-120b

A separação fica na primeira barra. Tudo antes dela é o provedor, tudo depois é o modelo, que pode ter barras também, como na Groq.

Os identificadores acima são exemplos. O que vale é sempre a sua lista de modelos atual.

Onde encontrar os identificadores

  • No dashboard: em Modelos, a coluna ID do modelo traz exatamente o valor que você envia no campo model.
  • Pela API: GET /v1/models lista todos os modelos que sua equipe pode usar. Para um modelo específico, use GET /v1/models/groq/openai/gpt-oss-120b, mantendo as barras do identificador.

Mais sobre preços e capacidades em Modelos e preços do FlowModels e O que um modelo sabe fazer.

O que não funciona

  • Nomes curtos sem provedor, como gpt-5.6-luna, resultam em 404 model_not_found. O identificador sempre precisa do provedor na frente.
  • Modelos que não estão na sua lista não podem ser chamados. A lista inclui apenas modelos liberados e com preço completo.
  • Modelos no endpoint errado: modelos de chat vão em /v1/chat/completions ou /v1/responses, modelos de embedding em /v1/embeddings e modelos de transcrição em /v1/audio/transcriptions. Caso contrário, você recebe 400 unsupported_for_model.
  • Troca para outro modelo: se o modelo escolhido não estiver acessível no momento ou tiver sido descontinuado, o FlowModels não muda para outro modelo. Você recebe um erro e decide o que fazer, veja Entender as mensagens de erro do FlowModels.

Para respostas com cabeçalho Deprecation ou Sunset ou com 410 model_deprecated, os detalhes estão em Modelos e preços do FlowModels.

Este artigo foi útil?

Voltar para Modelos, limites e erros