Seedance 2.5 from ByteDance is officially available on Apiframe.

AI Face Swap API

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.

POST /v2/images/generate

Get API Key Browse all 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.

Browse all AI models
Ideogram Character logo Ideogram Character Ideogram Nano Banana Pro logo Nano Banana Pro Google Nano Banana logo Nano Banana Google Flux Fill Pro logo Flux Fill Pro Black Forest Labs Wan 2.7 R2V logo Wan 2.7 R2V Alibaba

How it works

  1. 1

    Get your API key

    Sign up and grab one key that works across every image and video model.

  2. 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. 3

    Poll or webhook

    Get a jobId back, then poll the job or receive a webhook with the finished result.

Example request 
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": "..." }'

Related

AI Image Generator API AI Video Generator API AI Music Generator API

Frequently asked questions

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.

Get started

Start building face swap with the Apiframe API

One API key for character consistency, editing and reference-image models. Free credits to start.

Get API Key Read the docs
  • Character-consistent generation
  • Prompt-based face editing
  • Image & video reference inputs
  • Pay only for successes