AI Face Swap API
Build face swap and character-consistent media into your product with one API. Combine character references, prompt-based editing and reference-image generation across image and video models.
Apiframe gives you the building blocks to build face swap and face-consistent generation into your app: keep a character consistent across images with Ideogram Character, edit and composite faces with Nano Banana and Flux Fill, and carry a reference identity into video with Wan. One API key, one endpoint, pay-as-you-go.
How to build face swap
Character consistency
Keep the same face across generations from a single reference with Ideogram Character.
Prompt-based face editing
Swap, composite and edit faces in existing photos with Nano Banana and Flux Fill - no masks needed.
Reference images
Pass reference images to anchor identity and appearance in new scenes and compositions.
Identity into video
Carry a reference face or character into motion with reference-to-video models like Wan.
Models to build face swap
These models cover the core of a face-swap pipeline - character consistency, reference images and prompt-based editing. Pick one to see its API reference and parameters.
Ideogram Character
Generate consistent characters from a reference image.
Nano Banana Pro
Higher fidelity Nano Banana with 4K output.
Nano Banana
Fast multi-image composition and editing.
Flux Fill Pro
Inpaint with a mask or outpaint to extend the canvas.
Wan 2.7 R2V
Reference-to-video — anchor up to 5 images and/or videos to drive a new shot.
How it works
- 1
Get your API key
Sign up and grab one key that works across every image and video model.
- 2
Send a reference + prompt
POST a reference image with a prompt to a character or editing model to place the face into a new image.
- 3
Poll or webhook
Get a jobId back, then poll the job or receive a webhook with the finished result.
curl -X POST https://api.apiframe.ai/v2/images/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{ "model": "...", "prompt": "..." }'Frequently Asked Questions
Common questions about the face swap API.
Is there a face swap API?
Apiframe gives you the building blocks for face swap through one API: character-consistency (Ideogram Character), prompt-based image editing (Nano Banana, Flux Fill) and reference images for image and video. You combine them to build a face-swap flow into your own app.
How do I build face swap with the API?
Send a reference image plus a prompt to a character or editing model to place or composite a face into a new image, then optionally carry that identity into video with a reference-to-video model. Each model page documents the exact parameters.
How much does it cost?
Pricing is pay-as-you-go - you only pay for successful generations. See the pricing page for plans and volume discounts.
Which models should I use for face swap?
Start with Ideogram Character for consistent identity, Nano Banana or Flux Fill for editing and compositing, and Wan for carrying a reference into video.
Still have questions?
Start building face swap with the Apiframe API
One API key for character consistency, editing and reference-image models. Free credits to start.
Questions? Join our Discord or contact sales.