Ein Charakter ist ein Sheet mit fünf Ansichten derselben Person (oder Kreatur), erstellt aus einem Foto und gespeichert unter einer character_id. Das ist es, was Multi-Ref Video verwendet, um jemanden in einem Clip zu erkennen: Die fünf Ansichten tragen die Ähnlichkeit, ganz ohne Training.

Die Charaktere, die du in der App erstellt hast, sind bereits vorhanden: gleiche Lizenz, gleiche Liste (siehe Charaktere aus der App).

Die fünf Ansichten

Rolle	Ansicht
1	Büste frontal, neutraler Ausdruck
2	Büste ¾ rechts, der Charakter schaut zur rechten Bildseite, leichtes Lächeln
3	Büste ¾ links, der Charakter schaut zur linken Bildseite, neutral
4	Ganzkörper frontal
5	Ganzkörper, Rücken oder Profil

Jede Ansicht wird einzeln generiert: Keine entsteht durch Spiegeln einer anderen.

Einen Charakter erstellen

POST /characters (Berechtigung images). Die Verarbeitung läuft asynchron.

json

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

Feld	Typ	Funktion
`name`	String, 1 bis 40 Zeichen	Der Vorname des Charakters
`kind`	String	`woman`, `man` oder eine auf Englisch beschriebene Kreatur (`baby dragon`). Legt die Pronomen der Anweisungen fest, nie "they".
`image_b64`	base64	Das Foto: scharf, nur eine Person, mindestens 1024 px auf der langen Seite, maximal 12 MB, JPEG, PNG oder WebP
`photo_role`	`bust` (Standard) oder `full_body`	Das Foto ist eine Büste (wird zu Ansicht 1) oder eine Ganzkörperaufnahme (Ansicht 4)
`outfit`	Englischer Text, optional	Ein Outfit, das zuerst angelegt wird (`a red leather jacket and black jeans`)

Die Antwort, 202, ist der Charakter mit status pending und cost_estimate. Das Foto wird zur Ansicht seiner Rolle, und der Server generiert die anderen vier in 1 bis 3 Minuten.

Preis: ein Credit pro generierter Ansicht, also 4 Credits, plus 1 bei outfit (das Outfit wird zuerst angelegt, als separater Schritt). Eine fehlgeschlagene Ansicht wird nicht berechnet. POST /characters/quote gibt den Preis vorab zurück (outfit optional).

Verfolgen, prüfen, neu erstellen

GET /characters/{id} gibt den aktuellen Zustand zurück:

`status`	Bedeutung
`pending`	Die Ansichten werden gerade erstellt
`ready`	Alle fünf Ansichten sind vorhanden
`partial`	Einige Ansichten fehlen oder sind fehlgeschlagen
`failed`, `empty`	Keine verwendbare Ansicht

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

Prüfe die Ansichten vor dem ersten Render. GET /characters/{id}/views/{role}/file gibt das Bild zurück. Eine fehlgeschlagene Ansicht oder eine, die in die falsche Richtung schaut, beeinträchtigt die Ähnlichkeit in jedem Video.
Ansicht neu erstellen: POST /characters/{id}/views/{role}/redo, 1 Credit. Die Ansicht, die aus dem Originalfoto stammt, kann nicht neu erstellt werden (vue_photo).
Liste: GET /characters gibt deine Charaktere zurück, einschließlich der aus der App, sowie das Limit max.
Löschen: DELETE /characters/{id} löscht den Charakter und seine Ansichten.

Charaktere aus der App

Ein in der Meine Charaktere-Ansicht der App erstellter Charakter erscheint in GET /characters mit origin app und kann in Multi-Ref Video wie jeder andere verwendet werden. In der App kann ein Charakter mehrere Sheets haben (Outfits, Stimmungen): sheet_id gibt an, welches verwendet wird (standardmäßig das neueste), sheets listet sie auf, und ?sheet=<id> fragt beim Lesen, bei der Ansichtsdatei und bei einer neu erstellten Ansicht ein anderes an. In einem Multi-Ref Clip wählt characters[].sheet_id das Sheet aus. Um eine Ansicht eines App-Charakters neu zu erstellen, gib sein kind im Body an.

Speicher

Die Ansichten sind verschlüsselt (ein Schlüssel pro Datei) und an deine Lizenz gebunden. Mit der Pro-Lizenz sind maximal 50 Charaktere möglich, einschließlich der aus der App. Ein Charakter, der 15 Tage lang nicht verwendet wurde, wird gelöscht (expires_at): Jeder Multi-Ref Render und jedes Lesen einer Ansicht verschiebt das Datum nach hinten. Das von dir gesendete Foto wird als Ansicht seiner Rolle gespeichert, verschlüsselt, genau wie die generierten Ansichten.

Über einen Agenten (MCP)

Mit dem MCP-Server sagst du einfach: "Erstelle einen Charakter aus diesem Foto". Der Agent verwendet tendre_character_create (das Foto kommt über einen Upload-Link, eine in ChatGPT angehängte Datei, ein im Gespräch gerendertes Bild oder eine öffentliche Adresse), zeigt dir die fünf Ansichten und erstellt eine fehlgeschlagene mit tendre_character_redo_view neu. tendre_character_get, tendre_character_list und tendre_character_delete decken den Rest ab, und tendre_quote gibt den Preis vorab.

Dann den Charakter besetzen: siehe Multi-Ref Video.

Pro API: Charaktere für Multi-Ref Video erstellen