プロトコル
Synthorai は同一の base URL 上で 3 つの入力プロトコルを公開します。お使いの 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.
ℹ
3 つのプロトコルはすべて同じ API key、レート制限、課金、クォータを共有します。唯一の違いはリクエスト/レスポンスの形状であり、ゲートウェイが内部ですべてを正規化します。
補助エンドポイント
3 つのチャットプロトコルに加えて、ゲートウェイは次の 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 フィールド。
これらのモデルとそのトークン単価はすべて model price comparison ページに掲載されています。