Video generation create

post

https://api.macpaw.com/v2/videos

Creates a video generation job. The model decides which optional fields apply; the provider validates them.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

model

string

required

Video model id in provider/model format.

prompt

string

Text that describes the video. Whether it may be omitted (e.g. for image-only generation) is decided by the provider.

aspect_ratio

string

enum

resolution

string

enum

duration

integer

≥ 1

Video length in seconds.

size

string

Exact dimensions as WIDTHxHEIGHT, as an alternative to resolution + aspect_ratio.

seed

integer

Seed for deterministic sampling.

generate_audio

boolean

Whether to generate accompanying audio.

frame_images

array of objects

Images pinned to the first and/or last frame.

frame_images

input_references

array of objects

Reference media that guides generation. Audio and video references are honored only by compatible models.

input_references

previous_job_id

string

^gen-vid-\d+-[0-9A-Za-z]{20}$

Id of a completed job to edit or extend.

creativity

integer

Upscaling models only.

upscale_factor

number

Upscaling models only. Must be greater than 0.

provider

object

Provider-specific options keyed by provider (e.g. google-vertex, openai). Unrecognized keys are dropped.

Responses

200Video job created. Usually pending; see status.

400Invalid JSON, a missing or malformed model, or parameters the provider rejected (its message is in message).

401Unauthorized - Missing or invalid authentication token

402Insufficient credits

403Forbidden — the model is not supported.