Generate Video — AI video from text or images

Tools / Generate Video

Text to Video

Generate a video from a text prompt. 10+ models with different quality, speed, and cost tradeoffs. Returns a downloadable video URL.

Returns: Video download URL, model used, duration, resolution, audio status, generation cost, and request metadata

Parameters

prompt *stringDetailed text description of the video to generate. Be specific about scene, action, camera movement, lighting, and style.

modelstringModel to use. Use list_models for available models with pricing and audio support. Omit for default.

durationnumberVideo duration in seconds. Available durations depend on the model. Common options: 4, 5, 6, 8, 10.

resolutionstringOutput video resolution. Available resolutions depend on the model. Defaults to the model default (usually 1080p).

enable_audiobooleanGenerate audio with video. Audio-capable models only — roughly doubles cost. See list_models for support.

seednumberRandom seed for reproducible generation. Same seed + same prompt should produce similar results.

aspect_ratiostringAspect ratio for the generated video. Not all models support all ratios.

negative_promptstringThings to avoid in the generated video (e.g. "blurry, low quality, distorted"). Not supported by all models.

Example

Generate a cinematic nature video

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "generate-video",
  "skill": "text_to_video",
  "input": {
    "prompt": "A serene mountain lake at sunrise with mist rolling over the water, cinematic drone shot slowly pulling back to reveal snow-capped peaks"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Image to Video

Animate a still image into a video. Provide an image URL and optional motion prompt. 9 models with different quality and cost tradeoffs.

Returns: Video download URL, source image URL, model used, duration, resolution, audio status, generation cost, and request metadata

Parameters

image_url *stringURL of the source image to animate. Must be a publicly accessible image URL (JPEG, PNG, WebP).

promptstringOptional text prompt to guide the animation direction and style (e.g. "the person starts walking towards the camera").

modelstringModel to use. Use list_models for available models with pricing and audio support. Omit for default.

durationnumberVideo duration in seconds. Available durations depend on the model. Common options: 4, 5, 6, 8, 10.

resolutionstringOutput video resolution. Available resolutions depend on the model. Defaults to the model default (usually 1080p).

enable_audiobooleanGenerate audio with video. Audio-capable models only — roughly doubles cost. See list_models for support.

seednumberRandom seed for reproducible generation. Same seed + same prompt should produce similar results.

aspect_ratiostringAspect ratio for the generated video. Not all models support all ratios.

negative_promptstringThings to avoid in the generated video (e.g. "blurry, low quality, distorted"). Not supported by all models.

Example

Animate a product photo

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "generate-video",
  "skill": "image_to_video",
  "input": {
    "image_url": "https://placehold.co/800x600.png",
    "prompt": "The product slowly rotates on a white pedestal with soft studio lighting"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

List Models

List available video generation models with capabilities, pricing, durations, resolutions, and audio support. Filter by type.

Returns: Array of model objects with key, display name, capabilities, pricing, durations, resolutions, and audio support

Parameters

typestringFilter models by generation type. Omit to show all models.

Example

List all available video generation models

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "generate-video",
  "skill": "list_models",
  "input": {}
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"generate-video","skill":"text_to_video","input":{}}' \
  https://api.toolrouter.com/v1/tools/call