Un personaggio è una sheet di cinque viste della stessa persona (o creatura), generata da una foto e salvata sotto un character_id. È ciò che Multi-Ref Video usa per riconoscere qualcuno in un clip: le cinque viste portano la somiglianza, senza alcun training.

I personaggi che hai creato nell'app sono già disponibili: stessa licenza, stessa lista (vedi Personaggi dall'app).

Le cinque viste

Ruolo	Vista
1	Busto frontale, espressione neutra
2	Busto ¾, il personaggio guarda verso la destra dell'immagine, leggero sorriso
3	Busto ¾, il personaggio guarda verso la sinistra dell'immagine, neutro
4	Figura intera frontale
5	Figura intera, di schiena o di profilo

Ogni vista è generata autonomamente: nessuna si ottiene specchiando un'altra.

Creare un personaggio

POST /characters (permesso images). Il lavoro è asincrono.

json

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

Campo	Tipo	Cosa fa
`name`	stringa, da 1 a 40 caratteri	Il nome del personaggio
`kind`	stringa	`woman`, `man`, o una creatura descritta in inglese (`baby dragon`). Definisce i pronomi delle istruzioni, mai "they".
`image_b64`	base64	La foto: nitida, una sola persona, almeno 1024 px sul lato lungo, massimo 12 MB, JPEG, PNG o WebP
`photo_role`	`bust` (predefinito) o `full_body`	La foto è un busto (diventa la vista 1) o un'inquadratura a figura intera (vista 4)
`outfit`	testo in inglese, opzionale	Un outfit da indossare prima (`a red leather jacket and black jeans`)

La risposta, 202, è il personaggio con status pending e cost_estimate. La foto diventa la vista del suo ruolo e il server genera le altre quattro, in 1-3 minuti.

Prezzo: un credito per ogni vista generata, quindi 4 crediti, più 1 con outfit (l'outfit viene applicato prima, come passaggio separato). Una vista fallita non viene addebitata. POST /characters/quote fornisce il prezzo in anticipo (outfit opzionale).

Seguire, controllare, rifare

GET /characters/{id} restituisce il suo stato:

`status`	Significato
`pending`	Le viste sono in elaborazione
`ready`	Le cinque viste sono pronte
`partial`	Alcune viste mancano o sono fallite
`failed`, `empty`	Nessuna vista utilizzabile

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"
}

Controlla le viste prima del primo render. GET /characters/{id}/views/{role}/file restituisce l'immagine. Una vista fallita, o che guarda nella direzione sbagliata, compromette la somiglianza in ogni video.
Rifare una vista: POST /characters/{id}/views/{role}/redo, 1 credito. La vista ottenuta dalla foto originale non può essere rifatta (vue_photo).
Lista: GET /characters restituisce i tuoi personaggi, inclusi quelli dell'app, e il limite max.
Elimina: DELETE /characters/{id} cancella il personaggio e le sue viste.

Personaggi dall'app

Un personaggio creato nella schermata I miei personaggi dell'app appare in GET /characters con origin app, e funziona in Multi-Ref Video come qualsiasi altro. Nell'app, un personaggio può avere più sheet (outfit, stati d'animo): sheet_id indica quale viene servita (la più recente per impostazione predefinita), sheets le elenca tutte, e ?sheet=<id> ne richiede un'altra in lettura, sul file di una vista e su una vista rifatta. In un clip Multi-Ref, characters[].sheet_id seleziona la sheet. Per rifare una vista di un personaggio dell'app, indica il suo kind nel body.

Storage

Le viste sono cifrate (una chiave per file) e legate alla tua licenza. 50 personaggi al massimo con la licenza Pro, inclusi quelli dell'app. Un personaggio non utilizzato per 15 giorni viene eliminato (expires_at): ogni render Multi-Ref e ogni lettura di una vista fanno slittare la data in avanti. La foto che invii viene conservata come vista del suo ruolo, cifrata, al pari delle viste generate.

Tramite un agente (MCP)

Con il server MCP, basta chiedere: "crea un personaggio da questa foto". L'agente usa tendre_character_create (la foto arriva tramite un link di upload, un file allegato in ChatGPT, un'immagine generata nella conversazione o un indirizzo pubblico), ti mostra le cinque viste, e rifà una vista fallita con tendre_character_redo_view. tendre_character_get, tendre_character_list e tendre_character_delete coprono il resto, mentre tendre_quote fornisce il prezzo in anticipo.

Poi metti in scena il personaggio: vedi Multi-Ref Video.

Pro API: creare personaggi per Multi-Ref Video