POST
/faceswap2 creditsFace Swap
Replace a face in a target image with a face from a source image. The target image keeps its lighting, pose, and composition; only the face identity changes. Works with AI-generated and real photographs. Commonly used for brand consistency, personalized content, and generating diverse character variations from a single base image.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| target_image_url | string | Required | URL of the image where the face will be replaced. |
| swap_image_url | string | Required | URL of the image containing the face to use. |
| webhook_url | string | Optional | URL where we POST the completed task result. |
| webhook_secret | string | Optional | Sent as x-webhook-secret header in webhook delivery. |
Example Request
cURL
curl -X POST https://api.journeyapi.com/api/v1/faceswap \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_image_url": "https://example.com/target.jpg",
"swap_image_url": "https://example.com/face.jpg",
"webhook_url": "https://your-server.com/webhook"
}'Immediate Response
Returns immediately with a task ID. Use /fetch or webhooks to get the result.
200 OK
{
"task_id": "ii3l1h33-l52o-74q7-n049-779988773333"
}Response Fields
| Field | Type | Description |
|---|---|---|
| task_id | string | UUID of the faceswap task. |
| task_type | string | Always "faceswap". |
| image_url | string | URL of the resulting face-swapped image. |
Tips
- 1The swap image should have a clearly visible face for best results.
- 2Works best when both images have similar face angles and lighting.
- 3Both URLs must be publicly accessible.
Quirks & Gotchas
Only one face is swapped. If target_image_url has multiple faces, the most prominent one is used.
This is a non-Midjourney endpoint — it uses a separate AI model for face swapping.