跳转到主要内容
POST
/
api
/
v1
/
task
/
submit
curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "veo3",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "海浪轻柔地涌动,太阳慢慢落下",
    "ratio": "16:9",
    "imageUrls": ["https://example.com/beach.jpg"]
  }
}'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
  }
}
使用 Google Veo 3.1 从图片创建视频。根据输入图片数量支持三种模式。

可用模型

veo3 · veo3_fast

生成模式

为单张图片添加动画作为首帧。视频从该图片开始并延展运动。
创建起始帧和结束帧之间的平滑过渡视频。
使用 1-3 张参考图片生成视频,可用于风格迁移或创意灵感。
模式选择:
  • 自动推断(默认):系统根据图片数量自动推断模式(0→t2v, 1→i2v, 2→i2v-fl, 3→r2v)
  • 显式指定:添加 mode 字段覆盖自动推断(例如:使用 1 张图片时指定 mode: "r2v" 作为风格参考而非首帧控制)
I2V vs R2V 的区别:
  • I2V:图片作为视频的首帧(严格的帧控制)
  • R2V:图片作为风格/内容参考(灵活的创意生成)
model
string
必填
模型名称,如 veo3veo3_fast
callBackUrl
string
Webhook 回调地址。
input
object
必填
curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "veo3",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "海浪轻柔地涌动,太阳慢慢落下",
    "ratio": "16:9",
    "imageUrls": ["https://example.com/beach.jpg"]
  }
}'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
  }
}

查询结果

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "status": "SUCCESS",
    "input": {
      "model": "veo3",
      "prompt": "海浪轻柔地涌动,太阳慢慢落下",
      "ratio": "16:9",
      "imageUrls": ["https://example.com/beach.jpg"]
    },
    "result": {
      "type": "video",
      "urls": [
        "https://example.com/output/video-b2c3d4e5.mp4"
      ]
    },
    "created_at": "2026-02-12T11:00:00.000000Z",
    "updated_at": "2026-02-12T11:02:45.000000Z"
  }
}
图片要求:
  • 格式:JPEG、PNG、WebP
  • 必须是公网可访问的 HTTPS 地址
  • 建议大小:单张图片 < 10MB
  • 宽高比应与 ratio 参数匹配
速度模式限制:
  • R2V 模式(3 张图片):不支持 Quality 质量模式。如果使用 veo3 模型,将自动回退到 Fast 模式。建议明确使用 veo3_fast