Un personnage est une fiche de cinq vues d'une même personne (ou créature), fabriquée à partir d'une seule photo et rangée sous un character_id. C'est elle que le Multi-Ref Vidéo utilise pour reconnaître quelqu'un dans un clip : les cinq vues portent la ressemblance, sans entraînement.

Les personnages que tu as créés dans l'appli y sont déjà : même licence, même liste (voir Les personnages de l'appli).

Les cinq vues

Rôle	Vue
1	Buste, de face, expression neutre
2	Buste de trois-quarts, le personnage regarde vers la droite de l'image, léger sourire
3	Buste de trois-quarts, le personnage regarde vers la gauche de l'image, neutre
4	En pied, de face
5	En pied, de dos

Chaque vue se génère à part : aucune n'est obtenue en retournant une autre.

Créer un personnage

POST /characters (droit images). Le travail est asynchrone.

json

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

Champ	Type	Rôle
`name`	texte, 1 à 40 caractères	Le prénom du personnage
`kind`	texte	`woman`, `man`, ou une créature décrite en anglais (`baby dragon`). Il fixe les pronoms des consignes, jamais « they ».
`image_b64`	base64	La photo : nette, une seule personne, 1024 px au moins sur le grand côté, 12 Mo au plus, JPEG, PNG ou WebP
`photo_role`	`bust` (défaut) ou `full_body`	La photo est un buste (elle devient la vue 1) ou un plan en pied (la vue 4)
`outfit`	texte anglais, facultatif	Une tenue à lui mettre d'abord (`a red leather jacket and black jeans`)

La réponse, 202, est le personnage avec status pending et cost_estimate. La photo devient la vue de son rôle, et le serveur génère les quatre autres, en 1 à 3 minutes.

Prix : un crédit par vue générée, soit 4 crédits, plus 1 avec outfit (la tenue est posée d'abord, à part). Une vue en échec n'est pas facturée. POST /characters/quote donne le prix avant (outfit facultatif).

Suivre, vérifier, refaire

GET /characters/{id} donne son état :

`status`	Sens
`pending`	Les vues sont en fabrication
`ready`	Les cinq vues sont là
`partial`	Des vues manquent ou ont échoué
`failed`, `empty`	Aucune vue utilisable

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

Vérifie les vues avant le premier rendu. GET /characters/{id}/views/{role}/file rend l'image. Une vue ratée, ou tournée du mauvais côté, gâche la ressemblance dans toutes les vidéos.
Refaire une vue : POST /characters/{id}/views/{role}/redo, 1 crédit. La vue issue de la photo d'origine ne se refait pas (vue_photo).
Lister : GET /characters rend tes personnages, ceux de l'appli compris, et le plafond max.
Effacer : DELETE /characters/{id} efface le personnage et ses vues.

Les personnages de l'appli

Un personnage créé dans l'écran Mes personnages de l'appli apparaît dans GET /characters avec origin app, et joue dans le Multi-Ref Vidéo comme les autres. Dans l'appli, un personnage peut avoir plusieurs sheets (tenues, humeurs) : sheet_id dit laquelle est servie (la plus récente par défaut), sheets les liste, et ?sheet=<id> en demande une autre sur la lecture, le fichier d'une vue et la vue refaite. Dans un clip Multi-Ref, characters[].sheet_id choisit la sheet. Pour refaire une vue d'un personnage de l'appli, précise son kind dans le corps.

Stockage

Les vues sont chiffrées (une clé par fichier) et rattachées à ta licence. 50 personnages au plus avec la licence Pro, ceux de l'appli compris. Un personnage inutilisé pendant 15 jours est effacé (expires_at) : chaque rendu Multi-Ref et chaque lecture d'une vue repoussent l'échéance. La photo envoyée est gardée comme vue de son rôle, chiffrée, au même titre que les vues générées.

Par un agent (MCP)

Avec le serveur MCP, il suffit de demander : « fais un personnage avec cette photo ». L'agent utilise tendre_character_create (la photo passe par un lien de dépôt, un fichier joint dans ChatGPT, une image rendue dans la conversation ou une adresse publique), te montre les cinq vues, et refait une vue ratée avec tendre_character_redo_view. tendre_character_get, tendre_character_list et tendre_character_delete font le reste, et tendre_quote donne le prix avant.

Ensuite, fais jouer le personnage : voir Multi-Ref Vidéo.

API Pro : créer des personnages pour le Multi-Ref Vidéo