> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnichar.org/llms.txt
> Use this file to discover all available pages before exploring further.

# The .char character file

> What a .char file holds, which models take a character, and how one file moves between Omnichar Cloud, Omnichar Studio and ComfyUI.

A `.char` is one portable file that holds a character:

* the reference photos (face, body and wardrobe)
* an identity fingerprint
* a locked description
* any LoRA adapter trained from the same photos
* a voice clip, if you add one

The file is not tied to any one app. A character built in Omnichar Cloud downloads as a `.char`, opens in Omnichar Studio's Characters panel, and loads into ComfyUI through the [ComfyUI node](/comfyui/install).

![Body, face, shirt and jeans wired in as separate references, and the same person generated walking a street in that outfit](https://mintcdn.com/omnichar/MXPgxF9HsG9YYZF8/images/character-references.webp?fit=max\&auto=format\&n=MXPgxF9HsG9YYZF8\&q=85\&s=e8197e30a0d1141f86c46c79fd2602bf)

## Reference order

Reference images are sorted by role, so the face comes first. Order matters because models like FLUX.2 address references by position in the prompt ("the jacket from image 2"). Every Omnichar surface keeps that order, so the numbers in your prompt match the images the model receives.

## Which models take a character

Models apply a character in one of two ways: they read the reference images directly, or they use a small adapter trained once from the same photos.

| Model | How it takes a character |
| - | - |
| FLUX.2 | Reads the references directly. No training. |
| MiniMax H3 Reference to Video | Reads the references directly. No training. |
| MiniMax H3, other nodes | Trained adapter (no reference channel). |
| Krea 2 | Trained adapter (no reference channel). |
| Nano Banana Pro (hosted) | References and description are sent with the request. |
| Seedance 2.0 (hosted) | Build and wardrobe only. It rejects any reference with a face in it. |

## Continuity score

In Omnichar Studio, every take comes back with a continuity score out of 100, measured against the character. On a video clip the score reports the worst frame and the second it happened, so a single bad frame shows up even when the rest of the clip scores well.

## Voice

A character can carry a voice for MiniMax H3. Use about 30 seconds of clean speech with no music. H3 speaks new words in a voice like the clip, so expect a likeness rather than a copy. The [ComfyUI workflows](/comfyui/workflows#voice) page shows how to wire it.

## Read .char files in your own code

The `omnichar-sdk` package reads `.char` files with no other dependencies, and is licensed Apache-2.0.

```bash theme={null}
pip install omnichar-sdk
```


## Related topics

- [Omnichar Cloud overview](/cloud/overview.md)
- [Omnichar Studio overview](/app/overview.md)
- [About Omnichar](/index.md)
- [Install the Omnichar ComfyUI node](/comfyui/install.md)
- [Omnichar Studio command-line options](/app/command-line.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.