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 和参数不变。同一 ID 更改参数会返回冲突。

调用一次 seedream_generate_video，再把返回的 task_id 传给 seedream_get_task，每 5 秒查询一次。完成后返回可播放视频链接及 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 像素，长宽比 ≤8。视频最多 5 个 MP4/MOV，单个 ≤100 MiB，边长 240–4096 像素，长宽比 ≤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 不可用或实际素材超限也会导致任务失败。选填的参考时长数组须与 URL 顺序和数量一致，不能绕过实际素材校验。

我的 API 密钥

为每个 AI 工具单独设置密钥和消费上限。调用示例与参数

加载中…