跳转到主要内容
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.0",
    "prompt": "小猫对着镜头打哈欠",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T"
    }
  ]
}

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "doubao-seedance-2.0",
    "prompt": "小猫对着镜头打哈欠",
    "resolution": "720p",
    "size": "16:9",
    "duration": 5,
    "generate_audio": true
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KMCGF6BQGN3X28H3KSR50X5T"
    }
  ]
}

​
认证

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key：访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加：
Authorization: Bearer YOUR_API_KEY

​
请求参数

​
model
string
必填
视频生成模型名称支持的模型：
  • doubao-seedance-2.0 - 标准版，支持文生视频、图生视频、首尾帧视频、参考视频、参考音频、有声视频
  • doubao-seedance-2.0-fast - 快速版，功能与标准版一致，生成速度更快
  • doubao-seedance-2.0-face - 支持上传真人版，功能与标准版一致
  • doubao-seedance-2.0-fast-face - 支持上传真人版，功能与快速版一致
​
prompt
string
视频内容描述文生视频时必填，图生视频/视频参考生视频时可选建议明确主体、动作、镜头和风格，以获得更好的生成效果
提示词限制输入 4000 个字符，但是建议输入 500 字符。
示例："小猫对着镜头打哈欠"
​
duration
integer
默认值:"5"
视频时长（秒）支持范围：4 ~ 15 秒默认值：5
​
size
string
默认值:"16:9"
视频宽高比可选值：
  • 16:9 - 横屏
  • 9:16 - 竖屏
  • 1:1 - 方形
  • 4:3 - 传统比例
  • 3:4 - 竖向传统比例
  • 21:9 - 超宽屏
  • adaptive - 自适应（根据输入图片/视频自动匹配）
默认值：16:9
​
resolution
string
默认值:"480p"
视频分辨率可选值：
  • 480p - 标清
  • 720p - 高清
  • 1080p - 全高清（仅 doubao-seedance-2.0-face 和 doubao-seedance-2.0 支持）
默认值：480p
​
seed
integer
随机种子，用于控制生成内容的随机性
  • 相同的请求下，模型收到不同的 seed 值，将生成不同的结果
  • 相同的请求下，模型收到相同的 seed 值，会生成类似的结果，但不保证完全一致
​
generate_audio
boolean
默认值:"false"
是否生成音频（有声视频）设置为 true 时，视频将包含 AI 生成的配套音频默认值：false
​
return_last_frame
boolean
默认值:"false"
是否返回尾帧图片设置为 true 时，任务结果中会额外返回视频最后一帧的图片 URL，可用于连续视频生成默认值：false
​
tools
array<object>
工具列表，用于联网搜索等增强能力示例：[{"type": "web_search"}]
​
image_urls
array<string>
图片 URL 数组，用于图生视频支持两种格式：
  • 普通图片 URL：https://example.com/cat.jpg
  • Asset URL（审核通过的素材）：asset://asset_a
示例：["https://example.com/cat.jpg"] 或 ["asset://asset_a"]
Asset URL 仅支持 doubao-seedance-2.0 和 doubao-seedance-2.0-fast 模型，其他模型不可使用
  • image_urls 和 image_with_roles 不能同时使用
  • 最多 9 张参考图
​
image_with_roles
array
带角色的图片数组，支持指定首帧/尾帧
url 字段使用 Asset URL 时，仅支持 doubao-seedance-2.0 和 doubao-seedance-2.0-fast 模型，其他模型不可使用
示例：
[
  {"url": "https://example.com/day.jpg", "role": "first_frame"},
  {"url": "https://example.com/night.jpg", "role": "last_frame"}
]
Asset URL 写法：
[
  {"url": "asset://asset_a", "role": "reference_image"}
]
  • image_urls 和 image_with_roles 不能同时使用
  • 使用首尾帧图片时，video_urls 和 audio_urls 不可用
​
video_urls
array<string>
参考视频 URL 数组支持两种格式：
  • 普通视频 URL：https://example.com/reference.mp4
  • Asset URL（审核通过的素材）：asset://asset_a
示例：["https://example.com/reference.mp4"] 或 ["asset://asset_a"]
Asset URL 仅支持 doubao-seedance-2.0 和 doubao-seedance-2.0-fast 模型，其他模型不可使用
  • 使用首帧/尾帧图片（image_with_roles）时，参考视频不可用
  • 最多 3 个参考视频，1.8s < 总时长 < 15.2s
  • 参考视频分辨率需要在 480P ~ 720P 之间
  • 参考视频不可出现真人
​
audio_urls
array<string>
参考音频 URL 数组支持两种格式：
  • 普通音频 URL：https://example.com/speech.wav
  • Asset URL（审核通过的素材）：asset://asset_a
示例：["https://example.com/speech.wav"] 或 ["asset://asset_a"]
Asset URL 仅支持 doubao-seedance-2.0 和 doubao-seedance-2.0-fast 模型，其他模型不可使用
  • 使用首帧/尾帧图片（image_with_roles）时，参考音频不可用
  • 最多 3 个参考音频，总时长 ≤ 15s
  • 参考音频需与参考图片或者参考视频使用

​
响应

​
code
integer
响应状态码，成功时为 200
​
data
array
返回数据数组

​
使用场景

​
场景 1：文生视频

{
  "model": "doubao-seedance-2.0",
  "prompt": "小猫对着镜头打哈欠",
  "resolution": "720p",
  "size": "16:9",
  "duration": 5,
  "seed": 42,
  "generate_audio": true
}

