Skip to main content
POST
TypeScript SDK

Authorizations

Authorization
string
header
required

Use an API key created in the NinjaChat developer console.

Headers

Idempotency-Key
string

Safely retry the same logical write without duplicate billing or execution.

Required string length: 1 - 255

Body

application/json
prompt
string
required
Required string length: 1 - 4000
model
enum<string>
default:veo-3.1-fast
Available options:
nova-reel,
runway-gen4.5,
flux-3-video,
minimax-h3,
hailuo-2.3,
hailuo-2.3-fast,
happyhorse-1.1,
ray-3.2,
seedance-2.5,
seedance-2,
seedance-2.0-fast,
seedance-2-mini,
seedance-2.0,
seedance-1.5-pro,
seedance-lite,
seedance-pro,
grok-imagine-video,
grok-imagine-video-1.5,
kling-2.5-turbo,
kling-3,
kling-3-pro,
kling-3-turbo,
kling-3-omni,
wan-2.7,
wan-2.7-i2v,
wan-2.7-r2v,
wan-2.6,
wan-2.6-i2v,
wan-2.2-t2v-a14b,
fast-wan-2.2,
fast-wan-qad,
pruna-p-video,
pixverse-6,
pixverse-6-i2v,
cosmos-3-nano,
cosmos-3-super,
vidu-q3,
veo-3.1,
veo-3.1-fast,
gemini-omni-flash,
kling-video,
google-veo-2,
google-veo-3-fast,
google-veo-3.1,
google-veo-3.1-fast,
google-veo,
seedance-2-video,
seedance-video
duration
integer
default:8
Required range: 3 <= x <= 15
aspect_ratio
enum<string>
default:16:9
Available options:
16:9,
9:16,
1:1
image_url
string<uri>
end_image_url
string<uri>
reference_images
string<uri>[]
Maximum array length: 4
reference_video
string<uri>
reference_audio
string<uri>
generate_audio
boolean
default:false
negative_prompt
string
watermark
boolean
default:false
video_id
string

Revise a finished clip in place instead of starting from scratch: the id returned by POST /videos. The prompt then describes the change (task edit, the default) or what happens next (task extend). Only gemini-omni-flash clips can be revised, and model must match the clip; leave model out to inherit it.

Pattern: ^vid_[A-Za-z0-9-]+$
task
enum<string>

With video_id: edit keeps the clip's length and changes its content; extend appends duration seconds (3–10) of new footage, up to 40 seconds total. Defaults to edit.

Available options:
edit,
extend

Response

Queued video job.

id
string
required
object
enum<string>
required
Available options:
video
status
enum<string>
required
Available options:
queued
model
string
required
Required string length: 1 - 160
cost_usd
number
required
Required range: x >= 0
request_id
string
required
cost
object
balance
string
metadata
object
message
string
trace_request_id
string

Original request receipt ID, also returned in X-Request-ID. Use id or request_id to poll the video job.