Pika V2.2 Pikaframes | Fast Image-to-Video API

pika/v2.2-pikaframes

Create precise keyframe-to-video sequences with Pika V2.2 Pikaframes. Upload up to 5 keyframes, set per-transition prompts and durations, and interpolate smooth motion for storyboards, camera moves, and style-consistent animation. Supports total runtimes up to 25 seconds. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Image to Video
Input

Drag & drop or click to upload

preview

Drag & drop or click to upload

preview

Idle

$0.08per run·~12 / $1

Next:

ExamplesView all

TV screen flickering

Related Models

README

Pika V2.2 — Pickaframes (Image-to-Video)

Pika V2.2 Pickaframes turns one or more still images into a short, animated video. You provide keyframe images plus a global description, optionally set per-segment transitions, and the model fills in motion, camera moves, and in-between frames for social videos, ads, and simple storyboard clips.

Highlights

  • Image-driven animation – Start from 1+ still images and let the model create smooth motion and transitions.
  • Timeline control via transitions – Use per-segment durations to decide how long the animation lingers between images.
  • Production-ready quality – Supports up to 1080p output for most major platforms.
  • Prompt-guided style – A single high-level prompt controls look, atmosphere, and camera behaviour.

Parameters

  • images (required)

  • Upload one or more images or paste URLs.

  • Single image: the model animates around that scene (camera moves, small changes).

  • Multiple images: they act as keyframes; the video evolves from the first to the last in order.

  • prompt (required) Global description of the clip: content, motion, and style. Example: TV screen flickering in a cozy kitchen, soft camera shake, warm cinematic lighting.

  • transitions (optional) A list of segments; each item has:

  • duration – segment length in seconds

  • prompt (optional) – local override or refinement for this segment only

If transitions are provided, total video length is roughly the sum of all durations. If no transitions are set, a 5-second clip is generated by default.

  • resolution Output quality tier, for example 720p or 1080p.

  • seed

  • −1: random each run (exploration).

  • Any fixed integer: reproducible layout and motion.

Output format: MP4 video at the chosen resolution.

Pricing

Pricing is $0.04 per second for 720p or $0.06 per second for 1080p, with a minimum of 5 billable seconds.

Billable Duration720p1080p
5s$0.20$0.30
10s$0.40$0.60
15s$0.60$0.90
20s$0.80$1.20
25s$1.00$1.50

Billing Rules

  • With custom transitions, duration is the sum of all transition durations. An omitted transition duration defaults to 5 seconds.
  • Without custom transitions, duration is 5 × (number of images − 1) seconds.
  • Total duration is rounded up to the next whole second for billing.
  • Supply 2–5 images. Custom transitions must contain exactly one item per adjacent image pair.
  • Total transition duration must not exceed 25 seconds. This is an input limit, not automatic truncation.
  • prompt and seed do not add separate charges.

How to Use

  1. Write the global prompt In the prompt field, describe the overall scene and motion in one or two sentences (for example: TV screen flickering, reflections on the counter, slight handheld camera feel).

  2. Add images

  • Under images, upload at least one frame or paste image URLs.
  • Click Add Item to append more keyframes; they are used in order from top to bottom.
  1. Configure transitions (optional but recommended for multi-image stories)
  • In transitions, click Add Item.
  • Set duration in seconds for how long the animation should spend between the current and next keyframe.
  • Optionally add a local prompt to nudge that segment’s motion or style.
  • Add multiple transition items if you want a longer sequence; total length is their duration sum.
  1. Choose resolution
  • Use 720p for quick iteration and previews.
  • Switch to 1080p once you are happy with the motion and want a final render.
  1. Set seed if needed
  • Keep −1 when exploring different variations.
  • Use a fixed integer when you want to lock in a specific behaviour for future runs.
  1. Run and download
  • Check the estimated cost shown on the Run button (for example, 0.20 USD for 5 seconds at 720p).
  • Click Run, wait for processing, then download your generated MP4 from the result panel.

