Pro API: luo hahmoja Multi-Ref Videoon

Hahmo on viiden näkymän arkki samasta henkilöstä (tai olennosta), joka on tehty yhdestä valokuvasta ja tallennettu character_id:n alle. Tätä Multi-Ref Video käyttää henkilön tunnistamiseen klipissä: viisi näkymää kantaa kasvonpiirteet ilman koulutusta.

Sovelluksessa luomasi hahmot ovat jo siellä: sama lisenssi, sama lista (katso Sovelluksen hahmot).

Viisi näkymää

Jokainen näkymä luodaan erikseen: yhtäkään ei saada kääntämällä toista.

Luo hahmo

POST /characters (oikeus images). Työ on asynkroninen.

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

Vastaus, 202, on hahmo, jolla on status pending ja cost_estimate. Valokuvasta tulee sen roolin näkymä, ja palvelin luo neljä muuta 1-3 minuutissa.

Hinta: yksi krediitti luotua näkymää kohden, eli 4 krediittiä, plus 1 outfit-kentällä (asu puetaan ensin erillisenä vaiheena). Epäonnistuneesta näkymästä ei veloiteta. POST /characters/quote antaa hinnan etukäteen (outfit valinnainen).

Seuraa, tarkista, tee uudelleen

GET /characters/{id} näyttää sen tilan:

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

• Tarkista näkymät ennen ensimmäistä renderöintiä. GET /characters/{id}/views/{role}/file palauttaa kuvan. Epäonnistunut näkymä tai väärään suuntaan katsova näkymä pilaa kasvonpiirteet jokaisessa videossa.
• Tee näkymä uudelleen: POST /characters/{id}/views/{role}/redo, 1 krediitti. Alkuperäisestä valokuvasta saatua näkymää ei voi tehdä uudelleen (vue_photo).
• Lista: GET /characters palauttaa hahmosi, sovelluksen hahmot mukaan lukien, sekä rajan max.
• Poista: DELETE /characters/{id} poistaa hahmon ja sen näkymät.

Sovelluksen hahmot

Sovelluksen My characters -näytöllä luotu hahmo näkyy kohteessa GET /characters arvolla origin app, ja se toimii Multi-Ref Videossa kuten mikä tahansa muu. Sovelluksessa hahmolla voi olla useita arkkeja (asuja, mielialoja): sheet_id kertoo, mikä niistä tarjoillaan (oletuksena uusin), sheets listaa ne ja ?sheet=<id> pyytää toista lukemisen, näkymätiedoston ja uudelleen tehdyn näkymän yhteydessä. Multi-Ref-klipissä characters[].sheet_id valitsee arkin. Tee sovellushahmon näkymä uudelleen antamalla sen kind rungossa.

Tallennus

Näkymät ovat salattuja (yksi avain tiedostoa kohden) ja sidottuja lisenssiisi. Enintään 50 hahmoa Pro-lisenssillä, sovelluksen hahmot mukaan lukien. 15 päivää käyttämättä oleva hahmo poistetaan (expires_at): jokainen Multi-Ref-renderöinti ja jokainen näkymän luku siirtää päivämäärää eteenpäin. Lähettämäsi valokuva säilytetään roolinsa näkymänä salattuna, aivan kuten luodut näkymätkin.

Agentin kautta (MCP)

MCP-palvelimen avulla sinun tarvitsee vain pyytää: "tee hahmo tästä valokuvasta". Agentti käyttää tendre_character_create-toimintoa (valokuva tulee lataauslinkin, ChatGPT:ssä liitetyn tiedoston, keskustelussa renderöidyn kuvan tai julkisen osoitteen kautta), näyttää sinulle viisi näkymää ja tekee epäonnistuneen uudelleen tendre_character_redo_view-toiminnolla. tendre_character_get, tendre_character_list ja tendre_character_delete hoitavat loput, ja tendre_quote antaa hinnan ensin.

Sijoita sitten hahmo: katso Multi-Ref Video.