Seedance 2.5 视频生成 API

更新日期：2026-10-27。两款均通过知梦视频异步 API 调用，支持文生视频、图生视频与多参考生成。4–30 秒、固定 720p，按条收费；同一模型不因选择更长秒数加价，参考素材包含在售价内。

官链满参考在线调试 → · 官转火山词元在线调试 →

双模型能力与价格

项目	Seedance 2.5 · 官链满参考	Seedance 2.5 · 官转火山词元
精确模型 ID	sd2.5-官链-满参考-受排队影响	sd2.5-官转-30图10音频-火山词元
每条售价（人民币 CNY）	¥15/条	¥10/条
时长 / 画质	4–30 秒整数 / 720p	4–30 秒整数 / 720p
参考图片	0–30 张	0–30 张
参考视频	0–10 段	不支持，不要传入
参考音频	0–10 段	0–10 段
参考素材费用	包含在每条售价内	包含在每条售价内
特点	官方链路，生成速度受排队影响	图片、音频多参考，按条固定价格

以上为工作台展示售价；API 令牌若有分组折扣，实际账单以令牌所在分组及最终消费记录为准。两款均支持 16:9、9:16、1:1、4:3、3:4、21:9。无参考素材时为文生视频，添加图片为图生视频；需要参考视频请选择官链满参考。

模型 ID 必须完整匹配中文字符串，使用 UTF-8 原样发送。不要使用展示名替代，也不要套用旧的 Special / Stablize ID。Seedance 2.0 C4 / C5 是另一组模型，协议和价格不同。

地址、鉴权与调用流程

Base URL：https://movie.zmoapi.cn
创建：POST /v1/videos
查询：GET /v1/videos/{task_id}

Authorization: Bearer <VIDEO_API_TOKEN>
Content-Type: application/json

Base URL 不含 /v1。使用知梦视频账户的 API 令牌，通过异步任务调用：准备 H3 素材链接（文生视频可略）→ 创建 → 保存任务 ID → 查询至完成 → 下载保存。创建请求返回任务 ID，不会在该请求中同步等待几分钟再返回视频。

视频 API 令牌与 H3 素材站点密钥是两把不同的密钥。前者用于任务提交、查询和必要的受保护成片下载；后者仅用于自己服务器上传 H3。生产项目请在服务端保存密钥，勿写入公开页面源码、公开仓库或分享链接。文档调试台只填写视频 API 令牌，不填写 H3 站点密钥。

素材限制与上传

素材	数量	格式	单文件限制
图片	两款最多 30 张	JPG、PNG、WebP	≤20 MB
视频	仅官链最多 10 段	MP4、MOV	2–15 秒，≤50 MB
音频	两款最多 10 段	MP3、WAV、M4A、AAC、OGG、FLAC	≤15 秒，≤30 MB

一条任务的全部参考图片、视频、音频合计 ≤100 MB。本页视频和音频时长限制按单段计算，不要套用其他模型的合计 15 秒规则。上传成功不代表模型一定接受，生成服务仍会校验实际文件大小、格式、时长和可读性。

参考数组只接受有效的 H3 public_url，形如 https://h3.juheai.club/m/<对象ID>。不能直接提交本地路径、Base64、第三方图床链接、管理员下载地址或过期链接。排队、生成和转存完成前须保持素材可读。

方式一：视频工作台上传

打开知梦视频工作台，上传后复制 H3 素材链接，再粘贴到调试台或 API 请求的对应数组。工作台已代办上传，无需手动填写 H3 密钥。

方式二：自己的服务器上传 H3

小文件每次上传一个，使用 multipart/form-data：

素材用途	category	生成请求字段
参考图片	reference	reference_images
参考视频	reference_video	reference_videos，仅官链
参考音频	reference_audio	reference_audios
成片转存	output	将返回的 public_url 保存为公开成片链接

# H3_SITE_KEY 由自己的服务器安全配置提供；不是视频 API 令牌。
curl --fail-with-body -X POST 'https://h3.juheai.club/api/v1/media' \
  -H "Authorization: Bearer ${H3_SITE_KEY}" \
  -F 'category=reference' \
  -F 'model=sd2.5-官转-30图10音频-火山词元' \
  -F 'file=@./reference.png'

