POST
https://zx1.deepwl.net
/
v1
/
video
/
generations
创建视频
curl --request POST \
  --url https://zx1.deepwl.net/v1/video/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "content": [
    {}
  ],
  "content[].type": "<string>",
  "content[].text": "<string>",
  "content[].image_url": {},
  "content[].image_url.url": "<string>",
  "content[].video_url": {},
  "content[].video_url.url": "<string>",
  "content[].audio_url": {},
  "content[].audio_url.url": "<string>",
  "content[].draft_task": {},
  "content[].draft_task.id": "<string>",
  "content[].role": "<string>",
  "metadata": {},
  "metadata.duration": 123,
  "metadata.resolution": "<string>",
  "metadata.ratio": "<string>",
  "metadata.frames": 123,
  "metadata.seed": 123,
  "metadata.camera_fixed": true,
  "metadata.watermark": true,
  "metadata.generate_audio": true,
  "metadata.return_last_frame": true,
  "metadata.draft": true,
  "metadata.service_tier": "<string>",
  "metadata.execution_expires_after": 123,
  "metadata.callback_url": "<string>"
}
'
{
  "task_id": "cgt-20260412163502-x8k2m"
}

​
创建视频

提交 Seedance 2.0 视频生成任务，支持文生视频、首帧/首尾帧、参考图/视频/音频、视频延续、视频编辑与多模态合成等模式。素材库资产在 content 中推荐使用 asset://{assetId} 引用（见 上传素材）。

​
方法与路径

POST /v1/video/generations

​
请求示例

{
  "model": "doubao-seedance-2-0-260128",
  "content": [
    {
      "type": "text",
      "text": "第一人称视角果茶广告：0-2秒 手摘苹果；2-4秒 切镜头投入雪克杯摇晃；4-6秒 倒入透明杯特写；6-8秒 举杯到镜头前"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/apple.jpg" },
      "role": "reference_image"
    },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/cup.jpg" },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": { "url": "https://example.com/pov_reference.mp4" },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": { "url": "https://example.com/bgm.mp3" },
      "role": "reference_audio"
    }
  ],
  "metadata": {
    "duration": 8,
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": true,
    "watermark": false
  }
}

​
响应示例

{
  "task_id": "cgt-20260412163502-x8k2m"
}
提交后使用 查询任务 轮询 task_id。

​
认证

Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
必填
模型名称：
  • doubao-seedance-2-0-260128：标准版，追求最佳画质与复杂镜头调度
  • doubao-seedance-2-0-fast-260128：Fast 版，追求低延迟、成本敏感场景
​
content
array<object>
必填
多模态输入数组，顺序影响角色分配。
​
content[].type
string
必填
内容类型：text、image_url、video_url、audio_url、draft_task。
​
content[].text
string
当 type=text 时必填，提示词文本。
​
content[].image_url
object
当 type=image_url 时使用，须包含 url。
​
content[].image_url.url
string
必填
图片公网 URL 或素材引用 asset://{assetId}。
​
content[].video_url
object
当 type=video_url 时使用，须包含 url。
​
content[].video_url.url
string
必填
视频公网 URL 或 asset://{assetId}。
​
content[].audio_url
object
当 type=audio_url 时使用，须包含 url。
​
content[].audio_url.url
string
必填
音频公网 URL 或 asset://{assetId}。
​
content[].draft_task
object
当 type=draft_task 时使用，须包含 id；且必须是 content 中唯一元素。
​
content[].draft_task.id
string
必填
草稿任务 ID，用于基于草稿继续生成。
​
content[].role
string
媒体角色：
  • first_frame：首帧（图片）
  • last_frame：尾帧（图片）
  • reference_image：参考图
  • reference_video：参考/源视频（延续、编辑）
  • reference_audio：参考音频（须 metadata.generate_audio=true）
​
metadata
object
视频生成参数，均为可选。
​
metadata.duration
integer
视频时长（秒）。合法范围 [4, 15] 或 -1（由模型自动决定），默认 5。
​
metadata.resolution
string
分辨率：480p、720p、1080p，默认 720p。
​
metadata.ratio
string
宽高比：16:9、9:16、1:1、4:3、adaptive，默认 16:9。
​
metadata.frames
integer
视频总帧数。与 duration 二选一，传了 frames 时优先于 duration。
​
metadata.seed
integer
随机种子。相同 seed + 相同输入可得到相近结果。
​
metadata.camera_fixed
boolean
是否固定机位（抑制镜头运动），默认 false。
​
metadata.watermark
boolean
是否在视频右下角加水印，默认 true。
​
metadata.generate_audio
boolean
是否生成或合成音频。使用 reference_audio 时必须为 true，默认 false。
​
metadata.return_last_frame
boolean
是否返回末帧图片 URL，便于后续续写，默认 false。
​
metadata.draft
boolean
草稿模式：生成更快、质量略低，适合预览，默认 false。
​
metadata.service_tier
string
服务等级，默认 default。
​
metadata.execution_expires_after
integer
任务最长执行时间（秒），范围 [3600, 259200]（1 小时～3 天），默认 172800。
​
metadata.callback_url
string
任务完成时的回调 URL。

​
content 混用规则

违反以下规则可能返回 400：
  • reference_image 不能与 first_frame / last_frame 同时出现
  • audio_url 不能作为 content 中唯一输入，须至少搭配图片或视频
  • draft_task 必须是 content 数组里的唯一元素

​
生成模式对照

模式请求示例标签content 要点
文生视频文生视频text + 可选参考图/视频/音频
首帧图生视频首帧图生视频text + first_frame
首尾帧生视频首尾帧生视频text + first_frame + last_frame
参考图生视频参考图生视频text + reference_image
视频延续视频延续text + reference_video
视频编辑视频编辑text + reference_video + reference_image
多模态合成多模态合成text + 多类型参考组合
引用素材库引用素材各 URL 使用 asset://{assetId}

​
Response

​
task_id
string
任务 ID，用于 查询任务。

​
相关页面