Skip to main content
When the 4K video generation task completes, the system will notify you of the results through callback mechanism.

​
Callback Configuration

Configure the callback URL when requesting 4K video generation: 
{
  "taskId": "veo_task_abcdef123456",
  "index": 0,
  "callBackUrl": "https://your-domain.com/api/4k-callback"
}

​
Callback Format

When 4K video generation completes, the system will send a POST request to your configured callback URL with the following format: 
{
  "code": 200,
  "msg": "Video generated successfully.",
  "data": {
    "taskId": "6060e30319dbb51ce35a43bd9312f476",
    "fallbackFlag": false,
    "info": {
      "resultUrls": [
        "https://tempfile.aiquickdraw.com/v/6060e30319dbb51ce35a43bd9312f476_1768391941.mp4"
      ],
    }
  }
}

​
Callback Field Descriptions

FieldTypeDescription
codeintegerStatus code, 200 indicates success, 500 indicates failure
msgstringStatus message, success shows “Success”, failure shows error message
dataobject | nullTask result data when successful, null when failed
data.taskIdstringTask ID
data.resultUrlsarrayGenerated 4K video URL array
data.mediaIdsarrayMedia ID array
data.imageUrlsarrayRelated image URL array

​
Callback Handling

1

Verify Callback

Check the code field to confirm generation success
2

Extract Results

Retrieve the generated 4K video download address from data.result_urls
3

Process Media

Use mediaIds for media management and tracking
4

Respond to Callback

Your server should return a 200 status code to confirm callback receipt

​
Error Handling

If errors occur during 4K video generation, the callback will return an error status code with the corresponding error message. Currently supported error cases include:
  • 500: 4K version unavailable - “The 4K version of this video is unavailable. Please try a different video.”
Ensure your callback endpoint can handle duplicate callbacks to avoid processing the same task multiple times.

​
Best Practices

​
4K Video Generation Callback Handling Recommendations

  1. Timely Download: 4K video files are large and URLs may have validity period limitations, please download and save promptly
  2. Idempotent Processing: The same task may receive multiple callbacks, ensure processing logic is idempotent
  3. Error Retry: If you receive a 4K unavailable error, you can try using a different video or contact technical support
  4. Media Management: Use the returned mediaIds for media file management and tracking
  5. Storage Planning: 4K video files are typically very large, ensure sufficient storage space

​
Alternative Solutions

If you cannot use the callback mechanism, you can also use polling:

Poll Query Results

Use the Get Video Details endpoint to periodically query 4K video generation task status.