curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "pixverse/v6-max/image-to-video",
"input": {
"image_urls": [
"https://example.com/packshot.png"
],
"prompt": "The perfume bottle rotates slowly as petals fall around it, soft studio light",
"duration": 5,
"resolution": "720p",
"audio": false
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1762160000-abc123",
"status": "not_started",
"created_time": "2026-11-03T10:30:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}PixVerse
PixVerse V6 Max 图生视频
PixVerse V6 Max 图生视频 API 将一张 JPEG、PNG 或 WebP 图片生成 1–15 秒、360p 到 1080p 的视频，并保持图片的构图。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "pixverse/v6-max/image-to-video",
"input": {
"image_urls": [
"https://example.com/packshot.png"
],
"prompt": "The perfume bottle rotates slowly as petals fall around it, soft studio light",
"duration": 5,
"resolution": "720p",
"audio": false
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1762160000-abc123",
"status": "not_started",
"created_time": "2026-11-03T10:30:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Request timeout{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- 提交后会返回
task_id。如果提供了callback_url，当任务状态变为finished或failed时，系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url，都可以通过统一的查询任务状态接口获取结果。
audio: true 可添加原生音轨。适合用产品图制作产品动画、社交短片和音乐视频片段。
PixVerse V6 Max 是 PixVerse V6 的 Max 档位，于 2026 年 10 月加入 PixVerse API，支持文生视频和图生视频。Vidgo 提供两个 model ID：文生视频和图生视频。
模型
- pixverse/v6-max/image-to-video — PixVerse V6 Max 图生视频，使用一张图片，1–15 秒，360p 到 1080p，可选音频。
功能
- 以一张起始图片图生视频。
- 可选提示词，用于指导运动和镜头运动。
- 时长 1 到 15 秒，以 1 秒为步长。
- 四种分辨率：
360p、540p、720p和1080p。 - 设置
audio: true可添加原生音轨。 - 宽高比跟随输入图片。
必填参数
image_urls（string[]）：恰好一个公开 HTTP(S) 图片 URL（JPEG、PNG 或 WebP）。如果 URL 带文件扩展名，必须是.jpg、.jpeg、.png或.webp。
可选参数
prompt（string）：哪些元素运动、镜头如何运动，开启audio时还可描述声音。传入时不能为空白，最多 2,048 个字符。duration（integer）：输出时长，1–15整秒。默认5。resolution（string）：360p、540p、720p或1080p。默认540p。audio（boolean）：添加原生音轨。默认false。
输出
任务完成后，查询任务状态和回调内容的files 数组中会返回一个 MP4 视频。
示例
- 5 秒 720p 产品动画：一张产品图配简短的运动提示词，无声。
- 8 秒 1080p 带音频短片，带回调：一张演出照片，
audio: true，并提供callback_url。
注意事项
- 本 ID 不接受
aspect_ratio（由图片决定），传入会返回 400，上文未列出的其他字段同样如此。需要纯提示词并指定宽高比时，请用 PixVerse V6 Max 文生视频。 - 这里的提示词上限为 2,048 个字符，低于文生视频的 5,000 个字符。
- Vidgo 上的 PixVerse V6 Max 只接受文本或恰好一张图片，不支持首尾帧、视频输入、扩展、参考生视频和
seed。 duration、resolution或audio传null时视为默认值。model和callback_url放在请求根级，不要放进input。- 积分在提交时预扣，按
resolution、audio和duration（每输出秒）计算，开启audio会提高费率。任务失败会全额退还。当前费率见定价页。
授权
所有 API 接口都需要 Bearer Token 认证
获取 API Key：
进入 仪表盘 → API 密钥（API Key 管理页面）获取你的 API Key
在请求头中添加：
Authorization: Bearer VIDGO_API_KEY
请求体
application/json