Character Swap

Transform the character in a video while keeping all movements and actions intact, using Kling motion control. Provide a reference video and a transformed first frame with the new character.

Endpoint changed

The old canonical swap_character job workflow was removed. Use the dedicated route below.

Endpoint

POST

/api/v1/character-swap/direct

Create a character swap job

Credits

Cost

300 credits per job.

Input Parameters

Request Body

Name	Type	Description
`referenceVideoUrl`required	`string`	URL of the reference video (3-30 seconds)
`transformedFrameUrl`required	`string`	URL of the transformed first frame with the new character
`mode`	`string`	"standard" (default) or "pro"
`orientation`	`string`	"video" (default) or "image"
`keepAudio`	`boolean`	Preserve original audio (default false)
`voiceId`	`string`	Optional ElevenLabs voice ID for voice transformation

Example Request

Create Character Swap Job

curl -X POST https://vydra.ai/api/v1/character-swap/direct \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "referenceVideoUrl": "https://example.com/reference.mp4",
    "transformedFrameUrl": "https://example.com/new-character-frame.png"
  }'

Example Response

Response (201 Created)json

{
  "success": true,
  "jobId": "880e8400-e29b-41d4-a716-446655440003",
  "status": "running",
  "estimatedTime": "2-5 minutes",
  "_links": {
    "status": "https://vydra.ai/api/v1/jobs/880e8400-e29b-41d4-a716-446655440003"
  }
}

Poll GET /api/v1/jobs/{jobId} for completion.