Completado de chat
Genere una respuesta del modelo a partir de una lista de mensajes.
El endpoint Chat Completions genera una respuesta del modelo a partir de una lista ordenada de mensajes. Esta página usa una solicitud de texto sin streaming.
Endpoint de solicitud
POST https://api.vergora.ai/v1/chat/completionsIncluya las siguientes cabeceras:
Authorization: Bearer YOUR_VERGORA_API_KEY
Content-Type: application/jsonCuerpo de la solicitud
{
"model": "gpt-5.6-sol",
"messages": [
{
"role": "user",
"content": "Explique de forma concisa una API de modelos unificada."
}
],
"stream": false
}Campos comunes
| Campo | Obligatorio | Descripción |
|---|---|---|
model | Sí | Un Model ID copiado del catálogo de modelos |
messages | Sí | Un array ordenado de mensajes de conversación |
messages[].role | Sí | El rol del mensaje; los roles disponibles dependen del modelo |
messages[].content | Sí | Texto u otra estructura de contenido admitida por el modelo |
temperature | No | Controla el muestreo; el rango y valor predeterminado dependen del modelo |
max_tokens | No | Límite de salida; la compatibilidad del campo depende del modelo |
stream | No | Indica si se devuelve una respuesta en streaming |
No envíe parámetros opcionales que el modelo seleccionado no admita. Para la primera prueba, use solo campos obligatorios y stream: false.
Lea la respuesta
{
"id": "example-response-id",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Esta es una respuesta de ejemplo."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 30,
"completion_tokens": 20,
"total_tokens": 50
}
}El texto generado suele estar en choices[0].message.content. Compruebe finish_reason y use usage para revisar el uso de entrada y salida. Estos campos ilustran una estructura compatible; tome la respuesta real de la API como referencia definitiva.
Conversaciones de varios turnos
Incluya en orden el historial necesario en cada nueva solicitud. Controle su longitud para evitar contenido repetido o superar el contexto del modelo. Si el contenido es sensible, envíe solo lo necesario para la tarea.
Para obtener salida incremental, continúe con Streaming.