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).
Use this in the request body model field.
The currently implemented BFF route.
Input types: image
Keys are managed by the shared dashboard.
This route does not require webhook handling.
Service highlights
Marketplace-style signals backed by the current live route, without copying external SLA, discount, login, or payment claims.
This page only shows endpoints implemented under /api/v1. /api/v1/images/tools/face-swap
This model returns directly without creating a media task.
Top-up, orders, credit balance, and profile continue through the existing shared console.
Your browser only holds an API in One key; provider calls stay server-side.
Call contract
Use these fields to integrate the current live model route.
- Base URL
https://apiin.oneClients call same-origin APIs; the server BFF forwards to the Worker.- Authorization
Authorization: Bearer <API_KEY>Managed by the existing Dashboard API Keys page.- Model field
face-swapSend this value in the request body model field.- Result path
/api/v1/tasks/{task_id}Async jobs return task_id, then use status polling.- Billing path
/billing/creditsUses the existing credits, orders, and top-up logic.
Runtime behavior
This model creates an async task, returns a task_id, then resolves through the real status route.
API Console
Switch between real models on this endpoint, choose a live route, and generate request examples from the current catalog payload.
curl --request POST \
--url https://apiin.one/api/v1/images/tools/face-swap \
--header 'Authorization: Bearer <API_KEY>'
--header '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"
}'/api/v1/tasks/{task_id}Endpoint decision panel
Evaluate cost, provider coverage, and production integration behavior across live models on this implemented endpoint.
Sorted by base credits from low to high.
Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.
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
Extremely affordable at 4 credits per swap
Natural
Natural-looking results with AI blending
No account needed with WaveSpeed
No account needed with WaveSpeed
Fast processing time
Fast processing time
Request format
Clients call same-origin API routes; the server BFF forwards to the matching Worker.
POST/api/v1/images/tools/face-swap4 creditsAI-powered face swapping tool. Replace faces in images with natural-looking results.
Parameters
imagestringURL of the target image (the body/scene to modify)
Requiredface_imagestringURL of the source face image (the face to swap in)
Requiredtarget_indexnumberFace index in target image if multiple faces (0–10)
Optional · Default 0output_formatstringOutput format: "png", "jpg", or "webp"
Optional · Default pngExample 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)
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.