Tips

  • Use images with similar aspect ratios to avoid stretching during transitions.
  • To mimic flickering or jump cuts, use two very similar images with short transition durations.
  • Iterate with short, cheap runs first, then extend durations and upgrade resolution for the final version.
Note:This website uses AI models provided by third parties. Documentation prices are for reference and may be outdated. The Generate button shows an estimate; the final task charge prevails.

v2.2 Pikaframes API — Quick start

Grab a WaveSpeedAI API key, then call POST https://api.wavespeed.ai/api/v3/pika/v2.2-pikaframes with your input as JSON. The endpoint returns a prediction id. Start polling the result endpoint around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. On completed, read output values from data.outputs. Examples for v2.2 Pikaframes below.

HTTP example
set -euo pipefail

: "${WAVESPEED_API_KEY:?Set WAVESPEED_API_KEY}"

REQUEST_BODY=$(cat <<'JSON'
{
    "images": [
        "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
        "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
    ],
    "resolution": "720p"
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/pika/v2.2-pikaframes" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d "$REQUEST_BODY")

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/pika/v2.2-pikaframes";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "images": [
                "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
                "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
        ],
        "resolution": "720p"
}),
});
const task = body.data ?? body;
if (!task.id) throw new Error("Submission response did not contain a prediction id");
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "images": [
        "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
        "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg"
    ],
    "resolution": "720p"
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/pika/v2.2-pikaframes", json.dumps(payload).encode())
task = body.get("data", body)
if not task.get("id"):
    raise RuntimeError("Submission response did not contain a prediction id")
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout", "deleted"}:
        raise RuntimeError(result)
    time.sleep(2)

v2.2 Pikaframes API — Frequently asked questions

What is the v2.2 Pikaframes API?

v2.2 Pikaframes is a Pika model for video generation from images, exposed as a REST API on WaveSpeedAI. Create precise keyframe-to-video sequences with Pika V2.2 Pikaframes. Upload up to 5 keyframes, set per-transition prompts and durations, and interpolate smooth motion for storyboards, camera moves, and style-consistent animation. Supports total runtimes up to 25 seconds. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing. You can call it programmatically or try it from the playground above.

How do I call the v2.2 Pikaframes API?

POST your input parameters to the model's REST endpoint (shown in the API tab of this playground) with your WaveSpeedAI API key in the Authorization header. Submission returns a prediction ID. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. The playground generates Python, JavaScript, and cURL examples for submitting requests and polling results. Full request/response shape is documented at https://wavespeed.ai/docs/docs-api/pika/pika-v2.2-pikaframes.

How much does v2.2 Pikaframes cost per run or per second?

v2.2 Pikaframes starts at $0.08 per run or per second. That figure is the base price — the final charge scales with the parameters you set in the form (output size, length, count, references, or whatever knobs this model exposes), so a higher-quality or larger output costs more than a minimal one. The exact cost for your current input is shown live next to the Generate button before you submit, and the actual per-call charge is recorded on the prediction afterwards.

What inputs does v2.2 Pikaframes accept?

Key inputs: `prompt`, `images`, `resolution`, `seed`, `transitions`. The full JSON schema (types, defaults, allowed values) is rendered above the Generate button and mirrored in the API reference at https://wavespeed.ai/docs/docs-api/pika/pika-v2.2-pikaframes.

How long does v2.2 Pikaframes take to generate?

Reported generation time on WaveSpeedAI is around 345 seconds per request. This is an estimate, not a latency guarantee; queue time and input settings can change the total wait. live status is visible in the prediction record.

Can I use v2.2 Pikaframes outputs commercially?

Commercial usage rights depend on the model's license, set by its provider (Pika). Check the provider's applicable terms and WaveSpeedAI's Terms of Service before commercial use.

llms.txt — pika/v2.2-pikaframes for AI agents and LLMs