Een personage is een sheet van vijf weergaven van dezelfde persoon (of hetzelfde wezen), gemaakt vanuit één foto en opgeslagen onder een character_id. Het is wat Multi-Ref Video gebruikt om iemand in een clip te herkennen: de vijf weergaven dragen de gelijkenis, zonder training.

De personages die je in de app hebt aangemaakt zijn er al: zelfde licentie, zelfde lijst (zie Personages uit de app).

De vijf weergaven

Rol	Weergave
1	Buste vooraanzicht, neutrale uitdrukking
2	Buste ¾, het personage kijkt naar de rechterkant van het beeld, lichte glimlach
3	Buste ¾, het personage kijkt naar de linkerkant van het beeld, neutraal
4	Ten voeten uit, vooraanzicht
5	Ten voeten uit, rug

Elke weergave wordt afzonderlijk gegenereerd: geen enkele is verkregen door een andere te spiegelen.

Een personage aanmaken

POST /characters (permissie images). Het werk verloopt asynchroon.

json

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

Veld	Type	Wat het doet
`name`	string, 1 tot 40 tekens	De voornaam van het personage
`kind`	string	`woman`, `man`, of een wezen beschreven in het Engels (`baby dragon`). Bepaalt de voornaamwoorden in de instructies, nooit "they".
`image_b64`	base64	De foto: scherp, slechts één persoon, minimaal 1024 px op de lange zijde, maximaal 12 MB, JPEG, PNG of WebP
`photo_role`	`bust` (standaard) of `full_body`	De foto is een buste (wordt weergave 1) of een full-body foto (weergave 4)
`outfit`	Engelse tekst, optioneel	Een outfit om eerst aan te trekken (`a red leather jacket and black jeans`)

Het antwoord, 202, is het personage met status pending en cost_estimate. De foto wordt de weergave van zijn rol, en de server genereert de andere vier in 1 tot 3 minuten.

Prijs: één credit per gegenereerde weergave, dus 4 credits, plus 1 met outfit (de outfit wordt eerst aangetrokken als een afzonderlijke stap). Een mislukte weergave wordt niet aangerekend. POST /characters/quote geeft de prijs vooraf (outfit optioneel).

Volgen, controleren, opnieuw genereren

GET /characters/{id} geeft de status:

`status`	Betekenis
`pending`	De weergaven worden aangemaakt
`ready`	De vijf weergaven zijn beschikbaar
`partial`	Sommige weergaven ontbreken of zijn mislukt
`failed`, `empty`	Geen bruikbare weergave

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

Controleer de weergaven vóór de eerste render. GET /characters/{id}/views/{role}/file geeft de afbeelding terug. Een mislukte weergave, of een die de verkeerde kant op kijkt, bederft de gelijkenis in elke video.
Een weergave opnieuw genereren: POST /characters/{id}/views/{role}/redo, 1 credit. De weergave die afkomstig is van de originele foto kan niet opnieuw worden gegenereerd (vue_photo).
Lijst: GET /characters geeft je personages terug, inclusief die uit de app, en de limiet max.
Verwijderen: DELETE /characters/{id} wist het personage en zijn weergaven.

Personages uit de app

Een personage aangemaakt via het Mijn personages-scherm van de app verschijnt in GET /characters met origin app, en speelt in Multi-Ref Video zoals elk ander personage. In de app kan een personage meerdere sheets hebben (outfits, stemmingen): sheet_id geeft aan welke wordt geleverd (standaard de meest recente), sheets geeft ze allemaal weer, en ?sheet=<id> vraagt een andere op bij het lezen, bij het bestand van een weergave en bij een opnieuw gegenereerde weergave. In een Multi-Ref clip kiest characters[].sheet_id de sheet. Om een weergave van een app-personage opnieuw te genereren, geef je zijn kind mee in de body.

Opslag

De weergaven zijn versleuteld (één sleutel per bestand) en gekoppeld aan je licentie. Maximaal 50 personages met de Pro-licentie, inclusief die uit de app. Een personage dat 15 dagen ongebruikt blijft, wordt gewist (expires_at): elke Multi-Ref render en elke leesactie van een weergave verschuift de datum. De foto die je opstuurt wordt opgeslagen als de weergave van zijn rol, versleuteld, net als de gegenereerde weergaven.

Via een agent (MCP)

Met de MCP-server vraag je gewoon: "maak een personage van deze foto". De agent gebruikt tendre_character_create (de foto komt via een uploadlink, een bijlage in ChatGPT, een in de conversatie gegenereerde afbeelding of een openbaar adres), toont je de vijf weergaven en genereert een mislukte opnieuw met tendre_character_redo_view. tendre_character_get, tendre_character_list en tendre_character_delete dekken de rest af, en tendre_quote geeft de prijs vooraf.

Cast daarna het personage: zie Multi-Ref Video.

Pro API: maak personages aan voor Multi-Ref Video