Protocolos

Synthorai expone tres protocolos de entrada en la misma URL base. Elija el que coincida con su SDK; la pasarela gestiona la traducción de protocolo al proveedor de origen de forma transparente.

Matriz de protocolos

Endpoint	SDK	Ideal para
`POST /v1/chat/completions`	OpenAI SDK	Universal — funciona para todos los proveedores. e.g. `gpt-5.4-mini, qwen3.5-flash, gemini-2.5-flash, claude-sonnet-4-6`
`POST /v1/responses`	OpenAI SDK (Responses)	Uso de herramientas, razonamiento, salida estructurada. e.g. `gpt-5.4, gpt-5.4-mini, gpt-5.3-codex`
`POST /v1/messages`	Anthropic SDK	Flujos nativos de Claude mediante canales Anthropic o Bedrock. e.g. `claude-sonnet-4-6, claude-opus-4-1`

¿Cuál debo usar?

¿Ya usa el SDK de OpenAI? Sígalo usando. /v1/chat/completions es la ruta universal y enruta a cualquier proveedor configurado.
¿Ya usa el SDK de Anthropic? Apunte su baseURL a la pasarela y llame a /v1/messages. Enruta a los canales de Anthropic o Bedrock-Anthropic.
¿Necesita tool use, razonamiento o salida estructurada en modelos OpenAI? Use /v1/responses.

ℹ

Los tres protocolos comparten la misma clave API, límites de tasa, facturación y cuota. La única diferencia es la forma de solicitud/respuesta — la pasarela lo normaliza todo internamente.

Endpoints auxiliares

Además de los tres protocolos de chat, la pasarela también redirige estos endpoints compatibles con OpenAI:

Parámetro	Tipo	Descripción
`POST /v1/embeddings`	`embedding`	Generar embeddings vectoriales para texto.
`POST /v1/images/generations`	`image`	Generar imágenes a partir de un prompt de texto.
`POST /v1/audio/transcriptions`	`audio`	Transcribir audio a texto (multipart/form-data).
`POST /v1/audio/speech`	`audio`	Convertir texto en audio de voz.
`POST /v1/rerank`	`rerank`	Reordenar documentos según una consulta.

Streaming

Recibe los tokens de respuesta a medida que se generan mediante Server-Sent Events (SSE).

Activar streaming

Establece "stream": true en el cuerpo de tu solicitud. La respuesta será un flujo de eventos data: .

curl https://synthorai.io/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "stream": true,
    "messages": [{"role": "user", "content": "Count to 5"}]
  }'

Formato de respuesta SSE

data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"1"},"index":0}]}
data: {"id":"chatcmpl-...","choices":[{"delta":{"content":","}}]}
data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"2"}}]}
data: [DONE]

ℹ

El flujo termina con un evento data: [DONE] Analiza cada línea que comience con data: y extrae el campo choices[0].delta.content .

Todos estos modelos — y sus precios por token — figuran en la página model price comparison.