Endpoint
Request Examples
Response
Task Submission Response
Task Completion Response
Task Status Values
| Status | Description |
|---|---|
pending | Task is queued and waiting to start |
processing | Video is being generated |
completed | Video is ready for download |
failed | Generation failed (see error field) |
Webhook Notifications
Instead of polling, you can provide a webhook URL to receive a notification when the video is ready:POST payload is the same as the task completion response above.
Request Parameters
The model ID to use. Options:
sora, runway-gen3, kling-1.5, pika-1.5.A text description of the desired video. Be descriptive for best results — include subject, action, environment, camera angle, and style.
Video duration in seconds. Range depends on the model (typically 3-15 seconds). Default:
5.Output resolution. Options:
720p, 1080p. Default: 1080p. Not all models support all resolutions.Aspect ratio. Options:
16:9, 9:16, 1:1. Default: 16:9.A URL to receive a POST request when the video generation is complete. Use this instead of polling.
Supported Models
| Model | Provider | Max Duration | Resolutions | Features |
|---|---|---|---|---|
| Sora | OpenAI | 15s | 720p, 1080p | Photorealistic, text-to-video |
| Runway Gen-3 | Runway | 10s | 720p, 1080p | Image-to-video, style control |
| Kling 1.5 | Kuaishou | 10s | 720p, 1080p | Fast generation, good motion |
| Pika 1.5 | Pika Labs | 5s | 720p, 1080p | Stylized output, lip sync |
View All Models
See the complete list