​
场景 2：图生视频（首帧）

{
  "model": "doubao-seedance-2.0",
  "prompt": "小猫站起来走向镜头",
  "image_urls": ["https://example.com/cat.jpg"],
  "duration": 5
}

​
场景 3：首尾帧视频

{
  "model": "doubao-seedance-2.0",
  "prompt": "从白天过渡到夜晚",
  "image_with_roles": [
    {"url": "https://example.com/day.jpg", "role": "first_frame"},
    {"url": "https://example.com/night.jpg", "role": "last_frame"}
  ],
  "duration": 5
}

​
场景 4：视频参考生视频

{
  "model": "doubao-seedance-2.0",
  "prompt": "将视频风格转换为动漫风格",
  "video_urls": ["https://example.com/reference.mp4"]
}

​
场景 5：参考视频 + 参考音频

{
  "model": "doubao-seedance-2.0",
  "prompt": "人物说话的场景",
  "video_urls": ["https://example.com/reference.mp4"],
  "audio_urls": ["https://example.com/speech.wav"],
  "size": "16:9",
  "duration": 11
}

​
场景 6：有声视频

{
  "model": "doubao-seedance-2.0",
  "prompt": "男人叫住女人说：\"你记住，以后不可以用手指指月亮。\"",
  "generate_audio": true
}

​
场景 7：连续视频生成（返回尾帧）

{
  "model": "doubao-seedance-2.0",
  "prompt": "小猫继续走向镜头",
  "image_urls": ["https://example.com/last_frame_from_prev.png"],
  "return_last_frame": true
}

​
场景 8：快速版生成

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "城市夜景延时摄影",
  "size": "21:9",
  "duration": 8
}

​
场景 9：参考图片 + 参考视频 + 参考音频（多模态视频）

结合参考图片、参考视频和参考音频，生成沉浸式第一人称视角广告视频。适用于产品宣传、品牌广告等需要多素材融合的场景。 
{
  "model": "doubao-seedance-2.0",
  "prompt": "全程使用视频1的第一视角构图，全程使用音频1作为背景音乐。第一人称视角果茶宣传广告，seedance牌「苹苹安安」苹果果茶限定款；首帧为图片1，你的手摘下一颗带晨露的阿克苏红苹果，轻脆的苹果碰撞声；2-4秒：快速切镜，你的手将苹果块投入雪克杯，加入冰块与茶底，用力摇晃，冰块碰撞声与摇晃声卡点轻快鼓点，背景音：「鲜切现摇」；4-6秒：第一人称成品特写，分层果茶倒入透明杯，你的手轻挤奶盖在顶部铺展，在杯身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹理；6-8秒：第一人称手持举杯，你将图片2中的果茶举到镜头前（模拟递到观众面前的视角），杯身标签清晰可见，背景音「来一口鲜爽」，尾帧定格为图片2。背景声音统一为女生音色。",
  "image_urls": [
    "https://example.com/tea_pic1.jpg",
    "https://example.com/tea_pic2.jpg"
  ],
  "video_urls": ["https://example.com/tea_video1.mp4"],
  "audio_urls": ["https://example.com/tea_audio1.mp3"],
  "generate_audio": true,
  "size": "16:9",
  "duration": 11
}

​
场景 10：使用 Asset URL 图生视频

审核通过的虚拟人像素材可直接作为参考图片传入，无需重新上传和审核。 
{
  "model": "doubao-seedance-2.0",
  "prompt": "人物在城市街道自然行走，阳光明媚",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

​
场景 11：使用 Asset URL 指定参考人像（image_with_roles）

{
  "model": "doubao-seedance-2.0",
  "prompt": "使用参考人像，人物优雅地走向镜头",
  "image_with_roles": [
    {
      "url": "asset://asset_a",
      "role": "reference_image"
    }
  ],
  "resolution": "720p",
  "duration": 5
}

​
场景 12：快速版 + Asset URL 图生视频

{
  "model": "doubao-seedance-2.0-fast",
  "prompt": "人物在公园里漫步，微风轻拂",
  "image_urls": ["asset://asset_a"],
  "duration": 5,
  "resolution": "720p"
}

​
场景 13：Asset URL 图片 + 参考视频（动作迁移）

将审核通过的人像素材与参考视频结合，驱动人物完成指定动作。 
{
  "model": "doubao-seedance-2.0",
  "prompt": "人物按照参考视频的节奏起舞，动作连贯自然",
  "image_urls": ["https://example.com/dance_reference.jpg", "asset://asset_a"],
  "video_urls": ["https://example.com/dance_reference.mp4", "asset://asset_a"],
  "duration": 8,
  "resolution": "720p"
}
查询任务结果视频生成为异步任务，提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。

​
与 1.5 Pro 版本的差异

特性1.5 Pro2.0 / 2.0 fast
分辨率480p/720p/1080p480p/720p
时长范围4-12秒5-15秒
默认时长5秒5秒
宽高比参数aspect_ratiosize（新增 adaptive 自适应）
音频生成audio 参数generate_audio 参数
参考视频不支持支持 video_urls
参考音频不支持支持 audio_urls
图生视频image_urls / image_with_rolesimage_urls / image_with_roles
有声视频不支持支持 generate_audio
连续视频不支持支持 return_last_frame
快速版不支持支持 doubao-seedance-2.0-fast