---
title: Characters & scenes
description: Save the people and places you use again, from a photo, a picture or a description, and use them in the image and video playgrounds.
---

[**Characters & scenes**](/app/library) holds the people and places you saved. Make someone once and they look the same in every image and video; save a place once and every shot tagged with it is filmed there. Open it from the last link of the sidebar's **Playground** group, or from the **Characters & scenes** card on a phone's playground page.

The page has two tabs, **Characters** and **Scenes**, each with its count. The first card of each tab, **New character** or **New scene**, makes a new one; any other card opens its editor.

Saved characters and scenes are private to your account, free to keep, and kept until you delete them. You can keep up to 100 of each. Drawing a picture is an image request, billed to your balance like any [playground](/docs/playground) call.

## Make a character {#make-a-character}

A character is a name, a description and a character sheet: one picture with full-body views, close shots and face close-ups of the same person, so every angle in a video has a reference. Click **New character** and fill in:

- **Description**: face, hair, build, clothes. The more specific, the more consistent. Up to 2,000 characters, with **Write for me** to draft it.
- **Picture**, in one of two ways:
  - **From a photo**: drop a photo or tap to choose (PNG, JPEG or WebP). An image model turns it into a character sheet right away. Pick the model under **Image model for the sheet** and press **Redraw** to draw it again, or **Another photo** to start from a different one. A clear, evenly lit picture of one person, with the face visible and a plain background, works best. If none of your image models can draw from a photo, the photo is used as it is, without the side and back views.
  - **From the description**: pick an image model and press **Draw the sheet**. **Redraw** makes another one.
- **Voice** (optional): **Design** a voice from **How they sound** and **A line they'd say**, then **Generate the voice**; or **Upload** 5–20 seconds of one person speaking clearly (WAV, MP3 or M4A), with **What it says**, and confirm you have the right to use it. Press **Use this voice**. In [Create video](/docs/playground/create-video), the character's lines are spoken in it.
- **Name**, then **Save character**. Saving needs a name and a picture, and waits for the sheet to finish.

## Make a scene {#make-a-scene}

A scene is a place your shots can be filmed in; its look comes from the picture. Click **New scene** and fill in:

- **Name**, up to 80 characters, for example "Rooftop bar".
- **The place**: what is there, the time of day, the light and the mood. **Write for me** can draft it.
- **Picture**: **Draw it** with an image model (**Draw the place**, then **Redraw** if you want another), or **Upload** a PNG, JPEG or WebP picture, ideally without people.

Press **Save scene**. A scene needs a picture.

## Edit or delete {#edit-or-delete}

Click a card to open **Edit character** or **Edit scene**. You can change the name and the description, and add, change or remove a character's voice. The picture stays as it is: to change it, make a new one. Press **Save**.

To delete, press **Delete**, then **Delete?** to confirm, or **Keep** to change your mind.

Other open playground pages pick up your changes when you go back to them.

## Use them {#use-them}

| Tool | How you use them |
| --- | --- |
| [Images](/docs/playground/images#use-a-character) | **Add a character** or **Characters** in the header, then **Use this character**. The character sheet goes along as a reference, so the face stays the same. Needs a model that takes reference images. |
| [Create video](/docs/playground/create-video) | Cast characters and scenes from **Characters & scenes** into the video, then tag them in each shot with `@Name`. Each tagged one is a reference picture. **Manage** in that panel opens this page. |
| [Character swap](/docs/playground/character-swap) | For a person in the clip, pick a saved character under **Your characters** to swap in. |
| [Music video](/docs/playground/music-video) | Pick one as the singer; their sheet is the reference for every outfit and scene. |

Each of these tools can also make a new character in place and save it here.

## From code {#from-code}

The same characters and scenes are available through the API: [`/v1/characters` and `/v1/scenes`](/docs/api/characters). Pass a character's id as `character_id`, or tag characters and scenes in [video shots](/docs/api/video-shots).
