跳转到主要内容
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",
    "resolution": "1080p"
  }
}'

curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "veo3_fast",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "黄金时刻，海浪拍打着岩石海岸",
    "ratio": "9:16",
    "resolution": "1080p"
  }
}'

curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "veo3_lite",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "黄金时刻，海浪拍打着岩石海岸",
    "ratio": "16:9"
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}
使用 Google Veo 3.1 从文本描述生成高质量视频。支持多种速度模式。

​
可用模型

veo3 · veo3_fast · veo3_lite

​
速度模式

最佳生成质量。推荐大多数场景使用。
速度优先。适合对时效性要求高的场景。
轻量版本，固定 720p 输出。单价最低，适合草稿和大批量生成。不支持 4K/1080p 放大 — 传 resolution 会被自动忽略。
​
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",
    "resolution": "1080p"
  }
}'

curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "veo3_fast",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "黄金时刻，海浪拍打着岩石海岸",
    "ratio": "9:16",
    "resolution": "1080p"
  }
}'

curl --request POST \
  --url https://api.maxapi.io/api/v1/task/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "veo3_lite",
  "callBackUrl": "https://example.com/webhook",
  "input": {
    "prompt": "黄金时刻，海浪拍打着岩石海岸",
    "ratio": "16:9"
  }
}'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

​
查询结果

通过查询任务接口或 Webhook 获取生成结果： 
{
  "code": 0,
  "msg": "ok",
  "data": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "SUCCESS",
    "input": {
      "model": "veo3",
      "prompt": "黄金时刻，海浪拍打着岩石海岸",
      "ratio": "16:9",
      "resolution": "1080p"
    },
    "result": {
      "type": "video",
      "urls": [
        "https://example.com/output/video-a1b2c3d4.mp4"
      ]
    },
    "created_at": "2026-02-12T10:00:00.000000Z",
    "updated_at": "2026-02-12T10:02:30.000000Z"
  }
}
Veo 3 每次生成返回 1 个视频。视频时长通常为 5-8 秒。无需指定 mode 参数 — 系统会根据图片数量自动识别生成模式。