Skip to content

API 總覽

WRouter 相容多套業界主流的大模型介面協議,互相轉譯,任選其一即可。

Base URL

https://wrouter.ai

所有介面均通過 HTTPS 提供。請勿在生產環境使用任何代理域名。

協議相容

協議Base 路徑說明
OpenAI 風格/v1/*業界最通用的協議格式,官方及社群 SDK 即插即用
Anthropic 風格/v1/messagesMessages 協議格式,適配使用該協議的 SDK 與客戶端
Gemini 風格/v1beta/models/{model}:generateContentGenerative AI 協議格式

只需把 SDK 的 base_url 指向 WRouter,模型 ID 與請求體保持原樣,WRouter 會按協議路由到對應上游。

介面列表

對話

檢索

影像

音訊

  • Speech (TTS)POST /v1/audio/speech
  • Transcriptions (STT)POST /v1/audio/transcriptions
  • Translations — POST /v1/audio/translations(任意語言翻譯為英文)

影片

  • 影片生成 — POST /v1/videos、Kling / Pixverse / Seedance / Veo3 / Wanx / 即夢 等專用入口
  • 任務查詢 — GET /v1/videos/{task_id}GET /v1/videos/{task_id}/content

安全稽核

即時

  • Realtime — GET /v1/realtime(WebSocket 升級)

元資訊

  • ModelsGET /v1/modelsGET /v1beta/models

通用約定

  • 認證:所有請求需在 Header 中攜帶 Authorization: Bearer sk-...,見 認證
  • 內容型別:除檔案上傳外,請求體均為 application/json; charset=utf-8
  • 錯誤碼:統一 RESTful 風格,見 錯誤碼
  • 流式響應:所有對話介面支援 stream: true,返回 Server-Sent Events
  • 限流:預設按 Token 維度限流;可在控制台調整
  • 請求超時:建議客戶端超時設定 ≥ 600 秒,長生成任務可能超過 5 分鐘