API Reference
非同步影像 API 的端點與慣例。
SeedRouter 透過同一個 API、同一把 API 金鑰提供影像、影片、音訊與文字模型。影像、影片與音訊模型以非同步任務執行：提交請求後會取得任務 ID，再輪詢取得結果。文字模型直接回傳答案，請求格式與該模型廠商的官方格式一致。
基礎 URL
https://api.seedrouter.ai請使用 HTTPS，請求本文為 JSON。音訊端點則改用 multipart/form-data 上傳檔案。
認證
每個請求（包括任務查詢）都以 Bearer 權杖的形式傳送你的金鑰：
Authorization: Bearer YOUR_API_KEYAnthropic Messages 端點也接受放在 x-api-key 中的金鑰，並需同時帶上 anthropic-version 標頭。詳見認證。
媒體任務端點
| 方法 | 路徑 | 用途 |
|---|---|---|
| POST | /v1/images/generations | 提交影像生成或編輯任務：GPT Image、Nano Banana 與 Midjourney。 |
| POST | /v1/videos/generations | 提交影片任務：Seedance 2.5 與 2.0（ModelArk 請求主體）、Veo 3.1、Kling 3.0、MiniMax H3 與 SD Video。 |
| POST | /v1/audio/transcriptions | 提交音訊檔案，以 Whisper-1 轉寫。 |
| POST | /v1/audio/translations | 提交音訊檔案，以 Whisper-1 翻譯成英文。 |
| GET | /v1/tasks/{id} | 讀取影像、影片或音訊任務的狀態與結果。 |
參考圖片、影片與音訊以 URL 形式放在請求本文中。影像請求包含輸入圖片時即為編輯。各模型的參考文件列出其支援的參數。
文字端點
| 方法 | 路徑 | 請求格式 |
|---|---|---|
| POST | /v1/chat/completions | OpenAI Chat Completions |
| POST | /v1/responses | OpenAI Responses |
| POST | /v1/messages | Anthropic Messages |
| POST | /v1beta/models/{model}:generateContent | Google Gemini |
| POST | /v1beta/models/{model}:streamGenerateContent | Google Gemini（串流） |
| GET | /v1/models | 列出可用模型 |
並非每個文字模型都支援所有格式，模型的 API 參考會寫明它接受哪些格式。例如 Claude Opus 5.5 支援 Chat Completions、Responses 與 Messages，而 Gemini 文字模型使用 /v1beta 路徑。
請求生命週期
媒體任務
- 提交請求。回應是一個任務，而不是生成好的檔案：請儲存它的
id。 - 輪詢該任務，直到進入最終狀態。
/v1/tasks/{id}上的任務會先顯示processing，然後變為completed或failed。 - 讀取結果。影像位於
output.data[].url，影片位於output.video_url，Whisper 的輸出位於output.url。所有結果連結都指向 SeedRouter 的儲存空間。
任務失敗時，請檢查 error.code 與 error.message。失敗的任務不計費。目前沒有任務完成的 webhook，請依 Webhooks 中的說明輪詢任務。
文字請求
文字請求在同一個回應中傳回模型的回答，回應結構與廠商官方一致。將 stream 設為 true，或對 Gemini 使用 :streamGenerateContent，即可接收伺服器傳送事件（SSE）。文字模型按 token 計費。