Start an AI character swap
start_swapSwaps one of your characters into a ready source video (or a reel link). Uses AI swap credits from your plan or a swap pack. Sharing plans and the Free plan include none: then the answer is code plan_limit with an upgrade_url to show the user. Returns the video id; poll get_video until ready (about 8 minutes). start/end: seconds of the source to swap (default: from the start, up to your plan limit).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"character_id": "<character_id>"
},
"name": "start_swap"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | ||
| start | No | ||
| prompt | No | Extra direction for the swap | |
| subject | No | Who to replace, e.g. "the woman in red" (default: the main person) | |
| source_id | No | A ready source from get_upload | |
| source_url | No | Or a reel link (the worker downloads it) | |
| character_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app_url | Yes | ||
| video_id | Yes |