Skip to navigation
REST API ReferenceEndpointsModels

Start Model 1 generation

Generate an MP4 with Model 1. Returns immediately; poll the generation endpoint for completion. Uses separate Model 1 team quota, not generation credits. Every admitted attempt holds an hourly slot and reserves its duration; failed attempts retain both under the existing recovery policy. Reuse the same Idempotency-Key after a network timeout.

Authentication

AuthorizationBearer

API key from app.videogen.io/api. The full key is only shown once when you create it.

Headers

Idempotency-KeystringRequired16-100 characters

A unique key per intended generation. Identical retries return the same generation; conflicting inputs return 409.

Request

This endpoint expects an object.
promptstringRequiredformat: "\S"1-20000 characters
secondsintegerOptional4-600Defaults to 10
imageFileIdslist of stringsOptionalDefaults to []

Ordered reference images: up to 9 distinct file ids, each fully uploaded and accessible. References guide generation; they do not guarantee an opening frame. Output settings follow current Model 1 defaults.

Response headers

LocationstringOptional
Relative URL of the generation status endpoint.

Response

Generation admitted, or an identical submission replayed.
generationIdstring

Opaque generation id (vg_mgen_…). Store as-is.

Errors

429
Too Many Requests Error