上传成功为 HTTP 201，取响应 public_url，不要取管理员下载地址 url。参考视频或音频按上表更换 category，model 对应本次生成模型。提交任务前确认素材 public_url 的 HEAD 返回 200。

大文件或遇到上传请求体限制时，H3 提供 8 MiB 分片上传：POST /api/v1/uploads/create → PUT /api/v1/uploads/{upload_id}/chunk/{index} → POST /api/v1/uploads/{upload_id}/complete，完成后仍取 public_url。分片请求完整字段请按 H3 站点接入文档 实现。H3 自身允许的文件大小不代替本页模型的单文件与总量限制。

全部生成参数

请求体为 JSON，以下字段均在顶层：

参数	类型	必填	说明
model	string	是	上表精确中文模型 ID，不能使用展示名。
prompt	string	是	非空提示词；工作台表单限制 7000 字符，调试台采用相同限制。
duration	integer	建议显式传	4–30 秒整数，以整数传入；按条计价，不随范围内秒数变化。资料未给出 API 省略值，请显式填写。
seconds	integer	否	兼容的时长别名；建议仅用 duration，同时传入不得不一致。
ratio	string	建议显式传	六种画幅之一，见下表。
aspect_ratio	string	否	ratio 的兼容写法；两者不得冲突，示例只传 ratio。
resolution	string	建议显式传	固定 720p，区分写法，不支持 1080p / 2K 等。
reference_images	string[]	否	0–30 个 H3 图片 public_url。
reference_videos	string[]	否	仅官链满参考允许，0–10 个 H3 视频 public_url；官转款不要发送此字段。
reference_audios	string[]	否	0–10 个 H3 音频 public_url。

仅发送上述公开字段。不使用 Seedance 2.0 的 input.media / parameters，也不发送 size、media、extra_images、audio 等其他接口字段。调试台使用 duration、ratio，无素材时省略三个参考数组；不发送 n、stream、fast_mode 或 generation_mode。

画幅与输出尺寸

ratio / aspect_ratio	720p 对应尺寸
16:9	1280×720
9:16	720×1280
1:1	960×960
4:3	1112×834
3:4	834×1112
21:9	1470×630

请求示例

纯文生视频：官转火山词元

VIDEO_BASE_URL='https://movie.zmoapi.cn'
# VIDEO_API_TOKEN 由安全配置提供。
curl --fail-with-body -X POST "${VIDEO_BASE_URL}/v1/videos" \
  -H "Authorization: Bearer ${VIDEO_API_TOKEN}" \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "model": "sd2.5-官转-30图10音频-火山词元",
    "prompt": "山间湖泊晨雾缓缓散开，镜头平稳推进，电影感光影",
    "duration": 30,
    "ratio": "16:9",
    "resolution": "720p"
  }'

此例基础价为 ¥10/条；改为 4–29 秒内任意整数秒也不改变同模型每条价格。下列 JSON 均提交到同一 POST /v1/videos，使用相同鉴权。

图片与音频参考：官转火山词元

{
  "model": "sd2.5-官转-30图10音频-火山词元",
  "prompt": "参考@1山间湖泊，镜头缓慢推进；@2作为自然环境声。",
  "duration": 30,
  "ratio": "16:9",
  "resolution": "720p",
  "reference_images": ["https://h3.juheai.club/m/REPLACE_WITH_IMAGE_OBJECT_ID"],
  "reference_audios": ["https://h3.juheai.club/m/REPLACE_WITH_AUDIO_OBJECT_ID"]
}

替换为自己上传后有效的 H3 public_url；此例图片和音频包含在 ¥10/条 内。不要添加 reference_videos。提示词中的素材引用写法可参考此例；复杂场景请明确描述各素材用途。

图片、视频与音频参考：官链满参考

{
  "model": "sd2.5-官链-满参考-受排队影响",
  "prompt": "结合参考角色、镜头运动和环境声，生成连贯的电影片段",
  "duration": 20,
  "ratio": "21:9",
  "resolution": "720p",
  "reference_images": ["https://h3.juheai.club/m/REPLACE_WITH_IMAGE_OBJECT_ID"],
  "reference_videos": ["https://h3.juheai.club/m/REPLACE_WITH_VIDEO_OBJECT_ID"],
  "reference_audios": ["https://h3.juheai.club/m/REPLACE_WITH_AUDIO_OBJECT_ID"]
}

