PixAI Reference Images: How to Use Them, Goal by Goal

Where to add onePick by goalShortest stepsWhen it failsFAQ

QUICK ANSWER

Add a PixAI reference image from the + in the prompt box.

On the web, click + → Smart Reference in the prompt box. In the app, tap + Reference above the prompt box. Once the image is in, point to it with @image1 in your prompt and write only what you want changed.

  • Same character, new scene: add one reference image and describe only what changes
  • Fix one spot: name the single change and add "keep everything else unchanged"
  • Combine several images: Tsubaki.3 takes up to three, Reference Pro and Edit Pro V2.0 up to 10

Grab one image of your character and start by changing a single scene.

Open the generator and add a reference →

The reference went in and the result ignored it. Or it worked too well and came back as a different character entirely. Most of the time the cause is a mismatch between what you wanted and the feature you used. PixAI has several features that take reference images, and each is good at something different. This page shows where they go and which feature to pick for each goal. For the fine details of each feature, follow the links to its own guide.

Where do you add a reference image in PixAI?

WEB

+ → Smart Reference in the prompt box

In the generator, click + inside the prompt box and choose Smart Reference from the menu. The Smart Reference button below the prompt box does the same thing.

APP

+ Reference above the prompt box

On the create screen, tap the + Reference box above the prompt and pick an image. A counter such as 0/3 next to it shows how many you can add.

PixAI web generator showing Smart Reference in the + menu of the prompt box and the Smart Reference button below it
Web: + → Smart Reference in the prompt box, or the button underneath

You can also drag and drop an image or paste one from the clipboard. The limit depends on the model. Tsubaki.3 takes up to three.

Reference images and Repaint do different jobs

Besides the reference images you add through Smart Reference, PixAI has Repaint, which redraws a picture you give it. Open it from See more → Repaint in the left menu. Which one you use changes what comes back.

PixAI web Repaint screen, with Repaint under See more in the left menu
Left menu: See more → Repaint
SlotWhat you get backGood for
Reference image
(Smart Reference)
The same character and look, with only the part you asked for changedPutting a character in a new scene, fixing one spot
Repaint
(Whole Image)
A new picture that borrows one thing from the original, usually the pose or compositionBorrowing a pose, a layout, or a color mood

💡 "Smart Reference" is the name of the entry point. The images you add through it are called reference images, and that is the term this guide uses.

For a tour of the whole generator, see How to Use PixAI. For the app layout, see the PixAI app guide.

Pick by goal: which reference method should you use?

Start from what you want to do and read across.

What you wantFeature to useHow many imagesFull guide
Same character, new sceneSmart Reference on Tsubaki.3, or Reference ProOne is enoughHow to Write Tsubaki.3 Prompts
Reference Pro guide
Borrow only the pose or compositionRepaint (Whole Image)OneHow to Write Tsubaki.3 Prompts
Fix one spotSmart Reference on Tsubaki.3 plus a "keep" sentenceOneTsubaki.3 feature guide
Combine several imagesTsubaki.3, Reference Pro, Edit ProTsubaki.3: up to three
Reference Pro: up to 10
Edit Pro: up to 10 on V2.0, four on V1.0
Reference Pro guide
Edit Pro guide
Lock a character in a videoMulti-Reference on v4.0 PreviewTwo or three work best (max six)How to Prompt v4.0 Preview

For how reference images compare with training a LoRA or reusing a fixed prompt block, see the three methods for character consistency.

The shortest steps for each goal

One rule covers every goal. Whatever the reference image already shows, leave to the image. Add in words only what it does not show. Do not re-describe the outfit, hair color, or face.

Put the same character in a new scene

  1. Add one clear image of the character through Smart Reference.
  2. Point to it with @image1 in the prompt and describe only the new scene.
  3. End with a sentence that locks the appearance, then generate.
The character from @image1, standing on a train platform on a snowy night, under a street lamp. Keep the character's appearance exactly as in the reference.
Character with long red hair and a black coat, used as the reference image in PixAI Tsubaki.3
Reference image
The same character placed on a snowy train platform at night by PixAI Tsubaki.3
Only the scene changed

Changing the outfit, pose, or expression works the same way. Prompt examples for each swap are in chapter 2 of How to Write Tsubaki.3 Prompts. To do the same with Reference Pro, a members-only tool, see the Reference Pro guide.

Borrow only the pose or composition

  1. Open See more → Repaint in the left menu and choose an image with a clearly readable pose and a plain background.
  2. Select Whole Image in the right-hand panel.
  3. Describe the character, outfit, and scene you want in the prompt.
  4. Generate. The pose carries over and everything else follows the prompt.
Illustration of a figure in a hoodie crouching on one knee, used as the Repaint source
Source image
PixAI Tsubaki.3 result redrawn as an armored knight in the same pose
Only the pose carried over

