🎁 新規 無料登録、10回の呼び出しを進呈。最大 $1、カード不要。

プロトコル

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/embeddingsembeddingテキストのベクトル埋め込み(embeddings)を生成します。
POST /v1/images/generationsimageテキストプロンプトから画像を生成します。
POST /v1/audio/transcriptionsaudio音声をテキストに文字起こしします(multipart/form-data)。
POST /v1/audio/speechaudioテキストを音声オーディオに変換します。
POST /v1/rerankrerankクエリに対してドキュメントを再ランク付けします。

ストリーミング

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 ページに掲載されています。