Skip to main content

Gabrielle Veo 3.1 Fast

POST 
/open/aigw/gateway/generations

Request flow​

  1. Submit a video generation task and obtain taskNo
  2. When done, results are POSTed to callbackUrl
  3. You may also poll GET /open/aigw/gateway/generationTask?taskNo=xxx

Request​

Responses​

Task submitted successfully

Callback payload​

When generation completes, the system POSTs this payload to callbackUrl:

On success:

{
  "taskNo": "a1b2c3d4...",
  "status": "success",
  "model": "veo3.1-fast",
  "timestamp": 1234567890,
  "data": {
    "task_id": "6928de47-2e53-4ee6-901b-be05a8bf7669",
    "status": "SUCCESS",
    "request_id": "7d8d7f71a7314779b6947eed659085fa",
    "result": ["https://cdn.example.com/result_1.mp4"],
    "error_info": "",
    "traceback": ""
  },
  "usage": { "totalPoints": 10 },
  "sign": "sha256hex..."
}

On failure:

{
  "taskNo": "a1b2c3d4...",
  "status": "failed",
  "model": "veo3.1-fast",
  "timestamp": 1234567890,
  "error": "Error message",
  "sign": "sha256hex..."
}

Signature: sign = SHA256(taskNo + timestamp + apiKey)

Query task status​

GET /open/aigw/gateway/generationTask?taskNo={taskNo}

Prefer webhooks; this endpoint is a polling fallback.

Parameters:

ParameterTypeRequiredDescription
taskNostringYesTask ID returned when the task was submitted

Example success response:

{
  "code": 1000,
  "message": "success",
  "data": {
    "taskNo": "a1b2c3d4...",
    "model": "veo3.1-fast",
    "status": "success",
    "createTime": "2025-01-01 12:00:00",
    "data": { "result": ["https://cdn.example.com/result_1.mp4"] },
    "usage": { "totalPoints": 10 }
  }
}

Example failure response:

{
  "code": 1000,
  "message": "success",
  "data": {
    "taskNo": "a1b2c3d4...",
    "model": "veo3.1-fast",
    "status": "failed",
    "error": "Reason generation failed"
  }
}

status values: pending, processing, success, failed