Video Generation
Async AI video generation with task tracking.
Overview
Video generation is an asynchronous process. Unlike chat and image generation, results are not immediately available.
Endpoints
| Endpoint | Method | Description |
|---|---|---|
/api/video/generate | POST | Submit generation request |
/api/video/status | GET | Check task status |
Async Workflow
- Submit — User sends prompt to
/api/video/generate - Task Created — Volcano Engine returns a
taskId - Poll — Client polls
/api/video/status?taskId=xxx - Complete — When status is
completed,resultUrlcontains the video
Request
{
"prompt": "A cat playing piano",
"referenceImage": "optional-base64-or-url"
}Supports both text-to-video and image-to-video modes.
Credit Cost
- 50 credits per video generation
- Credits are deducted at submission, refunded if the task fails
Task States
| Status | Description |
|---|---|
pending | Task submitted, waiting to start |
processing | Generation in progress |
completed | Video ready at resultUrl |
failed | Generation failed, credits refunded |