Seedream MCP

創作模型，一次接入。

連線 AI 助手，選好模型，用現有積分開始下一張圖片或影片。

建立 API 金鑰

選擇創作起點

圖片模型…

影片模型…

連接 AI 助手

MCP 服務網址

https://seedream-5.io/api/mcp

在啟動 AI 工具的環境設定 SEEDREAM_API_KEY，再複製下方設定。本機測試時請替換服務網址。

~/.codex/config.toml

[mcp_servers.seedream]
url = "https://seedream-5.io/api/mcp"
bearer_token_env_var = "SEEDREAM_API_KEY"

Streamable HTTP · Bearer

驗證範圍與用戶端文件

Codex 已驗證文生圖、URL 編輯與結果讀取；Cursor、Grok Build 已驗證連線及工具探索，Claude Code 已驗證連線。後三者完整流程仍待驗證。

新增模型已通過正式環境出圖、URL 編輯及 Codex 原生 MCP 工具呼叫驗證。各客戶端由 AI 驅動的完整流程仍待聯調。

Codex Cursor Claude Code Grok

圖片呼叫工作台

選擇模型與設定，再將下方參數複製給已連線的 AI 助手。用戶端連線設定不需更改。

範例模型成品比例解析度輸出格式

prompt必填

非空文字，最多 3000 字元。描述畫面或要修改的內容。

預估消費… 點數

支援的輸入參數

參數	必填 / 選填	類型、可選值與限制
`model`	選填	`string`seedream-5-pro 使用模型 ID，省略時使用 Seedream 5 Pro。預設：seedream-5-pro
`request_id`	必填	`string` 8–128 位英文字母、數字、底線或連字號。每張新圖使用新 ID；重試同一任務時保持不變。
`prompt`	必填	`string` 非空文字，最多 3000 字元。描述畫面或要修改的內容。
`aspect_ratio`	選填	`string`1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 9:16 · 16:9 · 21:9 決定成品圖片比例。要保留參考圖比例，請選擇相同比例；auto 僅 Nano Banana 2 支援。預設：1:1
`resolution`	選填	`string`1K · 2K 選擇解析度等級，實際像素寬高隨比例改變。預設：1K
`output_format`	選填	`string`jpeg · png 填寫小寫 jpeg 或 png。預設：jpeg
`image_urls`	僅圖生圖必填	`string[]` 1–10 個公開 HTTPS 網域圖片 URL 的陣列，每個 URL 最多 4096 字元，僅使用預設連接埠或 443。不支援 IP 位址、本機路徑、base64 或需登入的連結。文字生圖請省略。

僅支援列出的參數。無效參數會在提交及預占點數前回報錯誤；每次產生一張圖片。

查詢工具用法

seedream_get_model_info: model 選填；傳 {} 會回傳完整目錄及預設 Pro 選項。
seedream_get_balance: 無需參數，傳 {}，回傳帳戶點數與金鑰剩餘額度。
seedream_get_task: task_id 必填，填入建立任務時回傳的 UUID。

影片呼叫工作台

共用現有網址與金鑰。選擇標準版或 Pro，再選擇三種模式之一；複製參數給已連線的 AI 助手。此處僅建立範例，不會提交任務。

範例模型解析度成品比例時長（秒）

產生聲音種子（選填）

prompt必填

預估消費… 點數

可直接複製的參數

範例建構器 · 此處不消耗積分

時長（秒）: 2–30

seedream_generate_video

{
  "model": "wan-3.0-standard",
  "request_id": "generate_video_001",
  "mode": "text-to-video",
  "prompt": "木桌上的陶瓷茶壺，鏡頭在柔和晨光中緩慢推進。",
  "aspect_ratio": "adaptive",
  "resolution": "720P",
  "duration": 5,
  "audio": true
}

新影片使用新 request_id；重試須保持 ID 與參數不變，更改參數會衝突。

呼叫一次 seedream_generate_video，再以傳回的 task_id 每 5 秒查詢 seedream_get_task。完成後傳回可播放影片連結與 resource_link。用戶端斷線後仍會繼續；SUBMISSION_UNCERTAIN 請聯絡支援，勿重複提交。

參考素材與限制

文字模式須填 prompt；首尾幀模式至少填 first_frame_url 或 last_frame_url；參考模式至少填一組參考 URL。首尾幀與參考陣列不可混用。後兩種模式的 prompt 可選。

僅限公開 HTTPS URL，無本機檔案、base64 或登入連結。圖片最多 10 張，JPEG/PNG/BMP/WebP，每張 ≤20 MiB，邊長 240–8000 px，長寬比 ≤8。影片最多 5 個 MP4/MOV，每個 ≤100 MiB，邊長 240–4096 px，長寬比 ≤8。音訊最多 5 個 WAV/MP3，每個 ≤15 MiB。影片／音訊各檔 1–15 秒，各類總長 ≤15 秒；參考影片＋輸出 ≤30 秒。連結須持續可用，實際素材由生成服務驗證。

預設：標準版、文字模式、720P（Pro：1080P）、adaptive、5 秒、聲音開啟。固定 MP4，像素隨比例變化。

支援的輸入參數

參數	必填 / 選填	類型、可選值與限制
`request_id`	必填	`string · 8–128 · A–Z a–z 0–9 _ -`
`model`	選填	`wan-3.0-standard \| wan-3.0-prime \| wan-3.0-pro \| wan-3.0-prime-pro` 預設：wan-3.0-standard
`mode`	選填	`text-to-video \| keyframe-to-video \| reference-to-video` 預設：text-to-video
`prompt`	必填	`string · 1–20000`
`aspect_ratio`	選填	`16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| adaptive` 預設：adaptive
`resolution`	選填	預設：…
`duration`	選填	`integer · 2–30 s` 預設：5
`audio`	選填	`boolean · true \| false` 預設：true
`seed`	選填	`integer · 0–2147483647`
`first_frame_url / last_frame_url`	必填 · 首幀／尾幀生影片	`string · HTTPS · ≤4096`
`reference_image_urls`	選填 · 參考素材生影片	`string[] · 1–10 · HTTPS · ≤4096 / URL`
`reference_video_urls`	參考素材生影片	`string[] · 1–5 · HTTPS · ≤4096 / URL`
`reference_audio_urls`	參考素材生影片	`string[] · 1–5 · HTTPS · ≤4096 / URL`
`reference_video_durations / reference_audio_durations`	選填	`number[] · 1–15 s / item · total ≤15 s`

每次一個 MP4。不接受 output_format、供應商或安全開關。無效工具參數不預占積分；無法存取或超限素材會導致任務失敗。參考時長陣列可選，須與 URL 數量及順序一致，不能繞過實際驗證。

我的 API 金鑰

為每個 AI 工具分別設定金鑰與消費上限。呼叫範例與參數

載入中…