> ## Documentation Index
> Fetch the complete documentation index at: https://stir-vid.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Image Swap

> Reference-based face and character replacement in stills.

Image Swap replaces a face or full character in a still image using a reference image. It is the fastest, lightest surface in StirVid.

## How it works

<Steps>
  <Step title="Submit source + reference">
    Provide the image to edit and the character reference. Add an optional prompt for stylistic guidance.
  </Step>

  <Step title="Image editor">
    The image editor composites the reference character into the source image, matching pose, lighting, and framing.
  </Step>

  <Step title="Result">
    You get a finished still, archived to storage and available for download.
  </Step>
</Steps>

## Safety filters

Some edits may be rejected by upstream safety filters. When that happens, StirVid returns a clear error and does not deduct credits. Try a different reference or reframe the prompt.

## Inputs

| Field                 | Purpose                                     |
| --------------------- | ------------------------------------------- |
| `source_image_url`    | The image to edit.                          |
| `reference_image_url` | The character or face to use as the target. |
| `prompt`              | Optional stylistic guidance.                |