跳转到主要内容
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"]
  }
}'

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",
    "resolution": "1080p",
    "imageUrls": [
      "https://example.com/day.jpg",
      "https://example.com/night.jpg"
    ]
  }
}'

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",
    "mode": "r2v",
    "resolution": "1080p",
    "imageUrls": ["https://example.com/reference.jpg"]
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
  }
}
使用 Google Veo 3.1 从图片创建视频。根据输入图片数量支持三种模式。

​
可用模型

veo3 · veo3_fast · veo3_lite

​
生成模式

为单张图片添加动画作为首帧。视频从该图片开始并延展运动。
创建起始帧和结束帧之间的平滑过渡视频。
使用 1-3 张参考图片生成视频，可用于风格迁移或创意灵感。
模式选择：
  • 自动推断（默认）：系统根据图片数量自动推断模式（0→t2v, 1→i2v, 2→i2v-fl, 3→r2v）
  • 显式指定：添加 mode 字段覆盖自动推断（例如：使用 1 张图片时指定 mode: "r2v" 作为风格参考而非首帧控制）
I2V vs R2V 的区别：
  • I2V：图片作为视频的首帧（严格的帧控制）
  • R2V：图片作为风格/内容参考（灵活的创意生成）
​
model
string
必填
模型名称，如 veo3、veo3_fast、veo3_lite。
​
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"]
  }
}'

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",
    "resolution": "1080p",
    "imageUrls": [
      "https://example.com/day.jpg",
      "https://example.com/night.jpg"
    ]
  }
}'

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",
    "mode": "r2v",
    "resolution": "1080p",
    "imageUrls": ["https://example.com/reference.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。
  • Lite 模式（veo3_lite）：仅支持 I2V（单图，固定 720p）和 I2V-FL（首尾帧）。不支持 R2V — 传 3 张图片会直接报错。resolution 参数会被忽略。