Pro API: luo hahmoja Multi-Ref Video -klippeihin

Hahmo on seitsemän näkymän kokoelma samasta henkilöstä (tai olennosta), luotu yhdestä valokuvasta ja tallennettu character_id-tunnuksen alle. Sitä Multi-Ref Video käyttää tunnistamaan henkilön klipissä: näkymät kantavat samankaltaisuuden ilman erillistä koulutusta. Face swap käyttää niitä myös, asettaakseen hahmon oman videosi henkilön tilalle.

Hahmot, jotka olet luonut sovelluksessa, ovat jo siellä: sama lisenssi, sama lista (katso Sovelluksen hahmot). Sijainnit, esineet ja eläimet tallennetaan samalla tavalla omista kuvistasi ja ne toimivat samoissa klipeissä (katso Sijainnit, esineet ja eläimet).

Seitsemän näkymää

RooliNäkymä
1Rintakuva, edestä, neutraali ilme
4Koko keho, edestä
5Koko keho, takaa
6Koko keho profiilista, hahmo katsoo kuvan vasemmalle puolelle
7Kasvojen lähikuva, edestä
8Asun lähikuva, rinnasta polviin
9Jalkojen lähikuva, kengissä tai paljain jaloin asun mukaan

Jokainen näkymä luodaan erikseen: yhtään niistä ei saada kääntämällä toista peilikuvaksi. Rooleja 2 ja 3 (puoliprofiilin rintakuvat) ei enää luoda 21. lokakuuta 2026 alkaen: aiemmin luodulla hahmolla ne säilyvät, ja niitä voi yhä lukea (näkymän tiedosto, views-lista), mutta ei enää tehdä uudelleen (400 invalid_role).

Luo hahmo

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

json
{ "name": "Lea", "kind": "woman", "image_b64": "<the photo>", "photo_role": "bust" }
KenttäTyyppiMitä se tekee
namemerkkijono, 1-40 merkkiäHahmon etunimi
kindmerkkijonowoman, man tai englanniksi kuvattu olento (baby dragon). Se määrittää ohjeiden pronominit, ei koskaan "they".
image_b64base64Valokuva: terävä, vain yksi henkilö, vähintään 1024 px pitkällä sivulla, enintään 12 MB, JPEG, PNG tai WebP
photo_rolebust (oletus) tai full_bodyValokuva on rintakuva (siitä tulee näkymä 1) tai koko kehon kuva (näkymä 4)
outfitenglanniksi, valinnainenRintakuvana otetun valokuvan kanssa koko kehon näkymän asu (a red leather jacket and black jeans): alavartalo, jota rintakuva ei näytä. Koko kehon valokuvalla valokuva ratkaisee, eikä asua pueta

Vastaus, 202, on hahmo, jonka status on pending ja sisältää cost_estimate. Valokuvasta tulee sen roolin näkymä sellaisenaan (sitä ei koskaan pueta uudelleen), ja palvelin luo muut kuusi 2-5 minuutissa samalla tavalla kuin sovellus: keho (selkä, profiili, asu, jalat) lähtee koko kehon näkymästä, kasvojen lähikuva rintakuvasta. Rintakuva jatketaan koko kehon näkymäksi (outfit-asussa, jos se on annettu); koko kehon valokuvasta saadaan rintakuva rajaamalla.

Hinta: yksi krediitti luotua näkymää kohti, eli 6 krediittiä, outfit-kentän kanssa tai ilman. Epäonnistuneesta näkymästä ei veloiteta. POST /characters/quote antaa hinnan etukäteen.

Saman luonnin lähettäminen uudelleen. Jos yhteys katkeaa ennen vastausta tai agentin odotus keskeytyy, palvelin jatkaa hahmon tekemistä. Lähetä sama pyyntö uudelleen (sama kuva, name, kind, photo_role ja outfit): se palauttaa jo luodun hahmon, jossa on existing: true ja cost_estimate 0, eikä mitään veloiteta kahdesti. Se luo uuden hahmon vain, jos kaikki ensimmäisen generoidut näkymät epäonnistuivat; muutama epäonnistunut näkymä tehdään uudelleen yksi kerrallaan (redo). Jos kaksi samanlaista pyyntöä saapuu samalla hetkellä, toinen saa vastauksen 409 character_busy: lähetä se uudelleen muutaman sekunnin kuluttua.

