Pro API: opret karakterer til Multi-Ref Video

En karakter er et ark med fem vinkler af den samme person (eller skabning), lavet fra ét foto og gemt under et character_id. Det er det, som Multi-Ref Video bruger til at genkende nogen i en klip: de fem vinkler bærer ligheden uden nogen træning.

De karakterer du lavede i appen er allerede der: samme licens, samme liste (se Karakterer fra appen).

De fem vinkler

Hver vinkel genereres for sig: ingen er opnået ved at spejlvende en anden.

Opret en karakter

POST /characters (tilladelse images). Arbejdet er asynkront.

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

Svaret, 202, er karakteren med status pending og cost_estimate. Fotoet bliver til vinklen for sin rolle, og serveren genererer de andre fire på 1 til 3 minutter.

Pris: ét kredit per genereret vinkel, altså 4 kreditter, plus 1 med outfit (outfittet tages på først som et separat trin). En vinkel der fejler opkræves ikke. POST /characters/quote giver prisen på forhånd (outfit valgfri).

Følg, tjek, lav om

GET /characters/{id} giver dens tilstand:

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

• Tjek vinklerne før den første rendering. GET /characters/{id}/views/{role}/file returnerer billedet. En fejlet vinkel, eller én der kigger den forkerte vej, ødelægger ligheden i alle videoer.
• Lav en vinkel om: POST /characters/{id}/views/{role}/redo, 1 kredit. Den vinkel der kom fra det originale foto kan ikke laves om (vue_photo).
• Liste: GET /characters returnerer dine karakterer, appens inkluderet, og grænsen max.
• Slet: DELETE /characters/{id} sletter karakteren og dens vinkler.

Karakterer fra appen

En karakter oprettet i appens My characters-skærm vises i GET /characters med origin app, og spiller i Multi-Ref Video som alle andre. I appen kan en karakter have flere ark (outfits, stemninger): sheet_id angiver hvilket der leveres (det nyeste som standard), sheets lister dem, og ?sheet=<id> beder om et andet ved læsning, ved en vinkels fil og ved en genlavet vinkel. I en Multi-Ref-klip vælger characters[].sheet_id arket. Når du vil lave en vinkel om for en app-karakter, angiv dens kind i body.

Lagring

Vinklerne er krypterede (én nøgle per fil) og knyttet til din licens. 50 karakterer maks. med Pro-licensen, appens inkluderet. En karakter der ikke bruges i 15 dage slettes (expires_at): enhver Multi-Ref-rendering og enhver læsning af en vinkel skubber datoen frem. Det foto du sender gemmes som vinklen for sin rolle, krypteret, ligesom de genererede vinkler.

Via en agent (MCP)

Med MCP-serveren beder du bare om: "lav en karakter fra dette foto". Agenten bruger tendre_character_create (fotoet kommer via et upload-link, en fil vedhæftet i ChatGPT, et billede renderet i samtalen eller en offentlig adresse), viser dig de fem vinkler, og laver en fejlet om med tendre_character_redo_view. tendre_character_get, tendre_character_list og tendre_character_delete dækker resten, og tendre_quote giver prisen først.

Sæt derefter karakteren i en klip: se Multi-Ref Video.