En karaktär är ett blad med fem vyer av samma person (eller varelse), skapad från ett foto och lagrad under ett character_id. Det är vad Multi-Ref Video använder för att känna igen någon i ett klipp: de fem vyerna bär likheten, utan träning.

Karaktärerna du skapade i appen finns redan där: samma licens, samma lista (se Karaktärer från appen).

De fem vyerna

Roll	Vy
1	Byst, framifrån, neutralt uttryck
2	Byst, tre-kvarts, karaktären tittar mot höger i bilden, lätt leende
3	Byst, tre-kvarts, karaktären tittar mot vänster i bilden, neutral
4	Helfigur, framifrån
5	Helfigur, bakifrån

Varje vy genereras separat: ingen skapas genom att spegla en annan.

Skapa en karaktär

POST /characters (behörighet images). Arbetet är asynkront.

json

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

Fält	Typ	Vad det gör
`name`	sträng, 1 till 40 tecken	Karaktärens förnamn
`kind`	sträng	`woman`, `man` eller en varelse beskriven på engelska (`baby dragon`). Styr pronomen i instruktionerna, aldrig "they".
`image_b64`	base64	Fotot: skarpt, en person, minst 1024 px på den långa sidan, max 12 MB, JPEG, PNG eller WebP
`photo_role`	`bust` (standard) eller `full_body`	Fotot är en byst (det blir vy 1) eller en helfigur (vy 4)
`outfit`	Engelsk text, valfritt	Ett plagg att ta på sig först (`a red leather jacket and black jeans`)

Svaret, 202, är karaktären med status pending och cost_estimate. Fotot blir vyn för sin roll och servern genererar de fyra övriga på 1 till 3 minuter.

Pris: en kredit per genererad vy, alltså 4 krediter, plus 1 med outfit (plagget tas på sig först som ett separat steg). En vy som misslyckas debiteras inte. POST /characters/quote ger priset i förväg (outfit valfritt).

Följ, kontrollera, gör om

GET /characters/{id} ger dess tillstånd:

`status`	Betydelse
`pending`	Vyerna håller på att skapas
`ready`	De fem vyerna finns
`partial`	Vissa vyer saknas eller misslyckades
`failed`, `empty`	Ingen användbar vy

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

Kontrollera vyerna innan den första renderingen. GET /characters/{id}/views/{role}/file returnerar bilden. En misslyckad vy, eller en som tittar åt fel håll, förstör likheten i varje video.
Gör om en vy: POST /characters/{id}/views/{role}/redo, 1 kredit. Vyn som kom från det ursprungliga fotot kan inte göras om (vue_photo).
Lista: GET /characters returnerar dina karaktärer, inklusive appens, och gränsen max.
Radera: DELETE /characters/{id} tar bort karaktären och dess vyer.

Karaktärer från appen

En karaktär som skapats på appens My characters-skärm visas i GET /characters med origin app och fungerar i Multi-Ref Video precis som alla andra. I appen kan en karaktär ha flera blad (kläder, stämningar): sheet_id anger vilket som visas (det senaste som standard), sheets listar dem och ?sheet=<id> begär ett annat vid läsning, vid en vys fil och vid en omgjord vy. I ett Multi-Ref-klipp väljer characters[].sheet_id bladet. Ange karaktärens kind i bodyn när du vill göra om en vy för en appkaraktär.

Lagring

Vyerna är krypterade (en nyckel per fil) och kopplade till din licens. Högst 50 karaktärer med Pro-licensen, inklusive appens. En karaktär som inte används på 15 dagar raderas (expires_at): varje Multi-Ref-rendering och varje läsning av en vy skjuter fram datumet. Fotot du skickar sparas som vyn för sin roll, krypterat, precis som de genererade vyerna.

Via en agent (MCP)

Med MCP-servern räcker det att du säger: "skapa en karaktär från det här fotot". Agenten använder tendre_character_create (fotot skickas via en uppladdningslänk, en fil bifogad i ChatGPT, en bild renderad i konversationen eller en publik adress), visar dig de fem vyerna och gör om en misslyckad vy med tendre_character_redo_view. tendre_character_get, tendre_character_list och tendre_character_delete täcker resten och tendre_quote ger priset först.

Sätt sedan in karaktären: se Multi-Ref Video.

Pro API: skapa karaktärer för Multi-Ref Video