ドキュメント
Unify API は OpenAI API と互換性があります。すでに OpenAI を呼び出しているコードなら、ベース URL とキーを変えるだけで、それ以外はそのまま使えます。
クイックスタート
アカウントを作成してキーを取得し、クライアントの接続先を https://api.unifyapi.ai/v1 に設定します。
curl https://api.unifyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $UNIFYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5",
"messages": [{"role": "user", "content": "Hello"}]
}'既存の SDK を使う
OpenAI 互換のクライアントならどれでも動作します。ベース URL と Unify API のキーを設定してください。
from openai import OpenAI
client = OpenAI(
api_key=os.environ["UNIFYAPI_KEY"],
base_url="https://api.unifyapi.ai/v1",
)
response = client.chat.completions.create(
model="gpt-5",
messages=[{"role": "user", "content": "Hello"}],
)Anthropic 形式のクライアントでは、同じキーで /v1/messages を使用できます。
認証
すべてのリクエストで、キーを bearer トークンとして渡します。キーの作成と無効化はコンソールで行い、キーごとに利用できるモデルを限定したり、個別の支出上限を設定したりできます。
Authorization: Bearer sk-...エンドポイント
| POST /v1/chat/completions | OpenAI 互換のチャット |
| POST /v1/messages | Anthropic 互換のメッセージ |
| POST /v1/responses | OpenAI Responses API |
| POST /v1/embeddings | テキスト埋め込み |
| POST /v1/images/generations | 画像生成 |
| GET /v1/models | キーで利用可能なモデルの一覧 |
GET /v1/models を呼び出すと、キーで利用できるモデルを正確に確認できます。この一覧がお客様のアカウントにおける正式な情報です。
モデルの選び方
model フィールドに、キーでアクセスできる任意のモデルを指定します。Unify API はリクエストをそのモデルを提供するプロバイダーにルーティングし、そのプロバイダーの品質が低下した場合は自動でフェイルオーバーします。そのため、上流で障害が起きても同じモデル名のまま動作し続けます。
エラー
エラーは OpenAI と同じ形式なので、既存のエラー処理がそのまま使えます。401 はキーが指定されていないか無効化されていることを、429 はレート上限または支出上限に達したことを示します。どちらもコンソールで確認できます。