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

​
简介

提交 Seedance 2.0 异步视频生成任务，返回 task_id 用于轮询。content 与 prompt 至少提供一个，推荐使用 content 数组。

​
认证

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

​
请求参数

​
model
string
必填
seedance-2-0 或 seedance-2-0-fast
​
content
array
多模态内容数组（见下方）；与 prompt 二选一，至少提供一个
​
prompt
string
文本提示词，content 的简化替代
​
duration
integer
默认值:"5"
-1（自动）或 4~15 秒
​
resolution
string
默认值:"720p"
480p、720p；标准版还支持 1080p（fast 不支持 1080p）
​
ratio
string
默认值:"16:9"
16:9、9:16、1:1、4:3、3:4、21:9、adaptive（首帧图建议 adaptive；参考图/参考视频模式下不可用）
​
generate_audio
boolean
默认值:"true"
是否自动生成音频；提供 reference_audio 时建议设为 false
​
watermark
boolean
默认值:"false"
是否添加水印
​
seed
integer
默认值:"-1"
随机种子，-1 为随机；固定正整数可复现结果

​
content 数组

typerole说明数量
text—文本提示词1 条
image_url（省略）默认作首帧1 张
image_urlfirst_frame首帧图片1 张
image_urllast_frame尾帧（须搭配 first_frame）1 张
image_urlreference_image参考图片最多 9 张
video_urlreference_video参考视频最多 3 个
audio_urlreference_audio参考音频（须搭配图/视频）最多 3 段
互斥规则： first_frame 与 reference_image 不能同时使用；last_frame 须搭配 first_frame。
asset:// 须按 asset_type 分流：Image → image_url；Video → video_url；Audio → audio_url。音频素材塞入 image_url 会返回 InvalidParameter。
素材 asset_typetype字段role
Imageimage_urlimage_url.urlreference_image / first_frame / last_frame
Videovideo_urlvideo_url.urlreference_video
Audioaudio_urlaudio_url.urlreference_audio

​
content 裸传 URL 限制

content 中直接传 http(s) URL（非 asset://）时，资源须满足下列约束；asset:// 引用素材库时数值约束相同，图片格式在素材库侧可更宽（见 创建素材）。
类型主要限制
图片JPEG / PNG / WebP，≤ 30MB，300~6000px；reference_image 最多 9 张；首/尾帧各 1 张
视频MP4 / MOV，≤ 50MB，单段 2~15 秒，最多 3 个 reference_video，总时长 ≤ 15 秒
音频WAV / MP3，≤ 15MB，2~15 秒/段，最多 3 段；须搭配图片或视频

​
请求示例

文生视频： 
curl -X POST "https://api.novawander.cn/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "content": [
      {"type": "text", "text": "黄金时刻，无人机航拍连绵山脉，云海翻涌"}
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true
  }'
简化 prompt（文生视频）： 
curl -X POST "https://api.novawander.cn/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "prompt": "黄金时刻，无人机航拍连绵山脉",
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9"
  }'
图生视频（首帧）： 
curl -X POST "https://api.novawander.cn/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "content": [
      {"type": "text", "text": "镜头缓慢推进，花瓣随风飘落"},
      {"type": "image_url", "image_url": {"url": "https://example.com/garden.jpg"}}
    ],
    "ratio": "adaptive"
  }'
图生视频（首尾帧）： 
curl -X POST "https://api.novawander.cn/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "content": [
      {"type": "text", "text": "日出到日落的延时摄影效果"},
      {"type": "image_url", "image_url": {"url": "https://example.com/sunrise.jpg"}, "role": "first_frame"},
      {"type": "image_url", "image_url": {"url": "https://example.com/sunset.jpg"}, "role": "last_frame"}
    ],
    "duration": 10,
    "ratio": "adaptive"
  }'
素材库 + 多模态： 
curl -X POST "https://api.novawander.cn/v1/video/generations" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "content": [
      {"type": "text", "text": "素材1 用素材2唱歌"},
      {"type": "image_url", "image_url": {"url": "asset://asset-xxx-image"}, "role": "reference_image"},
      {"type": "audio_url", "audio_url": {"url": "asset://asset-xxx-audio"}, "role": "reference_audio"}
    ],
    "duration": 5,
    "generate_audio": false
  }'
仅 active 状态素材可用于生成；同一次请求引用的多张素材须来自同一素材组。

​
响应示例

{
  "id": "ut-abc123def456",
  "task_id": "ut-abc123def456",
  "object": "video",
  "model": "seedance-2-0",
  "status": "queued",
  "progress": 0,
  "created_at": 1712563200
}
下一步：查询视频生成任务