Video Generation Models
Video generation covering asynchronous tasks, parameters, polling, downloads, and production safety.
Video generation is typically a long-running asynchronous task: create a job, query its status, retrieve results, and save files before they expire.
Typical flow
Create task (prompt / first-frame image / reference images)
↓
Asynchronous generation (queued → running)
↓
Query task status
↓
Download the result and copy it to your own storageCreate a task
POST /v1/videos
/v1/videos/generations and /v1/video/generations are aliases of the same asynchronous submission handler.
{
"model": "<video-model-id>",
"prompt": "A futuristic city street after rain, with the camera moving slowly forward",
"duration": 5,
"aspect_ratio": "16:9",
"seed": 42
}Query and download with GET /v1/videos/{video_id} and GET /v1/videos/{video_id}/content.
Capability categories
| Capability | Description |
|---|---|
| Text-to-video | Generate a video from a prompt alone. |
| Image-to-video | Drive generation from a first-frame image. |
| Reference-to-video | Control subject and style with multiple reference images. |
| Video editing | Local replacement or style repainting on an existing video. |
Model selection criteria
Entries whose capabilities include video in the model catalog are available video models. Judge by these dimensions:
| Dimension | What to confirm |
|---|---|
| Supported operations | Text-to-video, image-to-video, reference-to-video, or video editing. |
| Duration tiers | Allowed duration range per clip and the corresponding billing. |
| Frame ratio | Supported landscape, portrait, and square ratios. |
| Resolution | 720p, 1080p, or higher tiers. |
| Task characteristics | Average queue time, task lifetime, and whether failures are billed. |
Model identifiers come from the model catalog; this page does not list a fixed set.
Query the current catalog
curl "${BASE_URL}/v1/public/models" \
-H "Authorization: Bearer ${APIQIK_API_KEY}"Entries whose capabilities include video are available video models. Resolution tiers and per-second prices come from the console model details.
Parameters
| Parameter | Purpose | Required details |
|---|---|---|
model | Select a video model. | Exact identifier and version policy. |
prompt | Describe subject, action, setting, camera, and style. | Maximum length and supported languages. |
image | Optional first frame or reference image. | Format, size, ratio, and URL or upload method. |
duration | Target duration. | Allowed values and impact on price and processing time. |
aspect_ratio | Frame ratio. | Supported landscape, portrait, and square ratios. |
seed | Control reproducibility. | Availability and whether the same seed guarantees identical output. |
Async states
A task passes through at least one of queued, running, succeeded, failed, and cancelled. Polling interval, task lifetime, result URL expiry, and whether failed tasks are billed depend on the model and channel.
Production considerations
- Poll with backoff rather than querying every task at high frequency.
- Result URLs may be temporary; save successful results to your own storage promptly.
- Validate content policy, copyright, likeness rights, and user consent before generation.
- Record task IDs for cancellation, tracing, recovery, and billing reconciliation.