Geração de respostas de chat
Gere uma resposta do modelo a partir de uma lista de mensagens.
O endpoint Chat Completions gera uma resposta do modelo a partir de uma lista ordenada de mensagens. Esta página usa uma solicitação de texto sem streaming.
Endpoint da solicitação
POST https://api.vergora.ai/v1/chat/completionsInclua os seguintes cabeçalhos:
Authorization: Bearer YOUR_VERGORA_API_KEY
Content-Type: application/jsonCorpo da solicitação
{
"model": "gpt-5.6-sol",
"messages": [
{
"role": "user",
"content": "Explique de forma concisa uma API de modelos unificada."
}
],
"stream": false
}Campos comuns
| Campo | Obrigatório | Descrição |
|---|---|---|
model | Sim | Um Model ID copiado do catálogo de modelos |
messages | Sim | Um array ordenado de mensagens da conversa |
messages[].role | Sim | O papel da mensagem; os papéis disponíveis dependem do modelo |
messages[].content | Sim | Texto ou outra estrutura de conteúdo compatível com o modelo |
temperature | Não | Controla a amostragem; a faixa e o valor padrão dependem do modelo |
max_tokens | Não | Limite de saída; o suporte ao campo depende do modelo |
stream | Não | Define se a resposta será retornada em streaming |
Não envie parâmetros opcionais incompatíveis com o modelo selecionado. No primeiro teste, use apenas campos obrigatórios e stream: false.
Leia a resposta
{
"id": "example-response-id",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Esta é uma resposta de exemplo."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 30,
"completion_tokens": 20,
"total_tokens": 50
}
}O texto gerado normalmente está em choices[0].message.content. Verifique finish_reason e use usage para revisar o uso de entrada e saída. Esses campos ilustram uma estrutura compatível; considere a resposta real da API como referência definitiva.
Conversas com vários turnos
Inclua o histórico necessário em ordem a cada nova solicitação. Controle seu tamanho para evitar conteúdo repetido ou exceder o contexto do modelo. Se o conteúdo for sensível, envie apenas o necessário à tarefa.
Para saída incremental, continue em Streaming.