Referencia de la API
Chat Completions
Modelos de este endpoint (5)
/v1/chat/completionsEl endpoint principal: chat multiturno, streaming, llamadas a herramientas, visión y modo JSON para todos los modelos de chat del catálogo.
#Parámetros de la solicitud
modelstringobligatorioID de modelo de /v1/models. El gateway determina el proveedor upstream a partir de este valor.
messagesarrayobligatorioTurnos de la conversación: {role: system|user|assistant|tool, content}. content puede ser un string o un array de partes multimodales.
streambooleanopcionaltrue transmite deltas SSE, cerrados con data: [DONE].
temperaturenumberopcionalDe 0 a 2. Déjalo vacío para usar el valor predeterminado del modelo.
max_tokensintegeropcionalLímite superior de tokens generados; también limita la estimación de cuota reservada previamente.
toolsarrayopcionalDeclaraciones de funciones que el modelo puede llamar — consulta la guía de llamadas a herramientas.
tool_choicestring | objectopcional"auto", "none" o fija una función concreta.
response_formatobjectopcional{"type":"json_object"} o un envoltorio json_schema para salida estructurada en los modelos compatibles.
top_pnumberopcionalMuestreo de núcleo; usa temperature o top_p, no ambos.
stopstring | arrayopcionalHasta 4 secuencias de parada que cortan la generación.
#Errores relacionados
- 400 invalid_request_errorCuerpo mal formado o parámetro no admitido para este modelo.
- 401Bearer token no válido o ausente. Esta ruta no tiene error.code — compara por el estado.
- 402 insufficient_user_quotaEl saldo de la billetera no cubre la estimación reservada previamente.
- 429Limitación por clave. Cuerpo vacío; espera el Retry-After. Un 429 que sí incluye insufficient_user_quota indica en cambio un límite de gasto diario.
- 503 model_not_foundModelo desconocido, o ningún canal sano lo atiende ahora mismo.
#Ejemplo de solicitud
curl https://www.aisplice.store/v1/chat/completions \
-H "Authorization: Bearer sk-YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-luna",
"messages": [{"role": "user", "content": "Say hello."}]
}'#Respuesta
{
"id": "chatcmpl-…",
"object": "chat.completion",
"model": "gpt-5.6-luna",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "Hello!"},
"finish_reason": "stop"
}],
"usage": {"prompt_tokens": 9, "completion_tokens": 3, "total_tokens": 12}
}¿Sigues con el problema?
Envíanos el ID de solicitud o el mensaje de error y lo revisaremos.