Pikaswaps

Swap out any object or region of your video with a new image or object. Define areas to replace either with a mask or coordinates.

POST /generate/pikaswaps

cURL

modifyRegionMask

curl -X POST 'https://devapi.pika.art/generate/pikaswaps' \
-H 'X-API-KEY: your_api_key' \
-H 'Accept: multipart/form-data' \
-F 'video=@video.mp4;type=video/mp4' \
-F 'image=@image.jpg;type=image/jpg' \
-F 'modifyRegionMask=@mask.jpg;type=image/jpg' \
-F 'promptText=Replace the background with a beautiful beach' \
-F 'negativePrompt=blurry, low quality' \
-F 'seed=12345'

200

{
  "video_id": "<string>"
}

Body

multipart/form-data

video · file · required

image · file | null

promptText · string | null

modifyRegionMask · file | null

A mask image that specifies the region to modify, where the mask is white and the background is black

modifyRegionRoi · string | null

Plaintext description of the object / region to modify

negativePrompt · string | null

seed · integer | null

Response

200

application/json

Successful Response

video_id · string · required