Referencia de la API

Chat Completions

POST/v1/chat/completions

El 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

  • modelstringobligatorio

    ID de modelo de /v1/models. El gateway determina el proveedor upstream a partir de este valor.

  • messagesarrayobligatorio

    Turnos de la conversación: {role: system|user|assistant|tool, content}. content puede ser un string o un array de partes multimodales.

  • streambooleanopcional

    true transmite deltas SSE, cerrados con data: [DONE].

  • temperaturenumberopcional

    De 0 a 2. Déjalo vacío para usar el valor predeterminado del modelo.

  • max_tokensintegeropcional

    Límite superior de tokens generados; también limita la estimación de cuota reservada previamente.

  • toolsarrayopcional

    Declaraciones 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_pnumberopcional

    Muestreo de núcleo; usa temperature o top_p, no ambos.

  • stopstring | arrayopcional

    Hasta 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.

Tabla completa de códigos de error →

#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

response.json
{
  "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.