创建视频生成任务

Seedance 2.0 POST /v1/video/generations

POST /v1/video/generations

创建视频生成任务

cURL

curl --request POST \
  --url https://api.tennda.ai/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 数组

type	role	说明	数量
text	—	文本提示词	1 条
image_url	（省略）	默认作首帧	1 张
image_url	first_frame	首帧图片	1 张
image_url	last_frame	尾帧（须搭配 first_frame）	1 张
image_url	reference_image	参考图片	最多 9 张
video_url	reference_video	参考视频	最多 3 个
audio_url	reference_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_type	type	字段	role
Image	image_url	image_url.url	reference_image / first_frame / last_frame
Video	video_url	video_url.url	reference_video
Audio	audio_url	audio_url.url	reference_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.tennda.ai/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.tennda.ai/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.tennda.ai/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.tennda.ai/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.tennda.ai/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
}

下一步：查询视频生成任务