🔄Tool APIActive

face-swap API

Swap faces in images with natural results using the Face Swap API via API in One. Only 4 credits per swap (~$0.04).

Get API Key View Docs

Model IDface-swap

Use this in the request body model field.

Endpoint/api/v1/images/tools/face-swap

The currently implemented BFF route.

Outputimage

Input types: image

AuthBearer API key

Keys are managed by the shared dashboard.

WebhookNot required

This route does not require webhook handling.

Live capabilities

These capabilities come from the current model config and backend route. Unreleased APIs are not listed.

Extremely affordable at 4 credits per swap

Natural

Natural-looking results with AI blending

No account needed with WaveSpeed

Fast processing time

Request format

Clients call same-origin API routes; the server BFF forwards to the matching Worker.

MethodEndpointCreditsPurpose

POST/api/v1/images/tools/face-swap4 credits

AI-powered face swapping tool. Replace faces in images with natural-looking results.

Parameters

imagestring

URL of the target image (the body/scene to modify)

Required

face_imagestring

URL of the source face image (the face to swap in)

Required

target_indexnumber

Face index in target image if multiple faces (0–10)

Optional · Default 0

output_formatstring

Output format: "png", "jpg", or "webp"

Optional · Default png

Example request

curl -X POST https://apiin.one/api/v1/images/tools/face-swap \
  -H "Authorization: Bearer aio_your_api_key" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "face-swap",
  "image": "https://example.com/target-photo.jpg",
  "face_image": "https://example.com/source-face.jpg",
  "target_index": 0,
  "output_format": "png"
}'

Integration flow

These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.

Create a shared API key

Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.

Call the real endpoint

Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/images/tools/face-swap

Poll task status

Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.

Task status route

After creating image, video, audio, or tool tasks, poll the real task endpoint for results.

GET/api/v1/tasks/{task_id}Check generation task status and result.

Pricing

~$0.04 per swap (4 credits)

Base cost$0.04

Credits4

BillingSuccessful requests

Use cases

These workflows are supported by the current model and backend node.

Create personalized marketing imagery

Build virtual try-on features for e-commerce

Generate personalized content at scale

Integrate face swap into photo editing apps

FAQ

How much does Face Swap cost?

Only 4 credits per swap (~$0.04).

How natural are the results?

The AI produces seamless results with proper lighting, skin tone, and angle matching.