PixVerse Swap

From 180.00 credits
ae_pixverse_swap

Replace a person, object, or background in a video using an image, with keyframe-based placement and optional original audio.

VideoImage
From 180.00 credits

Pricing

From 180.00 credits
ConditionCharge
Up to 5 seconds · 360p or 540p180.00 credits/call
Up to 5 seconds · 720p240.00 credits/call
Over 5 seconds · 360p or 540p360.00 credits/call
Over 5 seconds · 720p480.00 credits/call

Based on input video duration and output resolution.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.modeenum (person | object | background)NoThe swap mode to useperson
request_body.seedinteger | unknownNoRandom seed for generation—
request_body.image_urlstringYesURL of the target image for swapping—
request_body.video_urlstringYesURL of the external video to swap—
request_body.resolutionenum (360p | 540p | 720p)NoThe output resolution (1080p not supported)720p
request_body.keyframe_idintegerNoThe keyframe ID to use for face/object mapping. The input video is normalized to 24 FPS before processing, so keyframe 1 = first frame, keyframe 24 = 1 second in, etc. Valid range: 1 to (duration_seconds * 24).1
request_body.original_sound_switchbooleanNoWhether to keep the original audiotrue

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_pixverse_swap' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "image_url": "https://agentearth.ai/fileserver/file/63e61b03-3e23-4e46-8ea8-d451d1da6e9b.jpg",
      "keyframe_id": 48,
      "mode": "person",
      "original_sound_switch": true,
      "resolution": "720p",
      "video_url": "https://agentearth.ai/fileserver/file/95386d76-d98e-4335-ab8a-f1cddbab651a.mp4"
    }
  }
}'
Response exampleresponse.json
JSON
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "3dc5e874-1f89-4061-ae13-8f0bef5f72aa"
}