跳转到主要内容
POST
/
v1
/
videos
/
generate
curl --request POST \
  --url https://openapi.imini.ai/imini/router/v1/videos/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao/seedance-2.0",
  "prompt": "A slow pan across a misty mountain valley at sunrise, cinematic",
  "resolution": "720P",
  "aspect_ratio": "16:9",
  "duration": 5
}
'
{
  "task_id": "task_2044275355061448704",
  "model": "doubao/seedance-2.0",
  "created_at": "2026-04-15T04:43:20.233Z",
  "request_id": "67e2e394-cf6f-4998-b293-ebf20d14dc26"
}

授权

Authorization
string
header
必填

在请求 Header 中传入 Authorization: Bearer <YOUR_API_KEY>。前往 API Keys 管理页 创建和管理 API Key。

请求体

application/json
model
string
必填

固定值 doubao/seedance-2.0

prompt
string

提示词。支持中、英、日、印尼、西、葡语。

建议中文 ≤ 500 字,英文 ≤ 1000 词;字数过多可能导致模型忽略部分细节。

示例:

"全程第一人称视角,清晨手摘红苹果,雪克杯摇茶,镜头拉近分层果茶纹理"

resolution
enum<string>
默认值:720P

输出分辨率,默认 720P

可用选项:
480P,
720P
aspect_ratio
enum<string>
默认值:adaptive

输出宽高比,默认 adaptive(由模型按输入素材或提示词自动适配)。

可用选项:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9,
adaptive
duration
integer
默认值:5

视频时长(秒),默认 5,取值范围 4 ~ 15 的整数。

必填范围: 4 <= x <= 15
generate_audio
boolean
默认值:true

是否生成与画面同步的声音,默认 true。生成的有声视频为单声道。

reference_images
object[]

参考图列表,最多 9 张。按 reference_type 组合决定输入模式:

  • 图生视频-首帧:1 张 first_frame
  • 图生视频-首尾帧:1 张 first_frame + 1 张 last_frame
  • 多模态参考生视频:1~9 张 asset,可与 reference_videos / reference_audios 组合

图片要求:格式 jpeg / png / webp / bmp / tiff / gif;单张 ≤ 30 MB;请求体总计 ≤ 64 MB(大文件请勿使用 base64);宽高边长 300 ~ 6000 px;宽高比介于 1:2.5 ~ 2.5:1 之间。

Maximum array length: 9
reference_videos
object[]

参考视频列表,最多 3 段,所有视频总时长 ≤ 15 秒,仅支持公网 URL。

视频要求:格式 mp4 / mov;分辨率 480P / 720P;单段 2 ~ 15 秒、≤ 50 MB;宽高边长 300 ~ 6000 px;宽高比介于 1:2.5 ~ 2.5:1 之间;像素乘积范围 [640×640, 834×1112];FPS 24 ~ 60。

Maximum array length: 3
reference_audios
object[]

参考音频列表,最多 3 段,所有音频总时长 ≤ 15 秒。不可单独使用,必须至少伴随 1 个 reference_imagereference_video

音频要求:格式 wav / mp3;单段 2 ~ 15 秒、≤ 15 MB;请求体总计 ≤ 64 MB(大文件请勿使用 base64)。

Maximum array length: 3
extra_params
object

支持 Seedance 官方扩展参数,全部选填:

  • seed — 整数 [-1, 2^32-1]-1 或不传使用随机种子;相同 seed 下模型输出会接近但不保证完全一致。
  • watermark — 布尔,默认 false。是否在生成视频上添加水印。
  • return_last_frame — 布尔,默认 false。开启后可通过查询接口拿到生成视频的尾帧图(PNG,无水印,宽高与视频一致),可用于拼接多段连续视频。

响应

提交成功(异步模式)

task_id
string

任务唯一 ID,用于后续轮询查询

示例:

"task_2044275355061448704"

model
string

本次任务使用的模型 ID

示例:

"doubao/seedance-2.0"

created_at
string

任务创建时间(ISO 8601)

示例:

"2026-04-15T04:43:20.233Z"

request_id
string

请求唯一 ID

示例:

"67e2e394-cf6f-4998-b293-ebf20d14dc26"