Protokolle

Synthorai stellt drei Eingabeprotokolle auf derselben Basis-URL bereit. Wählen Sie das zu Ihrem SDK passende; das Gateway übernimmt die Protokollübersetzung zum Upstream-Anbieter transparent.

Protokollmatrix

Endpunkt	SDK	Ideal für
`POST /v1/chat/completions`	OpenAI SDK	Universell — funktioniert für jeden Anbieter. e.g. `gpt-5.4-mini, qwen3.5-flash, gemini-2.5-flash, claude-sonnet-4-6`
`POST /v1/responses`	OpenAI SDK (Responses)	Tool-Nutzung, Reasoning, strukturierte Ausgabe. e.g. `gpt-5.4, gpt-5.4-mini, gpt-5.3-codex`
`POST /v1/messages`	Anthropic SDK	Claude-native Workflows über Anthropic- oder Bedrock-Kanäle. e.g. `claude-sonnet-4-6, claude-opus-4-1`

Welches sollte ich verwenden?

Sie verwenden bereits das OpenAI-SDK? Verwenden Sie es weiterhin. /v1/chat/completions ist der universelle Pfad und leitet an jeden konfigurierten Anbieter weiter.
Sie verwenden bereits das Anthropic-SDK? Richten Sie dessen baseURL an das Gateway und rufen Sie /v1/messages. Leitet an Anthropic- oder Bedrock-Anthropic-Kanäle weiter.
Benötigen Sie Tool Use, Reasoning oder strukturierte Ausgabe bei OpenAI-Modellen? Verwenden Sie /v1/responses.

ℹ

Alle drei Protokolle teilen sich denselben API-Schlüssel, dieselben Ratenlimits, Abrechnung und Kontingent. Der einzige Unterschied ist die Anfrage-/Antwort-Form — das Gateway normalisiert alles intern.

Zusätzliche Endpunkte

Über die drei Chat-Protokolle hinaus leitet das Gateway auch diese OpenAI-kompatiblen Endpunkte weiter:

Parameter	Typ	Beschreibung
`POST /v1/embeddings`	`embedding`	Vektor-Embeddings für Text generieren.
`POST /v1/images/generations`	`image`	Bilder aus einem Text-Prompt generieren.
`POST /v1/audio/transcriptions`	`audio`	Audio in Text transkribieren (multipart/form-data).
`POST /v1/audio/speech`	`audio`	Text in Sprachaudio umwandeln.
`POST /v1/rerank`	`rerank`	Dokumente anhand einer Abfrage neu sortieren.

Streaming

Empfangen Sie Antwort-Token, während sie generiert werden, über Server-Sent Events (SSE).

Streaming aktivieren

Setzen Sie "stream": true im Body Ihrer Anfrage. Die Antwort ist ein Stream von data: -Events.

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"}]
  }'

SSE-Antwortformat

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

ℹ

Der Stream endet mit einem data: [DONE] Verarbeiten Sie jede Zeile, die mit data: und extrahieren Sie das choices[0].delta.content beginnt.

Alle diese Modelle – und ihre Token-Preise – sind auf der Seite model price comparison aufgeführt.