Skip to main content
POST
Video Generation
Video generation is always asynchronous. You’ll receive a generation ID immediately, then poll for the result. Processing typically takes 20–180 seconds depending on the model.

Request

string
required
Authorization: Bearer nb_YOUR_API_KEY
string
required
Video model slug. See Video Models.
string
required
Text description of the video to generate.
string
Starting image URL for image-to-video generation. When provided, the video animates from this image.
integer
default:"5"
Video duration in seconds. Supported values: 5 or 10 (model-dependent).
string
default:"16:9"
Output aspect ratio: 16:9, 9:16, 1:1
string
Elements to avoid in the video.

Request Example

Initial Response (Pending)

Completed Response

Model Comparison

Token cost depends on duration and resolution. Use Calculate Price for exact cost.