Face Swap
alibaba/face-swapFace Swap replaces the face in a target image with the face from a source image, producing a realistic face-swapped result.
- Base price
- $0.01USD / run
- Execution
- async
- Model type
- image
- Input fields
- 3
Try the model
Playground
PNG, JPEG, WebP, or GIF · 20 MiB maximum
PNG, JPEG, WebP, or GIF · 20 MiB maximum
Your output will appear here
Complete the inputs, then click Run.
Specifications
Pricing
- Base price
- $0.01 / run
- Billing formula
- 0.013
Context & modalities
- Input
- Schema-defined
- Output
- image
Capabilities
- Chat
- Not supported
- Vision
- Not supported
- Reasoning
- Not supported
- Structured output
- Not supported
- Function calling
- Not supported
- Audio input
- Not supported
Access
- Provider
- Alibaba
- Model ID
- alibaba/face-swap
- Execution
- async
- API
- Unified Run API
- Endpoint
- /v1/run
API README
Face Swap
Face Swap replaces the face in a target image with the face from a source image. Precisely swaps facial features only — head shape and hairstyle are preserved. Priced at $0.013 per image.
Highlights
Face-only swap — Replaces the face while keeping the original head shape, hair, and body intact for a natural result.
Dual-image input — Provide a source face and a target image; the model handles seamless blending automatically.
High realism — Produces photorealistic results with consistent skin tone, lighting, and edge transitions.
Low cost — At $0.013 per image, suitable for high-volume portrait and creative workflows.
Pricing
| Metric | Price |
|---|---|
| Per image | $0.013 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| Portrait retouching and casting previews | Full head replacement (use Head Swap) |
| Entertainment and creative content | Style or background editing (use Qwen Image Edit Exp0622) |
| Product catalog face replacement | Video face swap |
| Gaming and avatar creation | New image generation from scratch (use Z-Image Exp0622) |
Technical Specs
| Spec | Value |
|---|---|
| Input | Source image (face) + target image (URL or Base64, max 50 MB each) |
| Output | Face-swapped image (PNG/JPEG) |
| Swapped region | Face only (head shape and hairstyle preserved) |
| Execution | Async (submit → poll for result) |
Start building
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/run" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"model": "alibaba/face-swap"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
status=$(printf '%s' "$result" | jq -r .status)
case "$status" in completed|failed|timeout) break ;; esac
sleep 2
result=$(curl --fail-with-body --silent \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
"https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"Choose your model
Compare models
| Model | Context | Input / 1M | Output / 1M | Released |
|---|---|---|---|---|
Face SwapThis model Alibaba | — | — | — | Jun 22, 2026 |
Alibaba | — | — | — | Jul 21, 2026 |
Alibaba | — | — | — | Jul 21, 2026 |
Alibaba | — | — | — | Jul 21, 2026 |
Alibaba | — | — | — | Jun 22, 2026 |
Alibaba | — | — | — | Apr 1, 2026 |