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/modelslista todos os modelos que sua equipe pode usar. Para um modelo específico, useGET /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 em404 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/completionsou/v1/responses, modelos de embedding em/v1/embeddingse modelos de transcrição em/v1/audio/transcriptions. Caso contrário, você recebe400 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.