POST
/
api
/
v3
/
contents
/
generations
/
tasks
豆包视频生成
curl --request POST \
  --url https://www.666api.ai/api/v3/contents/generations/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance",
  "content": [
    {
      "type": "text",
      "text": "延长@视频1,一镜到底运镜,全程无剪辑断点,新年喜庆氛围感拉满;开篇@视频1画面,自然衔接慢拉镜头匀速穿过厨房门,顺滑过渡到客厅,一对夫妻正在客厅门口贴福字,镜头无缝摇移至贴窗花的客厅窗户处,紧接着慢推镜头从窗户向外穿出,流畅衔接孩子们在室外空地上放烟花的场景;全程运镜丝滑连贯、速度均匀不卡顿,画面融入红灯笼等新年元素,烘托浓厚过年氛围;背景音乐参考@音频1,背景语音为:“新春快乐,阖家幸福,马年吉祥”,整体保证一镜到底的视觉连贯性、沉浸感,年味与氛围感双重拉满,人物比例符合现实世界物理规律。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://filesys.file.com/*****.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://filesys.file.com/*****.jpg"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://filesys.file.com/*****.mp3"
      },
      "role": "reference_audio"
    }
  ],
  "generate_audio": true,
  "ratio": "16:9",
  "duration": 11,
  "watermark": false,
  "tools": [
    {
      "type": "web_search"
    }
  ]
}
'
{
  "id": "cgt-2025******-****"
}

Authorizations

Authorization
string
header
required

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

Headers

Content-Type
string
Authorization
string

Body

application/json
model
string
required

您需要调用的模型的 ID

content
object[]
required

输入给模型,生成视频的信息,支持文本、图片和视频(样片,Draft 视频)格式。支持以下几种组合: 文本 文本+图片 视频:其中视频指已成功生成的样片视频,模型可基于样片生成高质量正式视频。

信息类型

callback_url
string

填写本次生成任务结果的回调通知地址。当视频生成任务有状态变化时,方舟将向此地址推送 POST 请求。 回调请求内容结构与查询任务API的返回体一致。 回调返回的 status 包括以下状态: queued:排队中。 running:任务运行中。 succeeded: 任务成功。(如发送失败,即5秒内没有接收到成功发送的信息,回调三次) failed:任务失败。(如发送失败,即5秒内没有接收到成功发送的信息,回调三次) expired:任务超时,即任务处于运行中或排队中状态超过过期时间。可通过 execution_expires_after 字段设置过期时间。

return_last_frame
boolean

默认值 false true:返回生成视频的尾帧图像。设置为 true 后,可通过 查询视频生成任务接口 获取视频的尾帧图像。尾帧图像的格式为 png,宽高像素值与生成的视频保持一致,无水印。 使用该参数可实现生成多个连续视频:以上一个生成视频的尾帧作为下一个视频任务的首帧,快速生成多个连续视频,调用示例详见 教程。 false:不返回生成视频的尾帧图像。

service_tier
string

指定处理本次请求的服务等级类型,枚举值: default:在线推理模式,RPM 和并发数配额较低(详见 模型列表),适合对推理时效性要求较高的场景。 flex:离线推理模式,TPD 配额更高(详见 模型列表),价格为在线推理的 50%, 适合对推理时延要求不高的场景。

execution_expires_after
number

任务超时阈值。指定任务提交后的过期时间(单位:秒),从 created at 时间戳开始计算。默认值 172800 秒,即 48 小时。取值范围:[3600,259200]。 不论使用哪种 service_tier,都建议根据业务场景设置合适的超时时间。超过该时间后任务会被自动终止,并标记为expired状态。

seed
number

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

generate_audio
boolean

控制生成的视频是否包含与画面同步的声音。 true:模型输出的视频包含同步音频。Seedance 1.5 pro 能够基于文本提示词与视觉内容,自动生成与之匹配的人声、音效及背景音乐。建议将对话部分置于双引号内,以优化音频生成效果。例如:男人叫住女人说:“你记住,以后不可以用手指指月亮。” false:模型输出的视频为无声视频。

draft
boolean

控制是否开启样片模式。阅读文档 获取使用教程和注意事项。 true:开启样片模式,生成一段预览视频,快速验证场景结构、镜头调度、主体动作与 prompt 意图是否符合预期。消耗 token 数较正常视频更少,使用成本更低。 false:关闭样片模式,正常生成一段视频。

resolution
string

视频分辨率,枚举值: 480p 720p 1080p:参考图场景不支持

ratio
boolean

文生视频:默认值 16:9( Seedance 1.5 Pro 默认值为 adaptive)图生视频:默认值 adaptive(参考图生视频场景默认值为 16:9)生成视频的宽高比例。不同宽高比对应的宽高像素值见下方表格。 16:9 4:3 1:1 3:4 9:16 21:9 adaptive:根据输入自动选择最合适的宽高比

duration
integer

生成视频时长,单位:秒。支持 2~12 秒。

frames
string

生成视频的帧数。通过指定帧数,可以灵活控制生成视频的长度,生成小数秒的视频。 由于 frames 的取值限制,仅能支持有限小数秒,您需要根据公式推算最接近的帧数。 计算公式:帧数 = 时长 × 帧率(24)。 取值范围:支持 [29, 289] 区间内所有满足 25 + 4n 格式的整数值,其中 n 为正整数。 例如:假设需要生成 2.4 秒的视频,帧数=2.4×24=57.6。由于 frames 不支持 57.6,此时您只能选择一个最接近的值。根据 25+4n 计算出最接近的帧数为 57,实际生成的视频为 57/24=2.375 秒。

watermark
boolean

生成视频是否包含水印。枚举值: false:不含水印。 true:含有水印。

tools
object[]

仅文本输入模式

Response

200 - application/json
id
string
required