Synthorai
🎁 Novo Cadastre-se grátis, 10 chamadas por nossa conta. Até US$ 1, sem cartão.

Protocolos

A Synthorai expõe três protocolos de entrada na mesma URL base. Escolha o que corresponde ao seu SDK; o gateway cuida da tradução de protocolo para o provedor upstream de forma transparente.

Matriz de protocolos

EndpointSDKIdeal para
POST /v1/chat/completions OpenAI SDK Universal — funciona para todos os provedores.
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 ferramentas, raciocínio, saída estruturada.
e.g. gpt-5.4, gpt-5.4-mini, gpt-5.3-codex
POST /v1/messages Anthropic SDK Fluxos nativos do Claude via canais Anthropic ou Bedrock.
e.g. claude-sonnet-4-6, claude-opus-4-1

Qual devo usar?

  • Já usa o SDK da OpenAI? Continue usando. /v1/chat/completions é o caminho universal e encaminha para qualquer provedor configurado.
  • Já usa o SDK da Anthropic? Aponte seu baseURL para o gateway e chame /v1/messages. Encaminha para canais Anthropic ou Bedrock-Anthropic.
  • Precisa de tool use, raciocínio ou saída estruturada em modelos OpenAI? Use /v1/responses.
ℹ

Os três protocolos compartilham a mesma chave API, limites de taxa, faturamento e cota. A única diferença é o formato de requisição/resposta — o gateway normaliza tudo internamente.

Endpoints auxiliares

Além dos três protocolos de chat, o gateway também encaminha estes endpoints compatíveis com OpenAI:

ParâmetroTipoDescrição
POST /v1/embeddingsembeddingGerar embeddings vetoriais para texto.
POST /v1/images/generationsimageGerar imagens a partir de um prompt de texto.
POST /v1/audio/transcriptionsaudioTranscrever áudio em texto (multipart/form-data).
POST /v1/audio/speechaudioConverter texto em áudio de fala.
POST /v1/rerankrerankReordenar documentos em relação a uma consulta.

Streaming

Receba os tokens da resposta conforme são gerados usando Server-Sent Events (SSE).

Ativar streaming

Defina "stream": true no corpo da sua requisição. A resposta será um fluxo 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 resposta 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]
ℹ

O fluxo termina com um evento data: [DONE] Analise cada linha que começa com data: e extraia o campo choices[0].delta.content .

Todos esses modelos — e seus preços por token — estão listados na página model price comparison.