生成视频 API​

POST https://art-api.yuyuflow.com/api/v3/contents/generations/tasks

模型会依据传入的图片及文本信息生成视频，待生成完成后，您可以按条件查询任务并获取生成的视频。

模型能力​

• Doubao Seedance 2.0 系列（有声视频 / 无声视频）
  • 多模态参考生视频：输入参考图片（0-9）+ 参考视频（0-3）+ 参考音频（0-3）+ 文本提示词（可选）生成 1 个目标视频。注意不可单独输入音频，应至少包含 1 个参考视频或图片。支持生成全新视频、编辑视频、延长视频。
  • 图生视频-首尾帧：输入首帧图片 + 尾帧图片 + 文本提示词（可选）生成 1 个目标视频。
  • 图生视频-首帧：输入首帧图片 + 文本提示词（可选）生成 1 个目标视频。
  • 文生视频：输入文本提示词生成 1 个目标视频。

鉴权​

本接口仅支持 API Key 鉴权，请在 https://art-api.yuyuflow.com/dashboard/overview 获取 API Key。

请求参数​

Body 参数​

model string 必选

您需要调用的模型的 ID（Model ID），开通模型服务，并查询 Model ID。

您也可通过 Endpoint ID 来调用模型，获得限流、计费类型、运行状态查询、监控、安全等高级能力，可参考获取 Endpoint ID。

content object[] 必选

输入给模型，生成视频的信息，支持文本、图片、音频、视频、样片任务 ID。

支持以下几种组合：

• 文本
• 文本（可选）+ 图片
• 文本（可选）+ 视频
• 文本（可选）+ 图片 + 音频
• 文本（可选）+ 图片 + 视频
• 文本（可选）+ 视频 + 音频
• 文本（可选）+ 图片 + 视频 + 音频
• 样片任务 ID：样片指使用 Seedance 模型成功生成的样片视频，模型可基于样片生成高质量正式视频。

文本信息 object​

输入给模型的提示词信息。

• content.type string 必选：输入内容的类型，此处应为 text。
• content.text string 必选：输入给模型的文本提示词，描述期望生成的视频。

图片信息 object​

输入给模型的图片信息。

• content.type string 必选：输入内容的类型，此处应为 image_url。
• content.image_url object 必选：输入给模型的图片对象。
  • content.image_url.url string 必选：图片 URL、图片 Base64 编码、素材 ID。
    • 图片 URL：填入图片的公网 URL。
    • Base64 编码：格式 data:image/<图片格式>;base64,<Base64编码>，<图片格式> 需小写，如 data:image/png;base64,{base64_image}。
    • 素材 ID：格式 asset://<ASSET_ID>。
• content.role string 条件必填：图片的位置或用途。

图生视频-首帧

• 支持模型：所有模型
• 字段 role 取值：需要传入 1 个 image_url 对象，字段 role 为 first_frame 或不填。

图生视频-首尾帧

• 支持模型：Seedance 2.0 系列，Seedance 1.5 Pro、Seedance 1.0 Pro
• 字段 role 取值：需要传入 2 个 image_url 对象，且字段 role 必填。首帧为 first_frame，尾帧为 last_frame。

图生视频-参考图

• 支持模型：Seedance 2.0 系列（1~9 张图片）
• 字段 role 取值：必填，每张参考图对应的字段 role 均为 reference_image。

视频信息 object​

输入给模型的视频信息。仅 Seedance 2.0 系列支持输入视频。

平台信任 Seedance 2.0 系列模型生成的含人脸视频，您可使用本账号下近 30 天内由上述模型生成的含人脸原始视频作为输入素材进行二次创作。

• content.type string 必选：输入内容的类型，此处应为 video_url。
• content.video_url object 必选：输入给模型的视频对象。
  • content.video_url.url string 必选：视频 URL、素材 ID。
    • 视频 URL：填入视频的公网 URL。
    • 素材 ID：格式 asset://<ASSET_ID>。
• content.role string 条件必填：视频的位置或用途。当前仅支持 reference_video：参考视频。

音频信息 object​

输入给模型的音频信息。仅 Seedance 2.0 系列支持输入音频。注意不可单独输入音频，应至少包含 1 个参考视频或图片。

