Synthorai
🎁 Nouveau Inscription gratuite, 10 appels offerts. Jusqu'à 1 $, sans carte.

Protocoles

Synthorai expose trois protocoles d'entrée sur la même URL de base. Choisissez celui qui correspond à votre SDK ; la passerelle gère la traduction de protocole vers le fournisseur en amont de manière transparente.

Matrice des protocoles

EndpointSDKIdéal pour
POST /v1/chat/completions OpenAI SDK Universel — fonctionne pour tous les fournisseurs.
e.g. gpt-5.4-mini, qwen3.5-flash, gemini-2.5-flash, claude-sonnet-4-6
POST /v1/responses OpenAI SDK (Responses) Utilisation d'outils, raisonnement, sortie structurée.
e.g. gpt-5.4, gpt-5.4-mini, gpt-5.3-codex
POST /v1/messages Anthropic SDK Workflows natifs Claude via les canaux Anthropic ou Bedrock.
e.g. claude-sonnet-4-6, claude-opus-4-1

Lequel utiliser ?

  • Vous utilisez déjà le SDK OpenAI ? Continuez à l'utiliser. /v1/chat/completions est le chemin universel et achemine vers n'importe quel fournisseur configuré.
  • Vous utilisez déjà le SDK Anthropic ? Pointez son baseURL vers la passerelle et appelez /v1/messages. Achemine vers les canaux Anthropic ou Bedrock-Anthropic.
  • Besoin de tool use, de raisonnement ou de sortie structurée sur les modèles OpenAI ? Utilisez /v1/responses.
ℹ

Les trois protocoles partagent la même clé API, les mêmes limites de débit, la même facturation et le même quota. La seule différence est la forme requête/réponse — la passerelle normalise tout en interne.

Endpoints auxiliaires

Au-delà des trois protocoles de chat, la passerelle relaie aussi ces endpoints compatibles OpenAI :

ParamètreTypeDescription
POST /v1/embeddingsembeddingGénérer des embeddings vectoriels pour du texte.
POST /v1/images/generationsimageGénérer des images à partir d'un prompt texte.
POST /v1/audio/transcriptionsaudioTranscrire de l'audio en texte (multipart/form-data).
POST /v1/audio/speechaudioConvertir du texte en audio vocal.
POST /v1/rerankrerankReclasser des documents par rapport à une requête.

Streaming

Recevez les tokens de réponse au fur et à mesure de leur génération via Server-Sent Events (SSE).

Activer le streaming

Définissez "stream": true dans le corps de votre requête. La réponse sera un flux d'événements 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"}]
  }'

Format de réponse 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]
ℹ

Le flux se termine par un événement data: [DONE] Analysez chaque ligne commençant par data: et extrayez le champ choices[0].delta.content .

Tous ces modèles — et leurs prix par token — sont listés sur la page model price comparison.