此例基础价为 ¥15/条，素材不另收费。所有示例对象 ID 均为占位符；输入文件须符合单段时长、大小及总计 100 MB 限制。官链生成受排队影响，等待时保留原任务 ID，不要重复提交。

查询任务与下载

创建成功后保存响应中的 id 或 task_id，使用创建时同一 API 令牌查询：

TASK_ID='<创建时返回的真实任务ID>'
curl --fail-with-body "${VIDEO_BASE_URL}/v1/videos/${TASK_ID}" \
  -H "Authorization: Bearer ${VIDEO_API_TOKEN}"

status	含义	处理
queued	排队中	继续查询，不重复创建。
in_progress	生成中	展示进度并继续查询。
completed	完成	读取有效成片 URL，再下载保存。
failed	失败	停止查询，保留任务 ID 排查。

建议每 5–10 秒查询一次，调试台采用 10 秒。必须检查 status，进度 100 不等于成功。完成时优先读取 content.url，再兼容 result_url、video_url 或 url。无有效 URL 时查看完整响应，不当作已取得可播放成片。提交响应慢时不要盲目再次提交，以免生成两条并重复扣费。

公共直链与受保护下载地址

• H3 public_url：无需视频 API 令牌，可直接下载或作为播放器地址。
• 知梦视频 /v1/videos/{task_id}/content：下载需要创建任务时同一令牌的 Bearer 认证，不能直接当作公开网页 <video> 的播放源。
• 直接 API 调用的最终 URL 形式以实际响应为准。视频工作台会自动转存 H3；这不代表所有 /v1/videos 直接调用都会返回 H3 公共链接。

# 仅下载知梦视频 API 域名上的受保护 content 地址；不要加 -L 转发令牌。
curl --fail-with-body "${VIDEO_BASE_URL}/v1/videos/${TASK_ID}/content" \
  -H "Authorization: Bearer ${VIDEO_API_TOKEN}" \
  -o seedance-2.5.mp4

# 若响应已经是 H3 public_url，使用无认证下载，不发送视频 API 令牌。
curl --fail-with-body 'https://h3.juheai.club/m/REPLACE_WITH_OUTPUT_OBJECT_ID' \
  -o seedance-2.5.mp4

视频 API 令牌只发往知梦视频 API 域名，不能发送到 H3 或其他主机，也不要放进 URL 参数。若服务需要公共 H3 成片链接，可在自己的服务器下载后，按前述 H3 上传方式使用 category=output 转存，再保存返回的 public_url。工作台已内置这一步。

工作台成片当前保留 24 小时，请完成后及时下载。API 结果的有效期、存储位置以实际响应及平台提示为准，不保证所有第三方调用的链接都有同样保留期。

调试与常见问题

官链满参考调试台 → · 官转火山词元调试台 →

调试台支持两个精确模型 ID、4–30 秒、固定 720p、六种画幅和对应 H3 素材数组；官转款隐藏视频输入，提交时也校验禁用视频。不会要求 H3 站点密钥或代传本地素材，URL 格式与数量预检不代替服务端读取文件后的校验。返回受保护 /content 地址时提供原令牌下载按钮；浏览器跨域限制或下载重定向导致失败时，请改用服务端下载或视频工作台。

现象	检查与处理
模型不可用 / 无权限	精确模型 ID、账号余额、令牌分组是否支持。
参数错误	duration 是否为 4–30 整数，resolution 是否为 720p，比例是否在六项之内。
官转款拒绝视频	删除 reference_videos，或改用官链满参考。
素材过期 / 大小不可验证	是否使用 H3 /m/ 的 public_url；HEAD / Range 可读，未过期。
参考媒体被拒	文件格式、单段时长、单文件大小及全部素材合计 ≤100 MB；上传成功不等于符合模型限制。
官链排队较久	按原任务 ID 继续查询，避免重复提交。
完成后无法裸链播放	是否为需要原令牌的 /content 地址；请鉴权下载或转存 H3。
H3 成片不可读	检查是否过期、HEAD 是否为 200，视频类型是否正确。

视频 API 概览 · 视频计费说明 · Seedance 2.0