GetRouterドキュメント
  • 日本語

    • Base URL とエンドポイント

    OpenAI 互換の SDK やツールでは、次の Base URL を使用します。

    https://getrouter.ai/v1

    HTTP リクエストを直接送信する場合は、以下のエンドポイントパスを追加します。

    主なエンドポイント

    機能メソッドエンドポイント URL 全体
    OpenAI 形式のモデル一覧GEThttps://getrouter.ai/v1/models
    Chat CompletionsPOSThttps://getrouter.ai/v1/chat/completions
    ResponsesPOSThttps://getrouter.ai/v1/responses
    Responses コンテキストの圧縮POSThttps://getrouter.ai/v1/responses/compact
    EmbeddingsPOSThttps://getrouter.ai/v1/embeddings
    画像生成POSThttps://getrouter.ai/v1/images/generations
    画像編集POSThttps://getrouter.ai/v1/images/edits
    音声の文字起こしPOSThttps://getrouter.ai/v1/audio/transcriptions
    音声翻訳POSThttps://getrouter.ai/v1/audio/translations
    テキスト読み上げPOSThttps://getrouter.ai/v1/audio/speech
    動画タスクの作成POSThttps://getrouter.ai/v1/videos
    動画タスクのステータスGEThttps://getrouter.ai/v1/videos/{task_id}
    RerankPOSThttps://getrouter.ai/v1/rerank
    Claude MessagesPOSThttps://getrouter.ai/v1/messages
    Gemini 形式のモデル一覧GEThttps://getrouter.ai/v1beta/models
    Gemini generateContentPOSThttps://getrouter.ai/v1beta/models/{model}:generateContent

    Base URL とエンドポイント URL 全体の違い

    通常、SDK には Base URL を指定し、操作ごとのパスは SDK が自動的に追加します。

    OpenAI SDK に入力する Base URL：
https://getrouter.ai/v1

SDK がリクエストを送信する URL：
https://getrouter.ai/v1/chat/completions

    ツールによっては、エンドポイント URL 全体を求められる場合があります。/chat/completions、/responses、/messages を手動で追加する前に、入力欄のラベルと連携ガイドを確認してください。

    パスの重複を避ける

    パスの重複は、404 Not Found エラーのよくある原因です。

    正しい OpenAI Base URL：
https://getrouter.ai/v1

ツールがすでに /v1 を追加する場合の誤った例：
https://getrouter.ai/v1/v1

ツールがすでに /chat/completions を追加する場合の誤った例：
https://getrouter.ai/v1/chat/completions/chat/completions
    Tip

    ツールに API Host、API Version、Endpoint の入力欄が個別にある場合は、追加されるパスを推測せず、そのツール専用の連携ガイドに従ってください。

    認証

    連携ガイドに別の指定がない限り、次のヘッダーを送信します。

    Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

    音声の文字起こしや動画作成などのマルチパートエンドポイントでは、curl -F または SDK を使用すると、それぞれの Content-Type boundary が自動的に設定されます。

    次のステップ