Swap Character

Swap a face from a source image onto a target image with realistic blending.

Endpoint

POST

/api/v1/jobs

Create a swap_character job

Credits

Cost

50 credits per job.

Input Parameters

Request Body

Name	Type	Description
`workflow`required	`string`	"swap_character"
`input.sourceImageUrl`required	`string`	URL of the source face image
`input.targetImageUrl`required	`string`	URL of the target image to swap onto
`webhookUrl`	`string`	URL to receive completion notification

Example Request

Create Swap Job

curl -X POST https://vydra.ai/api/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow": "swap_character",
    "input": {
      "sourceImageUrl": "https://example.com/source-face.png",
      "targetImageUrl": "https://example.com/target-scene.png"
    }
  }'

Example Response

Response (201 Created)json

{
  "id": "880e8400-e29b-41d4-a716-446655440003",
  "status": "running",
  "workflow": "swap_character",
  "creditsCharged": 50,
  "createdAt": "2026-01-26T12:00:00.000Z",
  "_links": {
    "self": "https://vydra.ai/api/v1/jobs/880e8400-e29b-41d4-a716-446655440003",
    "status": "https://vydra.ai/api/v1/jobs/880e8400-e29b-41d4-a716-446655440003"
  }
}