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.
From 180.00 credits
Pricing
From 180.00 credits
| Condition | Charge |
|---|---|
| Up to 5 seconds · 360p or 540p | 180.00 credits/call |
| Up to 5 seconds · 720p | 240.00 credits/call |
| Over 5 seconds · 360p or 540p | 360.00 credits/call |
| Over 5 seconds · 720p | 480.00 credits/call |
Based on input video duration and output resolution.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.mode | enum (person | object | background) | No | The swap mode to use | person |
request_body.seed | integer | unknown | No | Random seed for generation | — |
request_body.image_url | string | Yes | URL of the target image for swapping | — |
request_body.video_url | string | Yes | URL of the external video to swap | — |
request_body.resolution | enum (360p | 540p | 720p) | No | The output resolution (1080p not supported) | 720p |
request_body.keyframe_id | integer | No | The 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_switch | boolean | No | Whether to keep the original audio | true |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeySubmit 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
{
"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"
}



