Skip to main content
Video generation is asynchronous. Submit a job, poll its Planck job ID until it completes, and then download an output.
1

Submit a generation

Copy the exact model ID from the model registry. The selected model determines which durations, resolutions, aspect ratios, image inputs, and audio options are accepted.
The gateway returns 202 Accepted with an id, status, and polling_url.
In this example, openrouter/alibaba/wan-2.6 is the model ID. Requests still go to the Planck endpoint with your Planck API key; there is no separate OpenRouter integration step.
2

Poll the job

Continue until status is completed or failed. A completed response includes an outputs array.
3

Download an output

For jobs with multiple outputs, select one with ?index=0.

​
Request Validation

Video capabilities are model-specific. Unsupported fields and invalid combinations are rejected before a job is created. For example, use duration rather than seconds, and use either size or resolution plus aspect_ratio.

​
Billing and Tracking

Planck-paid video requests reserve funds before submission and reconcile the generation as its durable job progresses. Requests include Planck-Operation: video_generation, the Planck generation ID, submission status, model, and billing state. Some models remain BYOK-only when their usage cannot be priced exactly before submission. Polling and downloads require a valid Planck API key for the submitting organization. See the Video Generation API reference for the lifecycle and response fields.