seedance 1.5-pro
/api/v1/video/generationHeader Parameters
格式: Authorization: Bearer sk-xxxxxx
Request Body
application/json
模型名称，固定值
"doubao-seedance-1-5-pro-251215"输入给模型生成视频的信息，支持文本、图片、样片任务 ID。
支持以下几种组合：
纯文本
文本（可选）+ 图片
样片任务 ID：样片指使用 Seedance 模型成功生成的样片视频，模型可基于样片生成高质量正式视频
输入内容的类型
"text" | "image_url" | "draft_task"图片/视频/音频的位置或用途。
图片场景：
首帧：first_frame(或不填)，需要传入1个image_url对象
首尾帧：first_frame和last_frame，需要传入2个image_url对象
传入的首尾帧图片可相同。首尾帧图片的宽高比不一致时，以首帧图片为主，尾帧图片会自动裁剪适配。
输入给模型的文本提示词，描述期望生成的视频。
提示词语言支持：中文、英文。
提示词字数建议：中文提示词不超过500字，英文提示词不超过1000词。字数过多易导致信息分散，模型可能忽略细节、仅关注重点，进而造成视频缺失部分元素。
图片信息，可以是图片URL/图片Base64 编码/素材ID。
传入单张图片要求：
格式：jpeg、png、webp、bmp、tiff、gif、heic、heif。
宽高比（宽/高）：[0.4, 2.5]
宽高长度（px）：[300, 6000]
大小：单张图片小于 30 MB。请求体大小不超过 64 MB。大文件请勿使用Base64编码。
基于样片任务 ID，生成正式视频。
样片任务 ID。平台将自动复用 Draft 视频使用的用户输入（model、content.text、content.image_url、generate_audio、seed、ratio、duration、camera_fixed ），生成正式视频。其余参数支持指定，不指定将使用本模型的默认值。
视频分辨率，默认值 720p
"480p" | "720p" | "1080p"生成视频的宽高比例，默认值 adaptive。
adaptive：根据输入自动选择最合适的宽高比
图生视频，选择的宽高比和图片宽高比不一致时，会对输入图片进行裁剪，裁剪规则参考火山官网文档。
"16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "adaptive"生成视频时长，单位：秒。
可选范围：[4,12] 或设置为-1（-1 表示自适应时长）
duration=-1时的取值规则：
模型在 duration 的有效取值范围内，自主选择合适的视频长度（整数秒）。
控制生成的视频是否包含与画面同步的声音。
注意：生成的有声视频均为单声道、和传入的音频声道数无关。
true：模型输出的视频包含同步音频。模型会基于文本提示词与视觉内容，自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内，以优化音频生成效果。例如：男人叫住女人说：“你记住，以后不可以用手指指月亮。”
false：模型输出的视频为无声视频。
生成视频是否包含水印。枚举值：
false：不含水印。
true：含有水印。
种子整数，用于控制生成内容的随机性。
取值范围：[-1, 2147483647]之间的整数。
重要：需要配合return_original参数返回原厂数据使用
true：返回生成视频的尾帧图像。设置为 true 后，可通过 查询视频生成任务接口 获取视频的尾帧图像。尾帧图像的格式为 png，宽高像素值与生成的视频保持一致，无水印。
false：不返回生成视频的尾帧图像。
控制是否开启样片模式
true：开启样片模式，生成一段预览视频，快速验证场景结构、镜头调度、主体动作与 prompt 意图是否符合预期。消耗 token 数较正常视频更少，使用成本更低。
false：关闭样片模式，正常生成一段视频。
开启样片模式后，将使用 480p 分辨率生成 Draft 视频（使用其他分辨率会报错），不支持返回尾帧功能。
填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时，方舟将向此地址推送 POST 请求。
回调请求内容结构与查询任务API的返回体一致。
回调返回的 status 包括以下状态：
queued：排队中。
running：任务运行中。
succeeded： 任务成功。（如发送失败，即5秒内没有接收到成功发送的信息，回调三次）
failed：任务失败。（如发送失败，即5秒内没有接收到成功发送的信息，回调三次）
expired：任务超时，即任务处于运行中或排队中状态超过过期时间。可通过 execution_expires_after 字段设置过期时间。
任务超时阈值。指定任务提交后的过期时间（单位：秒），从 created at 时间戳开始计算。默认值 172800 秒，即 48 小时。取值范围：[3600，259200]。
不论使用哪种 service_tier，都建议根据业务场景设置合适的超时时间。超过该时间后任务会被自动终止，并标记为expired状态。
终端用户的唯一标识符，用于协助平台检测您的应用中可能违反火山方舟使用政策的用户。该标识符为英文字符串，需保证对单个用户固定且唯一，长度不超过 64 个字符。推荐传入对用户名、用户 ID 或邮箱进行哈希处理后生成的字符串，避免泄露用户隐私信息。
Response Body
application/json
成功
TypeScript Definitions
Use the response body type in TypeScript.
状态码
数据对象
结果集
消耗信息
图片张数
视频秒数
输入token数
总token数
输出token数
有效期
任务ID
任务状态
状态信息
请求ID
curl -X POST "https://api.aa.com.cn/api/v1/video/generation" \ -H "Content-Type: application/json" \ -d '{ "model": "doubao-seedance-1-5-pro-251215", "content": [ { "type": "text" } ], "resolution": "480p", "ratio": "16:9", "watermark": true }'{
"code": 0,
"data": {
"urls": [
"string"
],
"usage": {
"images": 0,
"seconds": 0,
"input_tokens": 0,
"total_tokens": 0,
"output_tokens": 0
},
"expired": "string",
"task_id": "string",
"task_status": "string"
},
"message": "string",
"request_id": "string"
}