跳转到主要内容
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"
视频时长(秒)范围:116默认值: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。使用 获取任务状态 接口查询生成进度和结果。