跳转到主要内容
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 - 快速版，功能与标准版一致，生成速度更快
​
prompt
string
视频内容描述文生视频时必填，图生视频/视频参考生视频时可选建议明确主体、动作、镜头和风格，以获得更好的生成效果示例："小猫对着镜头打哈欠"
​
duration
integer
默认值:"5"
视频时长（秒）支持范围：5 ~ 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 - 高清
默认值：480p
​
seed
integer
随机种子，用于控制生成内容的随机性
  • 相同的请求下，模型收到不同的 seed 值，将生成不同的结果
  • 相同的请求下，模型收到相同的 seed 值，会生成类似的结果，但不保证完全一致
​
camera_fixed
boolean
默认值:"false"
是否固定镜头设置为 true 时，摄像机位置保持固定默认值：false
​
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 数组，用于图生视频示例：["https://example.com/cat.jpg"]
  • image_urls 和 image_with_roles 不能同时使用
  • 最多 9 张参考图
​
image_with_roles
array
带角色的图片数组，支持指定首帧/尾帧示例：
[
  {"url": "https://example.com/day.jpg", "role": "first_frame"},
  {"url": "https://example.com/night.jpg", "role": "last_frame"}
]
  • image_urls 和 image_with_roles 不能同时使用
  • 使用首尾帧图片时，video_urls 和 audio_urls 不可用
​
video_urls
array<string>
参考视频 URL 数组需要可公网访问的视频 URL示例：["https://example.com/reference.mp4"]
  • 使用首帧/尾帧图片（image_with_roles）时，参考视频不可用
  • 最多 3 个参考视频，总时长 ≤ 15s
  • 参考视频分辨率需要在 480P ~ 720P 之间
​
audio_urls
array<string>
参考音频 URL 数组需要可公网访问的音频 URL示例：["https://example.com/speech.wav"]
  • 使用首帧/尾帧图片（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
}
查询任务结果视频生成为异步任务，提交后会返回 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