メインコンテンツへスキップ
YouRouter は単一ゲートウェイでモデル API を提供します。多くの統合は OpenAI 互換の Chat Completions から始めるのが最短です。

​
Base URL

https://api.yourouter.ai/v1
OpenAI 互換 API とプロバイダー固有のモデル API はこの Base URL を使用します。動画タスクと Custom Search は個別の Base path を使います。

​
エンドポイントファミリー

ファミリーBase path用途
モデル APIhttps://api.yourouter.ai/v1Chat Completions、Embeddings、Anthropic Messages、Google generateContent パス。
動画タスクhttps://api.yourouter.ai/api/v3Ark のテキストから動画生成、画像から動画生成タスクの作成とポーリング。
Custom Searchhttps://api.yourouter.ai/customsearch/v1Google Programmable Search 互換のウェブ検索。

​
認証

YouRouter API キーを Bearer トークンとして送ります。 
Authorization: Bearer <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 にテキストと画像の content block を送るか、プロバイダー固有のマルチモーダルエンドポイントを使用します。
自動ルーティングvendor ヘッダーを省略するか、vendor: auto を送ります。
固定ルーティングvendor: openai、vendor: anthropic、vendor: google、またはその他の対応プロバイダーを送ります。
ストリーミングstream: true を設定し、Server-Sent Events の増分 chunk として受信します。
ネイティブ APIAnthropic 互換の呼び出しには /messages、Gemini 互換の呼び出しには Google generateContent パスを使用します。

​
主なエンドポイント

エンドポイント目的
POST /chat/completionsOpenAI 互換のテキストおよび画像入力モデル呼び出し。多くの統合で推奨されます。
POST /embeddings対応する embedding モデルでテキスト埋め込みを生成します。
POST /messagesAnthropic Messages 互換のモデル呼び出し。
POST /projects/.../models/{model}:generateContentGoogle Gemini generateContent 互換のモデル呼び出し。
POST /api/v3/contents/generations/tasksタスク型の動画生成呼び出し。

​
ステータスコード

ステータス意味
200リクエストが成功しました。
400リクエストボディ、モデル、またはパラメータ形式が不正です。
401API キーが未指定、または無効です。
429プロバイダーのレート制限、または同時実行制限に達しました。
500ゲートウェイまたは上流プロバイダーが内部エラーを返しました。
基本形は Create Chat Completion。画像と動画は マルチモーダル を参照してください。