Un personaje es una sheet de cinco vistas de la misma persona (o criatura), creada a partir de una foto y almacenada bajo un character_id. Es lo que Multi-Ref Vídeo utiliza para reconocer a alguien en un clip: las cinco vistas capturan el parecido, sin entrenamiento previo.

Los personajes que creaste en la app ya están disponibles: misma licencia, misma lista (ver Personajes de la app).

Las cinco vistas

Rol	Vista
1	Busto de frente, expresión neutra
2	Busto ¾ derecha, el personaje mira hacia la derecha de la imagen, ligera sonrisa
3	Busto ¾ izquierda, el personaje mira hacia la izquierda de la imagen, neutro
4	Cuerpo entero de frente
5	Cuerpo entero, de espaldas o de perfil

Cada vista se genera de forma independiente: ninguna se obtiene por simetría de otra.

Crear un personaje

POST /characters (permiso images). El trabajo es asíncrono.

json

{ "name": "Lea", "kind": "woman", "image_b64": "<the photo>", "photo_role": "bust" }

Campo	Tipo	Para qué sirve
`name`	string, 1 a 40 caracteres	El nombre del personaje
`kind`	string	`woman`, `man`, o una criatura descrita en inglés (`baby dragon`). Define los pronombres de las instrucciones, nunca "they".
`image_b64`	base64	La foto: nítida, una sola persona, al menos 1024 px en el lado largo, 12 MB como máximo, JPEG, PNG o WebP
`photo_role`	`bust` (por defecto) o `full_body`	La foto es un busto (se convierte en la vista 1) o un plano entero (vista 4)
`outfit`	Texto en inglés, opcional	Una ropa que ponerle primero (`a red leather jacket and black jeans`)

La respuesta, 202, es el personaje con status pending y cost_estimate. La foto pasa a ser la vista de su rol y el servidor genera las otras cuatro, en 1 a 3 minutos.

Precio: un crédito por vista generada, es decir, 4 créditos, más 1 con outfit (la ropa se aplica primero, como paso independiente). Una vista que falla no se cobra. POST /characters/quote da el precio de antemano (outfit opcional).

Seguir, comprobar, rehacer

GET /characters/{id} devuelve su estado:

`status`	Significado
`pending`	Las vistas se están generando
`ready`	Las cinco vistas están listas
`partial`	Faltan algunas vistas o han fallado
`failed`, `empty`	Ninguna vista utilizable

json

{
  "character_id": "chr_8f3a...",
  "name": "Lea",
  "kind": "woman",
  "origin": "api",
  "status": "ready",
  "progress": { "ready": 5, "total": 5 },
  "views": [
    { "role": 1, "name": "bust_front", "status": "ready", "file_url": "https://api.tendre.ai/pro/v1/characters/chr_8f3a.../views/1/file" }
  ],
  "expires_at": "2026-10-19T18:02:11.000Z"
}

Comprueba las vistas antes del primer render. GET /characters/{id}/views/{role}/file devuelve la imagen. Una vista fallida, o que mire en la dirección equivocada, arruina el parecido en todos los vídeos.
Rehacer una vista: POST /characters/{id}/views/{role}/redo, 1 crédito. La vista que proviene de la foto original no se puede rehacer (vue_photo).
Listar: GET /characters devuelve tus personajes, incluidos los de la app, y el límite max.
Eliminar: DELETE /characters/{id} borra el personaje y sus vistas.

Personajes de la app

Un personaje creado en la pantalla Mis personajes de la app aparece en GET /characters con origin app y puede actuar en Multi-Ref Vídeo como cualquier otro. En la app, un personaje puede tener varias sheets (ropa, estados de ánimo): sheet_id indica cuál se sirve (la más reciente por defecto), sheets las lista, y ?sheet=<id> solicita otra en la lectura, en el archivo de una vista y en una vista rehecha. En un clip de Multi-Ref, characters[].sheet_id selecciona la sheet. Para rehacer una vista de un personaje de la app, incluye su kind en el cuerpo.

Almacenamiento

Las vistas están cifradas (una clave por archivo) y vinculadas a tu licencia. 50 personajes como máximo con la licencia Pro, incluidos los de la app. Un personaje sin uso durante 15 días se elimina (expires_at): cada render de Multi-Ref y cada lectura de una vista retrasan esa fecha. La foto que envías se conserva como la vista de su rol, cifrada, igual que las vistas generadas.

A través de un agente (MCP)

Con el servidor MCP, solo tienes que pedir: "crea un personaje a partir de esta foto". El agente utiliza tendre_character_create (la foto llega mediante un enlace de subida, un archivo adjunto en ChatGPT, una imagen generada en la conversación o una dirección pública), te muestra las cinco vistas y rehace la que haya fallado con tendre_character_redo_view. tendre_character_get, tendre_character_list y tendre_character_delete cubren el resto, y tendre_quote da el precio de antemano.

Luego reparte el personaje: ver Multi-Ref Vídeo.

Pro API: crear personajes para Multi-Ref Vídeo