協定

Synthorai 在同一個 base URL 上提供三種輸入協定。選擇與你的 SDK 相符的那一種；閘道會透明地處理到上游供應商的協定轉換。

協定對照表

端點	SDK	適用情境
`POST /v1/chat/completions`	OpenAI SDK	通用——適用於所有供應商。 e.g. `gpt-5.4-mini, qwen3.5-flash, gemini-2.5-flash, claude-sonnet-4-6`
`POST /v1/responses`	OpenAI SDK (Responses)	工具呼叫、推理、結構化輸出。 e.g. `gpt-5.4, gpt-5.4-mini, gpt-5.3-codex`
`POST /v1/messages`	Anthropic SDK	透過 Anthropic 或 Bedrock 通道實現 Claude 原生工作流。 e.g. `claude-sonnet-4-6, claude-opus-4-1`

我該使用哪一種？

已經在使用 OpenAI SDK？ 繼續使用即可。 /v1/chat/completions 是通用路徑，可路由到任何已設定的供應商。
已經在使用 Anthropic SDK？ 將其 baseURL 指向閘道並呼叫 /v1/messages. 路由到 Anthropic 或 Bedrock-Anthropic 通道。
需要在 OpenAI 模型上進行工具呼叫、推理或結構化輸出？ 使用 /v1/responses.

ℹ

這三種協定共享同一個 API key、限流、計費和配額。唯一的區別在於請求/回應的結構形態——閘道會在內部統一正規化處理。

輔助端點

除三種聊天協定外，閘道還代理以下 OpenAI 相容端點：

參數	類型	說明
`POST /v1/embeddings`	`embedding`	為文字產生向量嵌入（embeddings）。
`POST /v1/images/generations`	`image`	根據文字提示詞產生圖像。
`POST /v1/audio/transcriptions`	`audio`	將音訊轉寫為文字（multipart/form-data）。
`POST /v1/audio/speech`	`audio`	將文字轉換為語音音訊。
`POST /v1/rerank`	`rerank`	根據查詢對文件進行重新排序。

串流

使用 Server-Sent Events (SSE) 在回應 token 生成時即時接收它們。

啟用串流

設定 "stream": true 在你的請求主體中。回應將是一個串流，由以下事件組成： 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"}]
  }'

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]

ℹ

串流以下列內容結束： data: [DONE] 事件。解析每一行以下列內容開頭的行： data: 並提取 choices[0].delta.content 欄位。

所有這些模型——以及它們的按 token 價格——都列在 model price comparison 頁面上。