Postać to zestaw pięciu widoków tej samej osoby (lub stworzenia), wykonany z jednego zdjęcia i przechowywany pod character_id. Tego właśnie używa Multi-Ref Wideo, aby rozpoznać kogoś w klipie: pięć widoków przenosi podobieństwo bez żadnego trenowania.

Postacie utworzone w aplikacji są już dostępne: ta sama licencja, ta sama lista (zob. Postacie z aplikacji).

Pięć widoków

Rola	Widok
1	Popiersie z przodu, neutralny wyraz twarzy
2	Popiersie ¾ w prawo, postać patrzy w prawą stronę obrazu, lekki uśmiech
3	Popiersie ¾ w lewo, postać patrzy w lewą stronę obrazu, neutralna
4	Cała sylwetka z przodu
5	Cała sylwetka, tył lub profil

Każdy widok jest generowany osobno: żaden nie powstaje przez odbicie lustrzane innego.

Utwórz postać

POST /characters (uprawnienie images). Praca jest asynchroniczna.

json

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

Pole	Typ	Co robi
`name`	ciąg znaków, 1 do 40 znaków	Imię postaci
`kind`	ciąg znaków	`woman`, `man` lub stworzenie opisane po angielsku (`baby dragon`). Określa zaimki w instrukcjach, nigdy "they".
`image_b64`	base64	Zdjęcie: wyraźne, tylko jedna osoba, co najmniej 1024 px po dłuższym boku, maksymalnie 12 MB, JPEG, PNG lub WebP
`photo_role`	`bust` (domyślnie) lub `full_body`	Zdjęcie jest popiersiem (staje się widokiem 1) lub ujęciem całej sylwetki (widok 4)
`outfit`	tekst po angielsku, opcjonalnie	Strój do nałożenia jako pierwszy (`a red leather jacket and black jeans`)

Odpowiedź, 202, to postać ze status pending i cost_estimate. Zdjęcie staje się widokiem swojej roli, a serwer generuje pozostałe cztery w ciągu 1 do 3 minut.

Cena: jeden kredyt za wygenerowany widok, czyli 4 kredyty, plus 1 przy użyciu outfit (strój jest nakładany jako pierwszy, w osobnym kroku). Za nieudany widok nie pobiera się opłaty. POST /characters/quote podaje cenę z wyprzedzeniem (outfit opcjonalnie).

Śledź, sprawdzaj, ponawiaj

GET /characters/{id} zwraca stan postaci:

`status`	Znaczenie
`pending`	Widoki są tworzone
`ready`	Pięć widoków jest gotowych
`partial`	Niektóre widoki brakuje lub są nieudane
`failed`, `empty`	Brak użytecznego widoku

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

Sprawdź widoki przed pierwszym renderem. GET /characters/{id}/views/{role}/file zwraca obraz. Nieudany widok lub taki, który patrzy w złą stronę, psuje podobieństwo w każdym filmie.
Ponów widok: POST /characters/{id}/views/{role}/redo, 1 kredyt. Widoku pochodzącego z oryginalnego zdjęcia nie można ponawiać (vue_photo).
Lista: GET /characters zwraca twoje postacie, w tym te z aplikacji, oraz limit max.
Usuń: DELETE /characters/{id} usuwa postać i jej widoki.

Postacie z aplikacji

Postać utworzona na ekranie Moje postacie w aplikacji pojawia się w GET /characters z origin app i działa w Multi-Ref Wideo jak każda inna. W aplikacji postać może mieć kilka character sheet (stroje, nastroje): sheet_id wskazuje, który jest serwowany (domyślnie najnowszy), sheets je wyświetla, a ?sheet=<id> pozwala wybrać inny przy odczycie, przy pliku widoku i przy ponawianym widoku. W klipie Multi-Ref Wideo characters[].sheet_id wybiera character sheet. Aby ponowić widok postaci z aplikacji, podaj jej kind w treści żądania.

Przechowywanie

Widoki są szyfrowane (jeden klucz na plik) i powiązane z twoją licencją. Maksymalnie 50 postaci przy licencji Pro, wliczając te z aplikacji. Postać nieużywana przez 15 dni jest usuwana (expires_at): każdy render Multi-Ref Wideo i każdy odczyt widoku przesuwa tę datę. Zdjęcie, które wysyłasz, jest przechowywane jako widok swojej roli, zaszyfrowane, tak samo jak wygenerowane widoki.

Przez agenta (MCP)

Dzięki serwerowi MCP wystarczy poprosić: "utwórz postać z tego zdjęcia". Agent używa tendre_character_create (zdjęcie trafia przez link do przesyłania, plik dołączony w ChatGPT, obraz wyrenderowany w rozmowie lub publiczny adres), pokazuje ci pięć widoków i ponawia nieudany widok za pomocą tendre_character_redo_view. tendre_character_get, tendre_character_list i tendre_character_delete obsługują resztę, a tendre_quote podaje cenę z wyprzedzeniem.

Następnie obsadź postać: zob. Multi-Ref Wideo.

Pro API: tworzenie postaci dla Multi-Ref Wideo