跳转到主要内容
POST
https://api.apimart.ai
/
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": "viduq3-pro",
    "prompt": "一只猫在弹钢琴，镜头缓缓拉近",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

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

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "viduq3-pro",
    "prompt": "一只猫在弹钢琴，镜头缓缓拉近",
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

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

​
认证

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

​
请求参数

​
model
string
必填
视频生成模型名称支持的模型：
  • viduq3-pro - Vidu Q3 Pro（推荐）
​
prompt
string
必填
文本描述，最长 2000 个字符文生视频时必填，图生视频和首尾帧模式下可选。示例："一只猫在弹钢琴，镜头缓缓拉近"
​
duration
integer
默认值:"5"
视频时长（秒）范围：1 到 16默认值：5
​
resolution
string
默认值:"720p"
视频分辨率可选值：
  • 540p - 标清
  • 720p - 高清（默认）
  • 1080p - 全高清
默认值：720p
​
aspect_ratio
string
视频宽高比（仅文生视频模式可用）可选值：
  • 16:9 - 横屏
  • 9:16 - 竖屏
  • 4:3 - 传统比例
  • 3:4 - 竖版传统比例
  • 1:1 - 方形
此参数仅在文生视频模式下可用（不传 image_urls 时）。
​
image_urls
array<url>
图片 URL 数组，用于图生视频系统根据图片数量自动判断生成模式：
  • 0 张（不传）：文生视频模式
  • 1 张：图生视频模式（以该图为起始画面）
  • 2 张：首尾帧生视频模式（第一张=首帧，第二张=尾帧）
示例：["https://example.com/photo.jpg"]
  • 最多支持 2 张图片
  • 首尾帧模式必须传恰好 2 张图片
  • 只要传入 image_urls（无论 1 张还是 2 张），就不能同时设置 aspect_ratio 参数，视频比例将由图片自动决定
​
audio
boolean
默认值:"true"
是否生成音频（对白、音效）默认值：true如需静音视频，设置为 false。
​
seed
integer
随机种子，用于复现结果相同种子配合相同参数可生成相同的视频结果。

​
自动路由规则

系统根据 image_urls 的图片数量自动判断生成模式：
图片数模式说明
0 张（不传）文生视频纯文本描述生成
1 张图生视频以该图为起始画面
2 张首尾帧生视频第一张=首帧，第二张=尾帧

​
参数支持矩阵

参数文生视频图生视频首尾帧
model✅ 必填✅ 必填✅ 必填
prompt✅ 必填选填选填
image_urls-✅ 1张✅ 2张
duration✅ 1-16秒✅ 1-16秒✅ 1-16秒
resolution✅✅✅
aspect_ratio✅--
audio✅✅✅
seed✅✅✅

​
响应

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

​
使用场景

​
场景 1：文生视频

{
  "model": "viduq3-pro",
  "prompt": "一只猫在弹钢琴，镜头缓缓拉近",
  "duration": 8,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

​
场景 2：图生视频（单张图片）

{
  "model": "viduq3-pro",
  "prompt": "人物缓缓转身微笑",
  "image_urls": ["https://example.com/photo.jpg"],
  "duration": 5,
  "resolution": "720p"
}

​
场景 3：首尾帧生视频

{
  "model": "viduq3-pro",
  "prompt": "人物从站立缓缓坐下",
  "image_urls": [
    "https://example.com/first.jpg",
    "https://example.com/last.jpg"
  ],
  "duration": 8
}

​
场景 4：关闭音频（静音视频）

{
  "model": "viduq3-pro",
  "prompt": "日落海景延时摄影",
  "duration": 10,
  "resolution": "1080p",
  "audio": false
}
查询任务结果视频生成为异步任务，提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。