pika/v2/additions
V2 Additions by Pika - AI-powered video editing and transformation. Apply style transfer, motion control, lip-sync, and visual effects to existing videos with natural language instructions.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runpika/v2/additionsInput Schema
4 parameters · 2 required · 2 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | URL of the image to add |
prompt | string | Required | Text prompt describing what to add |
seed | integer | Optional | The seed for the random number generator |
video | string | Optional | URL of the input video |
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, ortimeout - Retrieve — Read
outputsfrom 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/additions",
"image": "https://static.sandbase.ai/examples/pika/v2/additions/input_image_1.jpg",
"video": "https://static.sandbase.ai/examples/pika/v2/additions/output_url_0.mp4",
"prompt": "A parrot in the shoulder of the person picking up cookies"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Pika Additions
Pika Additions is the Pika route for video object insertion, turning an existing clip and an insertion brief into a production-ready result while keeping the operation distinct from neighboring endpoints. V2 Additions by Pika - AI-powered video editing and transformation. Apply style transfer, motion control, lip-sync, and visual effects to existing videos with natural language instructions. 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, image, video, 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
- Prompted object addition. Insert the described subject into an existing clip while respecting the shot context and movement. This capability belongs to the exact
pika/v2/additionsworkflow. - 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.465000 |
When to Use
| Scenario | Why it fits |
|---|---|
| Exact workflow fit | Choose this route when the required deliverable is video object insertion, 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 parrot in the shoulder of the person picking up cookies",
"image": "https://static.sandbase.ai/examples/pika/v2/additions/input_image_1.jpg"
}
Technical Specs
| Property | Value |
|---|---|
| Model ID | pika/v2/additions |
| Execution mode | async |
| Required inputs | prompt, image |
seed | integer |
image | string |
video | string |
prompt | string |
Related Models
pika/v2/turbo/image-to-videopika/v2/turbo/text-to-videopika/v1.5/effectspika/v2.1/image-to-video