API リファレンス

Synthorai は HTTPS 上でマルチプロトコルの REST API を提供します。同一の base URL、キー、課金で 3 つのリクエスト形式 —— OpenAI Chat Completions、OpenAI Responses、Anthropic Messages —— に対応し、さらに埋め込み、画像、音声、再ランク付け用の補助エンドポイントも備えています。

Base URL:  https://synthorai.io/v1

All endpoints require:
  Content-Type:  application/json
  Authorization: Bearer <your-api-key>
  (or x-api-key: <your-api-key> for /v1/messages)

エンドポイント

エンドポイント	型	説明
`POST /v1/chat/completions`	`chat`	OpenAI Chat Completions —— 汎用エントリポイント。任意のプロバイダーへルーティングします。
`POST /v1/responses`	`chat`	OpenAI Responses —— ツール使用、推論、構造化出力。
`POST /v1/messages`	`chat`	Anthropic Messages —— Claude / Bedrock-Anthropic ネイティブ。
`POST /v1/embeddings`	`embedding`	ベクトル埋め込みを生成します。
`POST /v1/images/generations`	`image`	テキストプロンプトから画像を生成します。
`POST /v1/videos`	`video`	非同期の動画生成ジョブを作成・ポーリングします。
`POST /v1/audio/transcriptions`	`audio`	音声をテキストに文字起こしします。
`POST /v1/audio/speech`	`audio`	テキストを音声に変換します。
`GET /v1/models`	`read`	認証済みキーで利用可能なすべてのモデルを一覧表示します。
`/api/v1/keys`	`keys`	自分のコードから推論キーを作成、一覧取得、変更、ローテーション、削除を行います（keys.read または keys.write を持つ管理キーが必要です）。
`GET /api/v1/requests`	`logs`	ワークスペースのリクエストを一覧・取得します。モデル、キー、トークン、コスト、所要時間、ラベルを返し、プロンプトや回答は返しません（logs.read を持つ管理キーが必要です）。
`/api/v1/prompts`	`prompts`	プロンプトライブラリを自分のコードから読み書きします。プロンプト、バージョン、ラベル、段階的リリースに加え、テストセットと評価実行も扱えます（prompts.read または prompts.write を持つ管理キーが必要です。テストには evals.read または evals.write が必要です）。
`GET /api/v1/audit-logs`	`workspace`	ワークスペースの設定と変更履歴を読み取ります。監査ログ、メンバーと招待、BYOK 設定、エクスポート先があり、それぞれに専用の読み取りスコープがあります。認証情報は一切返しません。
`GET /api/v1/billing/*`	`billing`	自分のワークスペース向けの読み取り専用の使用量・コスト・データ鮮度情報（通常の API キーではなく請求キーが必要です）。
`POST /v1/mcp`	`mcp`	MCP サーバー：すべてのモデル、API キー管理、課金データを AI エージェント（Claude Code、Cursor、Codex など）向けのツールとして、API キーひとつで提供します。

すべてのエンドポイントは同一のトークン単価カタログで課金されます。ルーティング可能な各モデルの費用は model price comparison をご覧ください。