Pika modelsvideo generation api

pika/v2.2/scenes

Name: Pika V2.2 Scenes
Author: Pika

V2.2 Scenes is Pika's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output.

Input

Prompt(string)

Text prompt describing the desired video

Image URL or upload(array)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

URLs of images to combine into a video

Resolution(string)

The resolution of the generated video Allowed values: 720p, 1080p.

Duration(integer)

The duration of the generated video in seconds Allowed values: 5, 10.

Ingredients Mode(string)

Mode for integrating multiple images. Precise mode is more accurate, creative mode is more creative. Allowed values: precise, creative.

Aspect Ratio(string)

The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.

Seed(integer)

The seed for the random number generator

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDpika/v2.2/scenes

Input Schema

7 parameters · 1 required · 6 optional

Parameter	Type	Required	Description
`prompt`	string	Required	Text prompt describing the desired video
`seed`	integer	Optional	The seed for the random number generator
`images`	string[]	Optional	URLs of images to combine into a video
`duration`	integer	Optional	The duration of the generated video in seconds · Options: 5, 10 · Default: 5 510
`resolution`	string	Optional	The resolution of the generated video · Options: 720p, 1080p · Default: "1080p" 720p1080p
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`ingredients_mode`	string	Optional	Mode for integrating multiple images. Precise mode is more accurate, creative mode is more creative. · Options: precise, creative · Default: "precise" precisecreative

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "pika/v2.2/scenes",
  "images": [
    "https://static.sandbase.ai/examples/pika/v2.2/scenes/input_images_0.png",
    "https://static.sandbase.ai/examples/pika/v2.2/scenes/input_images_1.png",
    "https://static.sandbase.ai/examples/pika/v2.2/scenes/input_images_2.png"
  ],
  "prompt": "The gorilla is wearing the coat and sitting in the living room, cinematic scene, camera orbit and dolly out",
  "duration": 5,
  "resolution": "1080p",
  "ingredients_mode": "precise"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Pika V2.2 Scenes

API README

Pika Scenes

Pika Scenes is the Pika route for multi-scene video composition, turning scene-level source material into a production-ready result while keeping the operation distinct from neighboring endpoints. V2.2 Scenes is Pika's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output. The workflow is designed for creators who need the model’s specific transformation to remain visible in the request, so the source, intended change, and finished artifact can be reviewed as one coherent creative decision.

In practical use, this route exposes seed, prompt, duration, sync_mode, image_urls, resolution, aspect_ratio, negative_prompt to shape the exact deliverable. Those controls let a team preserve the important source constraints, state subject behavior or material treatment precisely, choose supported timing or output characteristics, and reproduce successful settings across alternate takes. The result fits an iterative pipeline: establish the core brief, compare controlled variations, then pass the selected asset into editorial, design, localization, visualization, or publishing work.

Highlights

Scene-level composition. Build a connected result from the supplied scene materials while preserving the intended narrative order.
Prompt-directed motion. Describe subject action and camera behavior while the route keeps the selected source workflow intact.
Short-form iteration. Produce concise clips suited to rapid creative review and alternate takes.
Delivery control. Use the route’s documented timing, resolution, seed, or transition controls to shape the final result.

Pricing

Configuration	Price
Per request	`$0.200000`

When to Use

Scenario	Why it fits
Exact workflow fit	Choose this route when the required deliverable is multi-scene video composition, rather than a related route with different source media.
Directed creative iteration	Use it when subject, motion, material, speech, framing, or finish should be expressed explicitly and compared across controlled variants.
Existing-asset continuity	Use it when supplied images, video, audio, references, or styles must remain the anchor for the generated result.
Repeatable production	Use it when successful inputs need to be saved and rerun across a campaign, asset set, localization pass, or batch.
Pipeline handoff	Use it when the returned artifact will move into editorial, compositing, visualization, review, storage, or publishing.

Prompt Guide

Start with the source or subject, then describe the intended transformation, movement or behavior, camera and composition, and the desired finish. Keep media URLs reachable, use only fields documented for this exact route, and change one major control at a time when comparing results. For source-led tasks, describe what should change as well as what must remain recognizable.

{
  "prompt": "A cinematic close shot with clear subject action, camera movement, lighting, and final visual treatment.",
  "duration": 5,
  "resolution": "1080p",
  "aspect_ratio": "16:9"
}

Technical Specs

Property	Value
Model ID	`pika/v2.2/scenes`
Execution mode	`async`
Required inputs	`prompt`
`seed`	integer
`prompt`	string
`duration`	integer; options: 5, 10; default: 5
`sync_mode`	boolean; default: false
`image_urls`	array
`resolution`	string; options: 720p, 1080p; default: 1080p
`aspect_ratio`	string; options: 16:9, 9:16, 1:1, 4:5, 5:4, 3:2, 2:3; default: 16:9
`negative_prompt`	string; default: ugly, bad, terrible
`ingredients_mode`	string; options: precise, creative; default: precise
`safety_tolerance`	string; default: 6

Related Models

pika/v2.2/frames
pika/v2.2/image-to-video
pika/v2.2/text-to-video
pika/v1.5/effects