Video generation

This is what $1.20 buys — generated through this endpoint’s models:

Image-to-video: a still keyframe animated into a spot. Failed jobs refund automatically.

Video is async: submit a job, then poll its status — or register a signed webhook in Developers → Webhooks and skip the loop. Either way you get an MP4 URL in one to a few minutes.

The whole flow, copy-paste ready

import { NinjaChat } from "@ninjachat/sdk";

const client = new NinjaChat({ apiKey: process.env.NINJACHAT_API_KEY! });
const job = await client.videos.generate({
  model: "veo-3.1-fast",
  prompt: "A timelapse of a flower blooming, macro lens, soft lighting",
  duration: 6,
  aspect_ratio: "16:9",
});

const video = await client.videos.waitFor(job.id);
console.log(video.video_url);

import os
from ninjachat import NinjaChat

client = NinjaChat(api_key=os.environ["NINJACHAT_API_KEY"])
job = client.videos.generate(
    model="veo-3.1-fast",
    prompt="A timelapse of a flower blooming, macro lens, soft lighting",
    duration=6,
    aspect_ratio="16:9",
)

video = client.videos.wait_for(job["id"])
print(video["video_url"])

Parameters

Parameter	Default	Description
`prompt`	required	Camera movement + subject action + style + lighting. Max 4,000 chars.
`model`	`veo-3.1-fast`	See table below.
`duration`	`8`	Integer seconds, 4–15. Values a given model supports within that range depend on the model.
`aspect_ratio`	`16:9`	`16:9` or `9:16` (ignored by Seedance 2).
`image_url`	—	Animate this still (public HTTPS) — that’s how the film above was made.
`end_image_url`	—	Public HTTPS still to end on, for models that support first-and-last-frame generation.
`reference_images`	—	Up to 4 public HTTPS image URLs to guide subject/style (Seedance 2 only).
`reference_video`	—	Public HTTPS video URL to guide motion/POV framing (Seedance 2 only).
`reference_audio`	—	Public HTTPS audio URL to use as background music (Seedance 2 only).
`generate_audio`	`false`	Generate an audio track for the video (Seedance 2 only).
`watermark`	`false`	Overlay a watermark on the output (Seedance 2 only).

Polling GET /videos/{id} is free and unlimited. Status moves queued → processing (with progress) → completed (with video_url) or failed (auto-refunded).

Which model?

Prices are pricing.perUnitUsd per job from GET /models at the time of writing. Every servable video model:

Model	ID	Cost	Best for
Google Veo 2	`google-veo-2`	$4.00	Legacy Veo workloads
Seedance 2	`seedance-2`	$3.64	Longest clips, reference images/video/audio
Veo 3.1	`veo-3.1`	$3.20	Best quality
Seedance Pro	`seedance-pro`	$1.80	Seedance’s pro tier
Kling Video	`kling-video`	$1.40	Motion coherence
Veo 3.1 Fast	`veo-3.1-fast`	$1.20	The default — speed + quality
Google Veo 3 Fast	`google-veo-3-fast`	$1.20	Budget Veo
Runway Gen-4.5	`runway-gen4.5`	$1.20	Runway at the Veo Fast price point
Grok Imagine Video 1.5	`grok-imagine-video-1.5`	$1.20	xAI’s newer video model
Grok Imagine Video	`grok-imagine-video`	$0.75	xAI’s budget video model
Seedance 2.0 Fast	`seedance-2.0-fast`	$0.63	Promotional price (list $0.84, 25% off through 2026-09-08)
Seedance Lite	`seedance-lite`	$0.43	Cheapest non-promotional clip
Seedance 2 Mini	`seedance-2-mini`	$0.42	Promotional price (list $1.06, 60% off through 2026-09-08)

Promotional prices come from pricing.promotion on the model record; pricing.listPerUnitUsd is what the model returns to when the promotion ends.

Prompting for motion

Weak	Strong
`mountains`	`Drone shot slowly ascending over a misty mountain valley at golden hour, camera reveals a river below, cinematic`
`ocean`	`Underwater camera glides through a coral reef, bioluminescent creatures pulse with light, slow motion, documentary`

The formula: camera movement + subject action + style + lighting.

Agents can run this whole flow conversationally — “animate the second one” — via the MCP server.

Get Started

Chat

Routing & scale

Orchestration

Production

Media & search

Reference

The whole flow, copy-paste ready

Parameters

Which model?

Prompting for motion

​The whole flow, copy-paste ready

​Parameters

​Which model?

​Prompting for motion

The whole flow, copy-paste ready

Parameters

Which model?

Prompting for motion