YouRouter は単一ゲートウェイでモデル API を提供します。多くの統合は OpenAI 互換の Chat Completions から始めるのが最短です。
Base URL
https://api.yourouter.ai/v1
このリファレンス内のパスはすべてこの Base URL 相対です。
YouRouter API キーを Bearer トークンとして送ります。
Authorization: Bearer <YOUR_YOUROUTER_API_KEY>
JSON リクエストでは次も必要です。
Content-Type: application/json
API キーはサーバーサイド、バックエンド、CI、社内ツールなど信頼できる場所でのみ使用してください。ブラウザやモバイルに埋め込まないでください。
最初のリクエスト
curl https://api.yourouter.ai/v1/chat/completions \
-H "Authorization: Bearer $YOUROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [
{
"role": "user",
"content": "Reply with exactly: connected"
}
]
}'
生成テキストは通常ここです。
choices[0].message.content
主要概念
| 概念 | 使い方 |
|---|
| モデル選択 | リクエストボディの model |
| マルチモーダル | messages[].content にブロックを並べる、またはネイティブ多モーダルへ |
| 自動ルーティング | vendor 省略または vendor: auto |
| 固定ルーティング | vendor: openai など |
| ストリーミング | stream: true |
| ネイティブ API | /messages や generateContent パス |
主なエンドポイント
| エンドポイント | 目的 |
|---|
POST /chat/completions | 推奨。テキストと画像入力の標準呼び出し |
POST /embeddings | 埋め込み |
POST /messages | Anthropic Messages 互換 |
POST /projects/.../models/{model}:generateContent | Gemini generateContent 互換 |
POST /api/v3/contents/generations/tasks | 動画生成タスク |
ステータスコード
| ステータス | 意味 |
|---|
200 | 成功 |
400 | ボディ/モデル/パラメータ不正 |
401 | キー不正/未設定 |
429 | レート制限/同時実行 |
500 | ゲートウェイまたは上流エラー |
基本形は Create Chat Completion。画像と動画は マルチモーダル を参照してください。