POST
/
api
/
v3
/
contents
/
generations
/
tasks
创建视频生成任务
curl --request POST \
  --url https://api.novawander.cn/api/v3/contents/generations/tasks \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "content": [
    {}
  ],
  "prompt": "<string>",
  "callback_url": "<string>",
  "return_last_frame": true,
  "service_tier": "<string>",
  "execution_expires_after": 123,
  "generate_audio": true,
  "safety_identifier": "<string>",
  "resolution": "<string>",
  "ratio": "<string>",
  "duration": 123,
  "seed": 123,
  "watermark": true
}
'

​
简介

提交 Seedance 2.0 官方镜像异步视频生成任务，成功返回任务 id。content 与 prompt 至少提供一个。 与 BytePlus Ark 官方接口请求体、响应体完全一致。

​
认证

​
Authorization
string
必填
Bearer Token，如 Bearer sk-your_token_key
​
Content-Type
string
application/json

​
请求参数

​
model
string
必填
模型 ID：seedance-2-0 / seedance-2-0-fast / seedance-2-0-NSFW
​
content
array
内容数组：text / image_url / video_url / audio_url，各元素可带 role（first_frame / last_frame / reference_image / reference_video / reference_audio）；与 prompt 至少提供一个
​
prompt
string
简化写法，与 content 二选一
​
callback_url
string
任务状态变化时的回调地址
​
return_last_frame
boolean
默认值:"false"
是否返回最后一帧图片
​
service_tier
string
默认值:"default"
default / flex
​
execution_expires_after
integer
默认值:"172800"
任务过期时间（秒），范围 [3600, 259200]
​
generate_audio
boolean
默认值:"true"
是否生成音频
​
safety_identifier
string
终端用户唯一标识（建议传用户 ID 的哈希）
​
resolution
string
默认值:"720p"
480p / 720p / 1080p / 4K（seedance-2-0-fast 仅支持 480p/720p）
​
ratio
string
默认值:"adaptive"
16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / adaptive
​
duration
integer
默认值:"5"
秒数，[4,15] 或 -1（自动）
​
seed
integer
默认值:"-1"
随机种子
​
watermark
boolean
默认值:"false"
是否加水印
content[].image_url.url / video_url.url / audio_url.url 支持三种值：公网 URL、Base64（data:image/png;base64,...）、asset://&lt;ASSET_ID&gt; 素材库引用。

​
请求示例

curl -X POST https://api.novawander.cn/api/v3/contents/generations/tasks \
  -H "Authorization: Bearer sk-your_token_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "content": [
      {"type": "text", "text": "黄金时刻，无人机航拍连绵山脉"}
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'

​
响应示例

{
  "id": "cgt-20260708094649-mxfjc"
}
下一步：查询视频生成任务