⚠️ Used this way, Repaint replaces the character too. To keep the character, add the picture through Smart Reference instead.

Fix one spot

  1. Add the image you want to fix through Smart Reference.
  2. Write the single change and add "keep everything else unchanged."
  3. If a specific accessory has to survive, name the object itself.
Change the eye color of the character in @image1 to amber. Keep everything else unchanged.
Cat-eared girl holding a bouquet in a flower shop, used as the reference image
Original
PixAI Tsubaki.3 edit with only the eye color changed and everything else left as it was
Only the eye color changed

A category such as her accessories is too loose to protect anything. Naming the object, as in the navy ribbon bow at her collar, keeps it in place far more often. For complex instructions or several fixes at once, go to the Edit Pro guide.

Combine several images

  1. Choose Reference Pro (or Edit Pro) as the model.
  2. Upload the images you want to combine into the Reference Images area.
  3. Give each image a role by number, for example "dress the character from image 1 in the outfit from image 2."
Reference image 1 in PixAI Reference Pro: a cat-eared character with an eyepatch
Image 1
Reference image 2 in PixAI Reference Pro: a character with blue twin tails in a school uniform
Image 2
Reference image 3 in PixAI Reference Pro: a silver-haired character in a jumping pose
Image 3
Final output from PixAI Reference Pro combining the three reference images
Result

Tsubaki.3 can combine up to three reference images too, written as @image1 and @image2. Reference Pro takes up to 10. Edit Pro takes up to 10 on V2.0 (four on V1.0) and suits composites such as "A's face with B's outfit." Method 1 in the three methods for character consistency explains when to use which.

Lock a character in a video

  1. In video generation, choose v4.0 Preview and set Reference Mode to Multi-Reference.
  2. Upload two or three images that show the character clearly.
  3. Point to them with @image1 in the prompt and describe only the motion and camera.

v4.0 Preview reads a reference image as the character itself, not as the first frame of the video. It accepts up to six images, but two or three well-chosen ones give steadier results. See How to Prompt v4.0 Preview for the writing, and the image-to-video tutorial for how the video models differ.

When a reference image is not working

What keeps happeningCheck this first
The reference is ignoredWhether the selected model supports reference images. If it does not, the screen says "Current model does not support reference images." Also check that your prompt points to @image1
The character turns into someone elseWhether you redrew it with Repaint. To keep the character, add it through Smart Reference and include Keep the character's appearance exactly as in the reference
The background or framing comes along tooSwitch to an image with a plain background. Say what should change in concrete terms, such as the scene or the lighting, and avoid descriptions that contradict the reference
Accessories or outfit details changeName the things that must stay, object by object. Check each output for the features that matter, such as which eye the eyepatch is on
The character still faces the same way as the referenceState the direction in the prompt. For direction, the prompt wins over the reference

💡 The steadiest reference images are sharp, well lit, and show the face from the front or at a three-quarter angle. A small blurry picture or a back view does not give the model enough to hold on to.

These cannot be used together with reference images:

  • Color Palette (remove it first)
  • Unlimited Mode
  • Multi-image reference on Tsubaki.3 and LoRAs. If you also want a style LoRA, generate one image with the LoRA first and use that image as the reference

PixAI reference images FAQ

How many reference images can I use?

It depends on the feature. Tsubaki.3 takes up to three, Reference Pro up to 10, Edit Pro up to 10 on V2.0 and four on V1.0, and v4.0 Preview for video up to six. More is not better. A few images with clear roles give steadier results.

Does using a reference image cost more credits?

The cost depends on the model and settings, and the number on the generate button is what that one run will take. Check it before you generate. Reference Pro is a members-only tool. The PixAI pricing guide covers the full picture.

Can I use someone else's artwork as a reference?

Use images you drew or generated yourself, or ones you have permission to use. Do not use another artist's work or a photo of a real person without permission. For what you can do with the results, see the commercial use and licensing guide.

I added a reference and nothing changed. Why?

First check that the selected model supports reference images. Then check that the prompt points to @image1, and that Unlimited Mode or the Color Palette is not on at the same time. Which PixAI Model Should You Use? can help you pick a model that fits.

Can I use a LoRA together with reference images?

Multi-image reference on Tsubaki.3 cannot be combined with a LoRA. Image-to-image, where a picture is redrawn from scratch, works with LoRAs as usual. The Tsubaki.3 feature guide explains the difference.

Do reference images work in the mobile app?

Yes. Add them from the + Reference box above the prompt on the create screen. Reference Pro and Edit Pro are also available from the model settings in the app.

What to read next

For a first run, keep the same reference and generate two or three images with only the scene changed. You will see which features hold and which ones drift.