Video

Create video

POST
/videos

Create a video

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

Parameters for creating a new video generation job.

model*string

The model to be used for the video creation request.

prompt?string

Text prompt that describes the video to generate.

Length1 <= length <= 32000
height?integer
width?integer
resolution?string

Video resolution.

ratio?string

Aspect ratio of the video.

seconds?string

Clip duration in seconds.

fps?integer

Frames per second. Defaults to 24.

steps?integer

The number of denoising steps the model performs during video generation. More steps typically result in higher quality output but require longer processing time.

Range10 <= value <= 50
seed?integer

Seed to use in initializing the video generation. Using the same seed allows deterministic video generation. If not provided a random seed is generated for each request.

guidance_scale?integer

Controls how closely the video generation follows your prompt. Higher values make the model adhere more strictly to your text description, while lower values allow more creative freedom. guidence_scale affects both visual content and temporal consistency.Recommended range is 6.0-10.0 for most video models. Values above 12 may cause over-guidance artifacts or unnatural motion patterns.

output_format?VideoOutputFormat

Specifies the format of the output video. Defaults to MP4.

Value in

  • "MP4"
  • "WEBM"
output_quality?integer

Compression quality. Defaults to 20.

negative_prompt?string

Similar to prompt, but specifies what to avoid instead of what to include

generate_audio?boolean

Whether to generate audio for the video.

media?

Media inputs for video generation. The accepted fields depend on the model type (e.g. i2v, r2v, t2v, videoedit).

frame_images?array<>
Deprecated

Deprecated: use media.frame_images instead. Array of images to guide video generation, similar to keyframes.

reference_images?array<string>
Deprecated

Deprecated: use media.reference_images instead. Unlike frame_images which constrain specific timeline positions, reference images guide the general appearance that should appear consistently across the video.

Response Body

application/json

curl -X POST "https://example.com/videos" \  -H "Content-Type: application/json" \  -d '{    "model": "string"  }'
{  "id": "string",  "object": "video",  "model": "string",  "status": "in_progress",  "created_at": 0,  "completed_at": 0,  "size": "string",  "seconds": "string",  "error": {    "code": "string",    "message": "string"  },  "outputs": {    "cost": 0,    "video_url": "string"  }}