• content.type string 必选：输入内容的类型，此处应为 audio_url。
• content.audio_url object 必选：输入给模型的音频对象。
  • content.audio_url.url string 必选：音频 URL、音频 Base64 编码、素材 ID。
    • 音频 URL：填入音频的公网 URL。
    • Base64 编码：格式 data:audio/<音频格式>;base64,<Base64编码>，<音频格式> 需小写，如 data:audio/wav;base64,{base64_audio}。
    • 素材 ID：格式 asset://<ASSET_ID>。
• content.role string 条件必填：音频的位置或用途。当前仅支持 reference_audio：参考音频。

样片信息 object​

基于样片任务 ID，生成正式视频。仅 Seedance 1.5 Pro 支持该功能。

• content.type string 必选：输入内容的类型，此处应为 draft_task。
• content.draft_task object 必选：输入给模型的样片任务。
  • content.draft_task.id string 必选：样片任务 ID。平台将自动复用 Draft 视频使用的用户输入（model、content.text、content.image_url、generate_audio、seed、ratio、duration、camera_fixed），生成正式视频。其余参数支持指定，不指定将使用本模型的默认值。

callback_url string

填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时，平台将向此地址推送 POST 请求。

回调请求内容结构与查询任务 API 的返回体一致。回调返回的 status 包括：

• queued：排队中。
• running：任务运行中。
• succeeded：任务成功。（如发送失败，即 5 秒内没有接收到成功发送的信息，回调三次）
• failed：任务失败。（如发送失败，即 5 秒内没有接收到成功发送的信息，回调三次）
• cancelled：取消任务，取消状态 24h 自动删除（只支持排队中状态的任务被取消）。
• expired：任务超时。可通过 execution_expires_after 字段设置过期时间。

return_last_frame boolean 默认值 false

• true：返回生成视频的尾帧图像（png 格式，无水印）。可通过查询视频生成任务接口获取。可实现生成多个连续视频：以上一个生成视频的尾帧作为下一个视频任务的首帧。
• false：不返回生成视频的尾帧图像。

service_tier string 默认值 default

不支持修改已提交任务的服务等级。Seedance 2.0 系列仅支持在线推理模式，不支持配置该参数。

指定处理本次请求的服务等级类型，枚举值：

• default：在线推理模式，RPM 和并发数配额较低，适合对推理时效性要求较高的场景。
• flex：离线推理模式，TPD 配额更高，价格为在线推理的 50%，适合对推理时延要求不高的场景。

execution_expires_after integer 默认值 172800

任务超时阈值。指定任务提交后的过期时间（单位：秒），从 created at 时间戳开始计算。默认值 172800 秒（48 小时）。取值范围：[3600, 259200]。超过该时间后任务会被自动终止，并标记为 expired 状态。

generate_audio boolean 默认值 true

仅 Seedance 2.0 系列、Seedance 1.5 Pro 支持。

控制生成的视频是否包含与画面同步的声音。

• true：模型输出的视频包含同步音频。模型会基于文本提示词与视觉内容，自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内，以优化音频生成效果。
• false：模型输出的视频为无声视频。

draft boolean 默认值 false

仅 Seedance 1.5 Pro 支持。

控制是否开启样片模式。

• true：开启样片模式，生成一段预览视频，快速验证场景结构、镜头调度、主体动作与 Prompt 意图是否符合预期。消耗 token 数较正常视频更少，使用成本更低。
• false：关闭样片模式，正常生成一段视频。

tools object[]

仅 Seedance 2.0 系列支持。

配置模型要调用的工具。

• tools.type string：指定使用的工具类型。
  • web_search：联网搜索工具。开启后模型会根据用户的提示词自主判断是否搜索互联网内容（如商品、天气等），可提升生成视频的时效性，但也会增加一定的时延。实际搜索次数可通过查询视频生成任务 API 返回的 usage.tool_usage.web_search 字段获取。

safety_identifier string

终端用户的唯一标识符，用于协助平台检测您的应用中可能违反平台使用政策的用户。该标识符为英文字符串，需保证对单个用户固定且唯一，长度不超过 64 个字符。推荐传入对用户名、用户 ID 或邮箱进行哈希处理后生成的字符串，避免泄露用户隐私信息。

priority integer 默认值 0

仅 Seedance 2.0 系列支持。

设置当前请求的执行优先级，决定其在队列中的排序位置。取值范围：0~9，数值越大，优先级越高。

