Pro API: lag karakterer for Multi-Ref Video

En karakter er et ark med fem visninger av samme person (eller skapning), laget fra ett foto og lagret under en character_id. Det er det Multi-Ref Video bruker for å gjenkjenne noen i et klipp: de fem visningene bærer likheten, uten noen trening.

Karakterene du lagde i appen er allerede der: samme lisens, samme liste (se Karakterer fra appen).

De fem visningene

Hver visning genereres for seg selv: ingen er laget ved å speile en annen.

Lag en karakter

POST /characters (tillatelse images). Arbeidet er asynkront.

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

Svaret, 202, er karakteren med status pending og cost_estimate. Fotoet blir visningen for sin rolle, og serveren genererer de andre fire i løpet av 1 til 3 minutter.

Pris: ett kreditt per generert visning, altså 4 kreditter, pluss 1 med outfit (antrekket tas på først, som et separat steg). En visning som mislykkes belastes ikke. POST /characters/quote gir prisen på forhånd (outfit valgfritt).

Følg med, sjekk, gjenta

GET /characters/{id} gir tilstanden:

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

• Sjekk visningene før første render. GET /characters/{id}/views/{role}/file returnerer bildet. En mislykket visning, eller en som ser feil vei, ødelegger likheten i alle videoer.
• Gjenta en visning: POST /characters/{id}/views/{role}/redo, 1 kreditt. Visningen som kom fra originalfotoet kan ikke gjentas (vue_photo).
• Liste: GET /characters returnerer karakterene dine, inkludert appens, og grensen max.
• Slett: DELETE /characters/{id} sletter karakteren og visningene.

Karakterer fra appen

En karakter laget i appens My characters-skjerm vises i GET /characters med origin app, og spiller i Multi-Ref Video som alle andre. I appen kan en karakter ha flere ark (antrekk, stemninger): sheet_id sier hvilket som brukes (det nyeste som standard), sheets lister dem opp, og ?sheet=<id> ber om et annet ved lesing, på en visnings fil og på en gjentatt visning. I et Multi-Ref-klipp velger characters[].sheet_id arket. For å gjenta en visning av en app-karakter gir du dens kind i kroppen.

Lagring

Visningene er krypterte (én nøkkel per fil) og knyttet til lisensen din. Maks 50 karakterer med Pro-lisensen, appens inkludert. En karakter som ikke er brukt på 15 dager slettes (expires_at): hver Multi-Ref-render og hver lesing av en visning skyver datoen fremover. Fotoet du sender lagres som visningen for sin rolle, kryptert, på samme måte som de genererte visningene.

Via en agent (MCP)

Med MCP-serveren trenger du bare å spørre: "lag en karakter fra dette fotoet". Agenten bruker tendre_character_create (fotoet kommer via en opplastingslenke, en fil vedlagt i ChatGPT, et bilde rendret i samtalen eller en offentlig adresse), viser deg de fem visningene, og gjentar en mislykket visning med tendre_character_redo_view. tendre_character_get, tendre_character_list og tendre_character_delete dekker resten, og tendre_quote gir prisen først.

Sett så inn karakteren: se Multi-Ref Video.