Skip to main content
POST
POST https://code.heihuzi.ai/api/v3/contents/generations/tasks 创建一个 Seedance 视频生成任务,请求和响应的格式与火山方舟「创建视频生成任务」接口相同。任务异步执行:创建后返回 id,再用查询任务获取成片链接;已结束的任务可以删除。 请使用绑定「Seedance 视频」分组的 API Key。其他分组的 Key 调用会返回 403 PermissionDenied。
运行前设置环境变量 HEIHUZI_API_KEY。上面的示例用一张图作为视频的第一帧。

模型

四个模型都支持文生视频、首帧、首尾帧、参考图和参考视频。参考图可以填图片链接,也可以填自己创建的素材 ID。参考素材的数量上限:

请求参数

string
required
模型 ID,见上表。其他模型返回 404 model_not_found。
object[]
required
输入内容列表,不能为空。首帧、首尾帧、参考素材(参考图、参考视频)是三种互斥的用法,不能混用。
  • 文字:{"type": "text", "text": "画面与动作描述"}。
  • 首帧:{"type": "image_url", "image_url": {"url": "图片链接"}, "role": "first_frame"}。
  • 首尾帧:再加一张 "role": "last_frame" 的图片,视频从首帧过渡到尾帧。
  • 参考图:{"type": "image_url", "image_url": {"url": "图片链接"}, "role": "reference_image"},数量上限见上表。
  • 参考视频:{"type": "video_url", "video_url": {"url": "视频链接"}, "role": "reference_video"},数量和时长上限见上表,可以和参考图一起用。
string
清晰度:480p、720p、1080p、4k,各模型可选的清晰度见上表。选了模型不支持的清晰度返回 400 PricingNotConfigured。清晰度越高,用量越大。Seedance 2.5 的 1080p 和 Seedance 2.0 的 4k 成片是 10bit、H.265 编码,少数播放环境可能需要换播放器查看。
string
画面比例:16:9、4:3、1:1、3:4、9:16、21:9,或 adaptive(自动选择)。带首帧图或首尾帧时建议填 adaptive,由首帧图决定比例;Seedance 2.5 这时只能填 adaptive,填其他比例时任务创建后会失败,冻结的余额全额退回。
integer
时长(秒),整数。Seedance 2.0 系列为 4–15,Seedance 2.5 为 4–30。填 -1 时由模型在可选范围内自动决定时长,实际时长见查询任务返回的 duration,并按实际时长计费。

图片

填公网可访问的 https 图片链接,或图片的 Base64 编码(写法见下方「本机图片」)。
  • 含真人人脸的图片会被拒绝:返回 400 InputImageSensitiveContentDetected.PrivacyInformation,冻结的余额全额退回。
  • 参考图可以填自己的素材 ID:{"type": "image_url", "image_url": {"url": "asset://asset-xxx"}, "role": "reference_image"}。素材要先用素材管理接口创建,并等状态变成 Active,写法见下方「更多示例」。
  • 参考图数量超出上限时,任务创建后会失败,冻结的余额全额退回。

参考视频

填公网可访问的视频链接。不支持 Base64 编码(返回 400 InvalidParameter)。
  • 含真人人脸的视频会被拒绝。
  • 在提示词里说明参考视频怎么用,写法见下方「更多示例」。

本机图片

把本机图片转换为 Base64 字符串,写成 data:image/<图片格式>;base64,<Base64 编码> 填入 image_url.url,<图片格式> 用小写,如 data:image/png;base64,...。首帧、尾帧和参考图都可以这样传。不要填本机文件路径(如 /Users/...、file://...)。 首帧(命令行,把 first.png 换成你的图片):
参考图(Python,把 reference.jpg 换成你的图片):

响应

id 是任务号,用它查询和删除任务。

更多示例

文生视频(只传文字):
首尾帧:
参考视频:
参考图用素材 ID(两个素材出现在同一个视频里;素材创建方法见素材管理):
参考图加参考视频:

计费

  • 按任务完成后返回的实际用量(usage.completion_tokens)计费,不同模型、清晰度单价不同,价格以便利店当前分组配置和用量明细为准。
  • 提交时按本次请求可能产生的最大用量冻结余额,生成成功后按实际用量扣费,多冻结的部分退回。
  • 带参考视频时,参考视频的时长计入用量,并按含视频输入的单价计费。参考图不增加用量。
  • 生成失败、超时、被取消,或请求被拒绝(例如图片含真人),冻结的余额全额退回。

限制

  • 每个用户同时最多 5 个未完成的视频任务(排队中的也算,Seedance 和 MiniMax 的任务合计),超过返回 429 TooManyActiveTasks。
  • 暂不支持:任务列表接口、联网搜索(tools)。
  • 素材 ID 请填在参考图("role": "reference_image")里,只能用自己账号下创建的素材;视频还没结束时,它引用的素材不能删除。
  • 已不支持请求里的 portrait 字段,会返回 400 InvalidParameter;人物形象请改用素材 ID。

错误响应

错误的格式为 {"error": {"code": "…", "message": "…", "param": "", "type": "…"}}。