默认情况下，请求按 FIFO（先进先出）顺序执行。设置较高优先级后，该请求将插队到同 Endpoint 下所有低优先级请求之前。

参数传入方式升级​

新方式（推荐）：在 request body 中直接传入参数

{
    "model": "doubao-seedance-1-5-Pro-251215",
    "content": [
        {
            "type": "text",
            "text": "小猫对着镜头打哈欠"
        }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": 11,
    "camera_fixed": false,
    "watermark": true
}

旧方式：在文本提示词后追加 --[parameters]

{
    "model": "doubao-seedance-1-5-Pro-251215",
    "content": [
        {
            "type": "text",
            "text": "小猫对着镜头打哈欠 --rs 720p --rt 16:9 --dur 5 --seed 11 --cf false --wm true"
        }
    ]
}

输出视频格式参数​

resolution string

Seedance 2.0 系列、Seedance 1.5 Pro 默认值：720p。Seedance 1.0 Pro、Seedance 1.0 Pro Fast 默认值：1080p。

视频分辨率，枚举值：

• 480p
• 720p
• 1080p：Seedance 2.0 Fast 和 Seedance 2.0 Mini 不支持。
• 4k：仅 Seedance 2.0 支持。采用 10bit 位深编码，满足专业影视制作与 HDR 视频内容的要求。4K 视频采用 H.265 编码，少数播放环境可能不兼容，建议使用 VLC、MPV、QuickTime Player 等播放器查看。

ratio string

Seedance 2.0 系列、Seedance 1.5 Pro 默认值为 adaptive。其他模型：文生视频默认值 16:9，图生视频默认值 adaptive。

生成视频的宽高比例：

• 16:9、4:3、1:1、3:4、9:16、21:9
• adaptive：根据输入自动选择最合适的宽高比。Seedance 2.0 系列、Seedance 1.5 Pro 支持；其他模型仅图生视频场景支持。

不同宽高比对应的宽高像素值：图生视频时，选择的宽高比与上传的图片宽高比不一致时，平台会对图片进行居中裁剪。

注：1080p 中 Seedance 2.0 Fast、Seedance 2.0 Mini 不支持；4k 仅 Seedance 2.0 支持。

duration integer 默认值 5

duration 和 frames 二选一即可，frames 的优先级高于 duration。如果您希望生成整数秒的视频，建议指定 duration。

生成视频时长，仅支持整数，单位：秒。

• Seedance 1.0 Pro、Seedance 1.0 Pro Fast：[2, 12] s。
• Seedance 1.5 Pro：[4, 12] 或设置为 -1。
• Seedance 2.0 系列：[4, 15] 或设置为 -1。

frames integer

Seedance 2.0 系列、Seedance 1.5 Pro 暂不支持。duration 和 frames 二选一即可，frames 的优先级高于 duration。

生成视频的帧数，可灵活控制生成视频的长度，生成小数秒的视频。

• 计算公式：帧数 = 时长 × 帧率（24）。
• 取值范围：支持 [29, 289] 区间内所有满足 25 + 4n 格式的整数值，其中 n 为正整数。

例如：需要生成 2.4 秒的视频，帧数 = 2.4×24 = 57.6。根据 25+4n 计算出最接近的帧数为 57，实际生成的视频为 57/24 = 2.375 秒。

seed integer 默认值 -1

Seedance 2.0 系列暂不支持。

种子整数，用于控制生成内容的随机性。取值范围：[-1, 2^32-1] 之间的整数。

camera_fixed boolean 默认值 false

参考图场景不支持，Seedance 2.0 系列暂不支持。

是否固定摄像头。

• true：固定摄像头。平台会在用户提示词中追加固定摄像头，实际效果不保证。
• false：不固定摄像头。

watermark boolean 默认值 false

生成视频是否包含水印。

• false：生成视频不含水印。
• true：生成视频右下角会展示 AI 生成 水印。

响应参数​

id string

视频生成任务 ID。仅保存 7 天（从 created at 时间戳开始计算），超时后将自动清除。

• 设置 "draft": true，为 Draft 视频任务 ID。
• 设置 "draft": false，为正常视频任务 ID。

创建视频生成任务为异步接口，获取 ID 后，需要通过查询视频生成任务 API 来查询任务状态。任务成功后，会输出生成视频的 video_url。