Seuraa, tarkista, tee uudelleen

GET /characters/{id} antaa sen tilan:

statusMerkitys
pendingNäkymiä luodaan parhaillaan
readyKaikki seitsemän näkymää ovat valmiina
partialJoitakin näkymiä puuttuu tai ne epäonnistuivat
failed, emptyEi käyttökelpoisia näkymiä
json
{
  "character_id": "chr_8f3a...",
  "name": "Lea",
  "kind": "woman",
  "origin": "api",
  "status": "ready",
  "progress": { "ready": 7, "total": 7 },
  "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. Koko kehon näkymät (4, 5 ja 6) luodaan 2K-kokoisina, 1024 x 2048, ja rintakuva ja lähikuvat kokoon 832 x 1216 (jalat 1216 x 832), PNG-muodossa, tai JPEG-muodossa, jos tiedosto on yli 2,9 Mt. Valokuvastasi tehty näkymä säilyttää kokonsa (enintään 2048 px). Jo tehdyt näkymät säilyttävät kokonsa; uudelleen tehty näkymä tulee näissä koissa. Epäonnistunut näkymä tai väärään suuntaan katsova profiili pilaa samankaltaisuuden jokaisessa videossa.
  • Tee näkymä uudelleen: POST /characters/{id}/views/{role}/redo, 1 krediitti: uusi luonti sen lähtökohdasta (koko kehon näkymästä tai rintakuvasta). Alkuperäisestä valokuvasta peräisin olevaa näkymää ei voi tehdä uudelleen (photo_view), outfit-kentän kanssa tai ilman. Sovellukseen yhtenä kuvana tuotua sheetiä (koko sheet sellaisenaan) ei tehdä uudelleen näkymä kerrallaan (409 single_image_sheet).
  • Ohjaa uudelleen tehtyä näkymää: lisää instruction (200 merkkiä, englanniksi) redo-runkoon API:n kautta luodulle hahmolle tai API:n kautta lisätylle character sheetille (muuten 409 app_character). Se täsmentää mitä näkymän täytyy näyttää hahmosta, kuten proteesin puoli tai yksityiskohdan läsnäolo, ei koskaan muuta muutosta: vaate, hiukset, asento, ympäristö ja ilme muutetaan muualla. Kirjoita se imperatiivissa (moottori jättää huomiotta kuvaillun tilan): "Put the robotic arm on her left side only, remove any second robotic arm." Takaa kuvatussa näkymässä (5) nimeä puoli molemmilla tavoilla: "her left arm, which appears on the left side of the image when seen from behind". Sama hinta, 1 krediitti.
  • Lataa oma kuvasi näkymäksi: PUT /characters/{id}/views/{role} yhdessä image_b64:n kanssa (samat säännöt kuin luomisvalokuvalla: vähintään 1024 px pitkällä sivulla, 12 MB, JPEG, PNG tai WebP), API:n kautta luodulle hahmolle tai API:n kautta lisätylle character sheetille (?sheet=). Ilmainen, mitään ei luoda. Kuva säilytetään sellaisenaan ja lasketaan oikeaksi valokuvaksi: myöhemmin uudelleen tehtävät näkymät lähtevät siitä luomisen säännön mukaan (selkä, profiili sekä asun ja jalkojen lähikuvat koko kehon näkymästä, kasvojen lähikuva rintakuvasta).
  • Lista: GET /characters palauttaa hahmosi, sovelluksen hahmot mukaan lukien, sekä enimmäismäärän max.
  • Poista: DELETE /characters/{id} poistaa hahmon ja sen näkymät.

Sovelluksessa (versio 0.8.6 ja uudemmat): API:n tai MCP:n kautta luotu hahmo näkyy sovelluksen My characters -näytöllä samalla lisenssillä, nimellään ja näkymineen, aivan kuten sovelluksessa luodut hahmot. Sovelluksessa uudelleen tehty näkymä korvaa verkkonäkymän, jonka Multi-Ref Video lukee. Sen poistaminen sovelluksessa poistaa sen myös täältä pysyvästi (sovellus pyytää vahvistuksen ensin): putkilinjan, joka säilyttää character_id-tunnuksen, kannattaa varautua 404 unknown_character -vastaukseen sen jälkeen, kun hahmo on poistettu sovelluksessa.

Sovelluksen hahmot

Sovelluksen My characters -näytöllä luotu hahmo näkyy GET /characters -vastauksessa origin-arvolla app ja toimii Multi-Ref Video -klipeissä kuten mikä tahansa muukin hahmo. Sovelluksessa hahmolla voi olla useita character sheetejä (asuja, mielialoja): sheet_id kertoo, mikä niistä tarjotaan (oletuksena viimeisin), sheets listaa ne, ja ?sheet=<id> pyytää toisen lukemiseen, näkymän tiedostoon ja uudelleen tehtyyn näkymään. Multi-Ref -klipissä characters[].sheet_id valitsee character sheetin. Hahmolla on sovelluksen profiilin name ja kind heti, kun sovellus on lähettänyt ne (sovellus 0.9.1 ja uudemmat; sitä ennen molemmat ovat null). Tehdäksesi uudelleen näkymän sovelluksen hahmolle, jonka kind on yhä null, anna sen kind rungossa.

Ääni. has_voice kertoo, onko hahmon profiilin ääni verkossa: sovellus lähettää sen hahmon mukana, ja Face swap ja Multi-Ref Video käyttävät sitä oletuksena.

Lisää hahmolle asu

POST /characters/{id}/sheets antaa olemassa olevalle hahmolle uuden character sheetin (asun, tyylin), oli hahmo luotu API:n kautta tai sovelluksessa, sovelluksen valmiit hahmot mukaan lukien. Hahmo säilyttää muut character sheettinsä. Vastaus, 202, on hahmo uuden character sheetin kanssa: sen sheet_id (alkaa api-), sheet_name, sheet_outfit, sheet_origin: "api" ja cost_estimate.

json
{ "name": "steampunk", "outfit": "brass aviator goggles, long black leather coat", "kind": "woman",
  "views": { "1": "<base64>", "4": "<base64>" } }
KenttäTyyppiMitä se tekee
namemerkkijono, 1-40 merkkiäCharacter sheetin nimi
outfitenglanniksi, enintään 700 merkkiäPuettava asu; pakollinen ilman views-kenttää
viewsobjekti, rooli "1" tai "4"-"9": kuva base64-muodossaValmiit näkymät, samoin säännöin kuin näkymän latauksessa
generatetrue (oletus) tai falseLuodaanko puuttuvat roolit vai ei yhtään
from_sheet_idmerkkijono, valinnainenIlman views-kenttää: character sheet, josta lähdetään
kindmerkkijonoVain sovelluksessa luodulle hahmolle, jonka kind on yhä null reitissä GET /characters, kuten luonnissa
  • views-kentän kanssa: lähettämäsi näkymät tallennetaan sellaisinaan, ilmaiseksi. Puuttuvat roolit luodaan, 1 krediitti näkymältä, luomisen säännön mukaan lähettämästäsi koko kehon näkymästä ja rintakuvasta; jos kumpaakaan ei ole, kuten ilman views-kenttää. generate: false ei luo yhtään.
  • Ilman views-kenttää: asu puetaan hahmon koko kehon näkymään (rintakuvaan, jos sellaista ei ole; from_sheet_id lähtee toisesta character sheetistä). Tuloksesta tulee uuden character sheetin koko kehon näkymä, ja kuusi muuta näkymää lähtevät siitä: 7 luotua näkymää, 7 krediittiä. cost_estimate kertoo hinnan. Jos lähdesheet (from_sheet_id tai oletus) on tällainen yksittäinen kuva, lähetä näkymä 4 (koko vartalo) tai 1 (rintakuva) kentässä views (409 single_image_sheet).
  • Käytä character sheetiä kuten muitakin, ?sheet=<sheet_id>-parametrilla: GET /characters/{id}-kutsussa, näkymän tiedostossa, redo-kutsussa (instruction mukaan lukien) ja näkymän PUT-kutsussa. Multi-Ref-klipissä sen valitsee characters[].sheet_id.
  • Sovelluksen hahmolle anna sheet_id: oletuksena tarjotaan edelleen viimeksi muokattu character sheet, eli juuri lisäämäsi.
  • Lisätyn character sheetin poisto: DELETE /characters/{id}/sheets/{sheet_id} poistaa vain sen näkymät. Sovelluksessa tehtyä character sheetiä ei voi poistaa näin (404 unknown_sheet).
  • Sovelluksessa: saman lisenssin sovellus tuo uuden character sheetin hahmon profiiliin.
  • Virheet: 400 outfit_or_views_required (ei asua eikä näkymiä), 400 views_required (generate: false ilman näkymää), 409 source_sheet_empty (ei koko kehon näkymää eikä rintakuvaa lähtökohdaksi), 409 character_busy.

Sijainnit, esineet, eläimet, tyylit ja asut

Kohde on sijainti (location), esine (object: ajoneuvo, rekvisiitta, huonekalu...), eläin (animal), tyyli (style: tunnelmakuvia, joiden ilmeen video omaksuu) tai asu (outfit: hahmon käyttämä vaate), tallennettu 1-6 omasta kuvastasi (useat kulmat tekevät siitä uskollisemman), jotta voit käyttää sitä uudelleen Multi-Ref Video -klipeissä kuvailematta sitä uudelleen jokaisessa otoksessa. Mitään kuvaa ei luoda, joten se on ilmainen.

Ilman kuvia palvelin voi myös luoda sen: katso Kohteen luominen ilman kuvia.

POST /subjects (oikeus images):

json
{ "type": "animal", "name": "Rex", "description": "a small brown dog with a red collar", "images_b64": ["<image 1>", "<image 2>"] }
KenttäTyyppiMitä se tekee
typelocation, object, animal, style tai outfitMitä kohde on
nameyksi sana, 1-40 kirjainta, numeroa tai _Sana, joka kirjoitetaan @-merkin jälkeen promptissa
descriptionenglanniksi, enintään 300 merkkiä, valinnainena glossy white futuristic tram with round windows
images_b641-6 kuvaa base64-muodossaJPEG, PNG tai WebP, vähintään 512 px pitkällä sivulla, enintään 12 MB kukin (28 MB koko rungolle: sen jälkeen lisää loput yksitellen)

Vastaus, 201, on kohde: subject_id, type, name, description, origin, sen images (jokainen file_url-osoitteen kera), complete ja expires_at.

  • Lisää kuva: POST /subjects/{id}/images yhdessä image_b64:n kanssa (enintään 6).
  • Lista: GET /subjects (?type=location suodattamiseen) palauttaa kohteesi, mukaan lukien sovelluksen Library-kohdat (origin app), sekä enimmäismäärän max. Sovelluksen kohde, jonka kaikkia kuvia ei vielä ole synkronoitu, näyttää complete: false: se toimii jo olemassa olevilla kuvilla.
  • Lahjoitetut elementit: Tendre.AI tarjoaa valmiita elementtejä, joilla on kiinteä id (esimerkiksi officiel-red-beetle, esine). Kukin lisätään listaasi kerran, kun luet sen ensimmäisen kerran (GET /subjects, MCP tendre_subject_list), eikä se lasketa rajaan max. Sen jälkeen se on kohde kuten muutkin: käytettävissä Multi-Refissä (subject_id), muokattavissa ja poistettavissa; poistettuna se ei koskaan palaa.
  • Lue: GET /subjects/{id}; yksi kuva: GET /subjects/{id}/images/{n}/file.
  • Muuta: PUT /subjects/{id} yhdessä type-, name-, description- ja/tai images_b64-kentän kanssa (täydellinen lista, joka korvaa kuvat).
  • Poista: DELETE /subjects/{id}, täältä ja sovelluksesta.

Tyyli antaa klipille sen ilmeen: sen description kertoo tekniikan englanniksi (loose watercolor painting on textured paper), ei sitä, mitä sen kuvat esittävät. Asu on vaate, jota hahmo käyttää. Tyylit ja asut toimivat vain Multi-Ref Video -klipeissä Ultra-tilassa.

Sijoittaaksesi kohteen klippiin, katso Multi-Ref Video; kuvaan, katso Create an image.

Kohteen luominen ilman kuvia

Eikö kuvaa ole käsillä? POST /subjects/generate (oikeus images) tekee kohteen samoin kuin sovelluksen Elements-osion "Generate"-ikkuna: aloituskuvan kuvauksesi pohjalta (tai tuotuna) ja sitten siitä lähteviä näkymiä (muita kulmia, lähikuva, yöllä...), joista jokainen muokataan aloituskuvasta, jotta muoto pysyy samana. Tulos on tavallinen kohde: se toimii Multi-Ref Videossa ja Create an imagessa, ja se näkyy sovelluksen kirjastossa.

KenttäTyyppiMitä se tekee
typeobject, location, animal, style tai outfitMikä kohde on (liikettä ei luoda)
nameyksi sana, 1-40 kirjainta, numeroa tai _Sana, joka kirjoitetaan @-merkin jälkeen promptissa
descriptionenglanninkielinen teksti, enintään 300 merkkiäPelkkä elementti: muoto, materiaalit, värit, yksityiskohdat, ilman taustaa ja ilman hahmoa (a glossy white futuristic tram with round windows). Pakollinen, paitsi jos annetaan prompt tai start_image_b64
promptenglanninkielinen teksti, enintään 2 000 merkkiä, valinnainenAloituskuvan koko teksti description-kentästä tehdyn automaattisen tekstin sijaan
start_image_b64kuva base64-muodossa, valinnainenTuotu aloituskuva (vähintään 512 px), säilytetään sellaisenaan ja ilmainen
viewsavainten luettelo, valinnainenHaluamasi näkymät järjestyksessä (taulukko alla)
count1-6, valinnainenviews-kentän sijaan: kuvien määrä yhteensä aloitus mukaan lukien (taulukon ensimmäiset näkymät)
seedkokonaisluku, valinnainenAloituskuvan seed
quote_onlytruePalauttaa vain hinnan, mitään ei luoda

Näkymät tyypeittäin (pysyvät avaimet), tyypin tulostusmuodossa:

typeMuotoviews
object1024 × 1024three_quarter, side, back, top, detail (lähikuva)
location1216 × 832reverse_shot, side, high_angle, night, detail (lähikuva)
animal1216 × 832front, three_quarter, back, sitting, lying
style1024 × 1024portrait, landscape, interior, object, animal
outfit832 × 1216three_quarter, side, back, detail (lähikuva)

Hinta: jokainen renderöity kuva (aloitus ja jokainen näkymä) maksaa yhden kuvan hinnan (1 krediitti); tuotu aloitus on ilmainen, eikä epäonnistunutta kuvaa veloiteta. Enintään 6 kuvaa kohdetta kohden, aloitus mukaan lukien. Vastaus, 202, on kohde, jossa on cost_estimate ja generation:

json
"generation": {
  "status": "pending",
  "start": { "status": "ready", "origin": "generated", "n": 1 },
  "views": [{ "key": "three_quarter", "status": "ready", "n": 2 }, { "key": "detail", "status": "pending" }],
  "available_views": ["three_quarter", "side", "back", "top", "detail"]
}

Seuraa sitä GET /subjects/{id} -kutsulla, kunnes generation.status ei enää ole pending (ready, partial tai failed); n on kuvan numero images-luettelossa. Kuvat tehdään yksi kerrallaan: aloitus ja sitten näkymät järjestyksessä. Virhe pysäyttää sarjan: seuraavat näkymät muuttuvat tilaan failed, ilman veloitusta.

  • Lisää näkymiä: POST /subjects/{id}/views ja views (avaimet, joita ei ole vielä tehty). Yhden näkymän kanssa instructions (englanniksi, enintään 1 000 merkkiä) korvaa sen ohjeen: kerro, mitä näkymän pitää näyttää.
  • Uusi näkymä: POST /subjects/{id}/views/{key}/redo, tarvittaessa instructions-kentän kanssa. Näkymä lähtee taas aloituskuvasta ja korvaa edellisen (sama n).
  • Uusi aloitus: POST /subjects/{id}/views/start/redo, vain niin kauan kuin siitä ei ole lähtenyt yhtään näkymää (muuten views_exist); tuotua aloitusta ei voi uusia. Aloituksen virheen pysäyttämät näkymät tehdään uudelleen sen jälkeen.
  • quote_only: true antaa hinnan kaikilla kolmella reitillä. Yksi sarja kerrallaan kohdetta kohden (subject_busy).

Alusta loppuun, esine kahdella näkymällä:

http
POST /pro/v1/subjects/generate

{ "type": "object", "name": "Tram", "description": "a glossy white futuristic tram with round windows", "views": ["three_quarter", "detail"] }

Vastaus, 202, antaa subject_id:n ja generation.status-arvon pending. Kysy GET /subjects/{id} muutaman sekunnin välein, kunnes se on ready, ja käytä sitten @Tram-viittausta tällä subject_id:llä. Kolme kuvaa (aloitus ja kaksi näkymää), eli kolme kertaa yhden kuvan hinta.

Tallennus

Hahmon näkymät ja kohteen kuvat ovat salattuja (yksi avain tiedostoa kohti) ja sidottu lisenssiisi. Kohteen kuvat säilytetään sellaisina kuin ne lähetit, ja ne jaetaan sovelluksen Libraryn kanssa. Pro-lisenssin enimmäismäärät: 50 hahmoa, sovelluksen hahmot mukaan lukien, ja 50 kohdetta (sijainnit, esineet, eläimet, tyylit ja asut yhteensä) laskettuna erikseen (10 henkilökohtaisella lisenssillä sovelluksessa). Vuoden käyttämättömänä ollut hahmo tai kohde poistetaan (expires_at): jokainen Multi-Ref -renderöinti, jokainen Face swap ja jokainen näkymän tai kuvan luku siirtää päivämäärää eteenpäin. Hahmon luomiseen lähettämäsi valokuva säilytetään sen roolin näkymänä, salattuna, kuten luodut näkymätkin. Voit poistaa minkä tahansa niistä milloin tahansa.

Agentin kautta (MCP)

MCP-palvelimen avulla pyydät vain: "tee hahmo tästä valokuvasta". Agentti käyttää tendre_character_create-toimintoa (valokuva tulee latauslinkin, ChatGPT:hen liitetyn tiedoston, keskustelussa renderöidyn kuvan tai julkisen osoitteen kautta), näyttää sinulle seitsemän näkymää ja tekee epäonnistuneen uudelleen tendre_character_redo_view-toiminnolla, tarvittaessa instruction-kentän kanssa, tai korvaa sen omalla kuvillasi tendre_character_set_view-toiminnon kautta. tendre_character_get, tendre_character_list ja tendre_character_delete kattavat loput, ja tendre_quote antaa hinnan ensin.

Sijaintia, esinettä tai eläintä varten anna agentille kuvasi ja kerro mitä se on: se käyttää tendre_subject_create-toimintoa, sitten tendre_subject_list-, tendre_subject_get- ja tendre_subject_delete-toimintoja. Ilman kuvia se käyttää tendre_subject_generate-toimintoa ja sitten tendre_subject_add_views- ja tendre_subject_redo_view-toimintoja näkymän lisäämiseen tai uusimiseen.

Sijoita sitten hahmo klippiin: katso Multi-Ref Video.

Windows · Mac · Pilvi tai paikallinen

Generoi yksityisesti. Tänään.

Lataa tendre.AI ilmaiseksi ja luo rajattomasti, yksityisesti, omalla GPU:llasi.

OS Windows 10/11GPU NVIDIA 8GB+VRAM 12GB suositeltuLevytila 20GB

Mac, jossa Applen siru (M1 tai uudempi): macOS 13 tai uudempi. Intel Mac: macOS 12 tai uudempi, kaikki toimii verkossa.

Paikallinen kuvien generointi Macilla vaatii M4-sirun ja 24 Gt muistia, tai M2- tai M3 Pro-, Max- tai Ultra-sirun ja 24 Gt muistia. Tätä heikommilla malleilla kaikki toimii verkossa krediittejä käyttäen. Retusointi ja video toimivat toistaiseksi Macilla vain verkossa.

Kaikki tietoa tendre.AI:sta Macille

Ei NVIDIA-GPU:ta? Aloita 100% pilvessä: 5 ilmaista kuvaa ja 1 ilmainen video joka päivä. NVIDIA-kortti (8Gt+) avaa rajoittamattoman paikallisen generoinnin.