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
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.
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.
| Slot | What you get back | Good for |
|---|---|---|
| Reference image (Smart Reference) | The same character and look, with only the part you asked for changed | Putting 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 composition | Borrowing 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 want | Feature to use | How many images | Full guide |
|---|---|---|---|
| Same character, new scene | Smart Reference on Tsubaki.3, or Reference Pro | One is enough | How to Write Tsubaki.3 Prompts Reference Pro guide |
| Borrow only the pose or composition | Repaint (Whole Image) | One | How to Write Tsubaki.3 Prompts |
| Fix one spot | Smart Reference on Tsubaki.3 plus a "keep" sentence | One | Tsubaki.3 feature guide |
| Combine several images | Tsubaki.3, Reference Pro, Edit Pro | Tsubaki.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 video | Multi-Reference on v4.0 Preview | Two 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
- Add one clear image of the character through Smart Reference.
- Point to it with
@image1in the prompt and describe only the new scene. - 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.
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
- Open See more → Repaint in the left menu and choose an image with a clearly readable pose and a plain background.
- Select Whole Image in the right-hand panel.
- Describe the character, outfit, and scene you want in the prompt.
- Generate. The pose carries over and everything else follows the prompt.
⚠️ Used this way, Repaint replaces the character too. To keep the character, add the picture through Smart Reference instead.
Fix one spot
- Add the image you want to fix through Smart Reference.
- Write the single change and add "keep everything else unchanged."
- 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.
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
- Choose Reference Pro (or Edit Pro) as the model.
- Upload the images you want to combine into the Reference Images area.
- Give each image a role by number, for example "dress the character from image 1 in the outfit from image 2."
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
- In video generation, choose v4.0 Preview and set Reference Mode to Multi-Reference.
- Upload two or three images that show the character clearly.
- Point to them with
@image1in 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 happening | Check this first |
|---|---|
| The reference is ignored | Whether 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 else | Whether 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 too | Switch 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 change | Name 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 reference | State 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
- Turn one reference into character sheets, expression sets, and style changes → How to Write Tsubaki.3 Prompts
- Compare the no-training ways to keep a character consistent → three methods for character consistency
- Make a video from a reference image → image-to-video tutorial
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.