Pro API: videoiden luominen äänellä

Klippi promptista tai animaatio itse toimittamastasi still-kuvasta. Tiedosto on MP4, ja siinä on ääni kun sitä pyydät.

Lähetä video

POST /videos

{ "prompt": "a woman in a white linen dress walks along a beach at sunset, wind in her hair, she turns and smiles at the camera",
  "width": 1080, "height": 1920, "audio": true }

Oletusruudunopeus: 30 fps. Klipit renderöitiin aiemmin 24 fps:llä. Ilman fps-kenttää sama length tuottaa siis lyhyemmän klipin kuin ennen (241 kehystä: 8 s 10 s:n sijaan). Lähetä "fps": 24 pitääksesi vanhan toiminnan.

Vastaus:

{ "jobId": "...", "seed": 908172, "cost": 30 }

Hinta lasketaan ja ilmoitetaan lähetyksen yhteydessä, ennen kuin mitään veloitetaan. seed palautetaan myös, olitpa antanut sen tai se arvottiin satunnaisesti.

Formaatit ja hinta

Video hinnoitellaan formaatin mukaan kiinteänä hintana, pituudesta riippumatta. Perushinta: 5 krediittiä.

Kiinteä hinta kerrotaan kahdella 720p:ssä ja kolmella 1080p:ssä, jonka jälkeen ääni kaksinkertaistaa hinnan. Kertoimet sovelletaan perushintaan, eivät toisiinsa: 1080p äänellä maksaa 5 x 3 x 2 = 30 krediittiä. Enintään 481 kehystä eli 20 s 24 fps:llä, pituus ei vaikuta hintaan (5 s tai 20 s, sama hinta). Yli 481 kehyksen (enintään 721, vain consistency enhanced -tilassa, kiinteä pituus) formaatin hinta kaksinkertaistuu. Ruudunopeus (fps) ei muuta hintaa, mutta tasojen rajat lasketaan kehyksinä: 30 fps:llä normaali hinta kattaa 16 s:n; 60 fps:llä 8 s:n (12 s kaksinkertaisella hinnalla enhanced-tilassa).

Yksi poikkeus: Quality-tilassa 480p ilman ääntä maksaa 2 krediittiä, pituudesta riippumatta (11. lokakuuta 2026 alkaen). Multi-Ref ja parannettu konsistenssi pitävät formaatin kiinteän hinnan, 5 krediittiä.

Saamasi koko. Moottori toimii 32:n monikertaisissa ja kahdessa vaiheessa, joten tiedosto tulee ulos koossa 768 x 1280 (tai 1280 x 768) 720p:ssä ja 1088 x 1920 (tai 1920 x 1088) 1080p:ssä. 480p pysyy koossa 480 x 832 (tai 832 x 480), paitsi parannetussa konsistenssissa. Hyvä tietää jos yhdistät tai päällystät renderöintejämme.

turbo-kaista poistettiin käytöstä 11. lokakuuta 2026: turbo-pyyntö renderöidään Quality 480p -tilassa ja hinnoitellaan sen mukaan (2 krediittiä ilman ääntä, 10 äänellä).

Tiedä hinta ennen lähetystä

POST /videos/quote ottaa saman rungon kuin POST /videos ja suorittaa saman laskelman, mutta mitään ei luoda: ei renderöintiä, ei krediittejä pidätetä, ei kiintiötä kuluteta. Kutsu sitä ennen sitoutumista, etenkin agentilta joka toimii budjetin puitteissa.

{ "cost": 30, "mode": "ltx25", "format": "1080p", "audio": true, "fps": 30, "duration_auto": true,
  "seconds_max": 16, "detail": "flat 5 x 3 (1080p) x 2 (sound) = 30" }

detail selittää luvun; fps on käytetty ruudunopeus ja seconds_max kesto sekunteina kyseisellä nopeudella. "consistency": "enhanced" -tilassa tarjous hyväksyy kiinteän pituuden enintään 721 kehykseen ja soveltaa yli 481 kehyksen hintaa (x 2 (over 20 s) detail-kentässä 24 fps:llä, x 2 (over 481 frames) muilla nopeuksilla). Sama reitti on olemassa kuville: POST /images/quote vastaa aina { "cost": 1, ... }: kuva maksaa aina 1 krediitti.

Sekunneittain laskutettavalle Ultra-klipille tarjous antaa laskutettavan pituuden kentässä seconds, ja detail erittelee sekuntihinnan.

Pollaa, lataa, peruuta

Samat reitit kuin kuville, /videos-polun alla.

• GET /videos/{jobId}: pending / completed / failed, samat kentät. Parannettu jatko-otto voi päättyä failed-tilaan virheellä "error": "extension_not_applied" (moottori ei jatkanut edellisen klipin loppua): mitään ei veloiteta, lähetä uudelleen.
• GET /videos/{jobId}/file: MP4 (Content-Type: video/mp4).
• POST /videos/{jobId}/cancel: peruuttaa, eikä mitään veloiteta.

Sekunneittain laskutettavassa Ultra-tilassa jo laskennassa oleva renderöinti ei enää pysähdy: peruutus vastaa 409 render_in_progress, ja klippi toimitetaan ja laskutetaan. Klippi, jonka moottori hylkää ulostulossa, päättyy tilaan failed, jolloin detail sisältää lauseen ja reason moottorin koodin: mitään ei veloiteta.

Video kestää 1-5 minuuttia, pidempään jos moottori käynnistyy kylmänä. Pollaa 3 sekunnin välein ja lataa heti kun tila on completed: tiedostoa ei arkistoida.

Useita ottoja yhdessä klipissä

Yksi prompt voi sisältää useita ottoja kovilla leikkauksilla, yhteensä enintään 20 sekuntia 24 fps:llä (16 s 30:llä, joka on oletus). Kuvaile ne järjestyksessä: Shot 1: <rajaus>, <toiminta>. Cut to Shot 2: .... Toista jokaisessa otossa se, mikä pitää pysyä samana (hahmo, asu, paikka, valo), ja päätä yhdellä yhteistä tunnelmaa kuvaavalla lauseella.

Jätä aikakoodit pois: pidä duration_auto päällä, ja moottori valitsee pituuden (enintään 20 s 24 fps:llä, 16 s 30:llä) sekä leikkauskohdat. Kaksi tai neljä ottoa per klippi toimii parhaiten.

A cinematic sequence of three shots, same woman, same place, same lighting throughout.
Shot 1: Wide shot, night, light rain on a narrow Paris street with glowing café windows. A woman in a long beige trench coat walks toward the camera under a transparent umbrella, wet cobblestones reflecting warm yellow streetlights.
Cut to Shot 2: Close-up on her face under the umbrella, raindrops on the plastic, warm café light on her cheek, she smiles softly.
Cut to Shot 3: Medium shot from inside the café through the rainy window, she pushes the door open and steps in, warm light spilling onto the wet pavement.
Calm, melancholic, romantic mood.

Useita ottoja yhdessä klipissä vai sekvenssi? Ne tekevät eri asioita:

Jatka klippiä

Klippiä voidaan jatkaa: seuraava otto jatkaa edellisen liikettä ilman pysähdystä liitoskohdassa. Sitä ohjaa karkeasti edellisen klipin viimeinen sekunti, ei yksittäinen still-kehys. Lisää POST /videos -kutsuun:

Jatko-otto pitää edellisen klipin resoluution: width ja height jätetään huomiotta extend_job_id:n kanssa, ja extend_video:n kanssa koko luetaan lähettämästäsi tiedostosta. Se sisältää vain uudet kehykset, joten peräkkäin asetetut otot muodostavat yhtenäisen videon. Se pitää edellisen klipin ruutunopeuden: jätä fps pois (se ottaa sen käyttöön) tai anna sama; eri nopeudella pyyntö hylätään (extend_fps_mismatch). length on uuden oton kesto (121 = 5 s lisää 24 fps:llä), ja se on tarkka: automaattinen kesto ei koske jatko-ottoja. Jatko-otto maksaa klipin hinnan.

Rajoitukset: ei loppukehystä tai keyframeja samanaikaisesti, paitsi parannetussa konsistenssissa.

Ääni jatkuu liitoskohdassa. audio: true -asetuksella, kun edellisen klipin lopussa on ääniraita, uusi otto jatkaa kyseistä ääntä uuden luomisen sijaan. extend_job_id:n kanssa katkaistu loppu pitää klipin äänen; extend_video:n kanssa lähetä loppu äänineen. Ilman ääniraitaa kyseisessä lopussa, parannetussa konsistenssissa ja Ultra-tilassa ääni alkaa uutena oton alusta: pidä sama ambient jokaisen promptin sisältönä, jotta liitos kuuluu mahdollisimman vähän.

Jatka klippiä pian sen valmistuttua. Myöhemmin se ei ole enää käytettävissämme (clip_unavailable), ja lähetät itse sen lopun extend_video-kentässä.

Ultra-oton jatkaminen eteen- tai taaksepäin

Ultra-tilassa sekunneittain renderöityä ottoa jatketaan myös Ultra-tilassa, eteenpäin tai taaksepäin; muita klippejä jatketaan kuten yllä. Lähetä POST /videos kentällä "quality": "max" ja:

• Renderöinti sisältää vain uuden osan, Ultra-klipin mittaisena (length / fps, automaattisella kestolla 5 s). Se saa oton resoluution (width ja height ohitetaan) ja liittyy sen viimeiseen kehykseen (forward) tai ensimmäiseen (backward).
• Ei aloituskuvaa, viitteitä (multiref), liikettä eikä parannettua konsistenssia. backward ei mene sekvenssiin, joka asettaa ottonsa peräkkäin.
• Hinta: uusi osa Ultran sekuntihintaan, ja lisäksi jatkettavan oton jokaisesta sekunnista 2 krediittiä 480p:ssä, 5 720p:ssä ja 13 1080p:ssä (ultra.extend_per_second GET /pricing -vastauksessa). Sekunnit pyöristetään ylöspäin täyteen sekuntiin (0,1 s:n tarkkuudella) ja lasketaan 24 kehyksellä sekunnissa: suuremman kuvataajuuden otto lasketaan suhteessa (2 s 60 fps:llä lasketaan 5 sekunniksi). POST /videos/quote samoilla kentillä antaa extend_seconds-arvon ja tarkan hinnan.
• Yli 24 tuntia vanha otto: lataa sen alkuperäinen tiedosto sellaisena kuin GET /videos/{jobId}/file sen toimitti. POST /extensions kentällä { "size": <tavua> } palauttaa upload_id, upload_url, headers ja expires_in (900 s); lähetä tiedosto PUT upload_url -kutsulla täsmälleen näillä headers-otsakkeilla ja anna sitten extend_upload_id 2 tunnin kuluessa. Yksi lataus kelpaa yhteen renderöintiin: MP4, 4-30 s, enintään 60 MB ja 1080p. Ennen renderöintiä jokainen Ultra-tilaan lähetetty video (liike tai jatkettava video) tarkistetaan, eikä mitään veloiteta, jos se hylätään (400 input_video_out_of_limits): 24-60 kuvaa sekunnissa, leveyden ja korkeuden suhde 0,4-2,5 ja yhtä renderöintiä kohden enintään 30 s ja 10 tiedostoa videoille ja viiteäänille yhteensä. Realistisen kasvon kohdalla uudelleenkoodattu tai muokattu tiedosto hylätään (400 engine_refused): vain alkuperäinen kelpaa. Videota, jota Ultra-tila ei renderöinyt (esimerkiksi toisen tilan renderöintiä), ei jatketa Ultrassa, jos siinä näkyy realistiset kasvot (400 extension_real_face, mitään ei veloiteta): jatka sitä Quality-tilassa tai tee otto uudelleen Ultrassa.

Parannettu konsistenssi

"consistency": "enhanced" -asetuksella klippi renderöidään kaistalla, joka pitää liikkeen, kasvot ja taustan tasaisempana ajan kuluessa. Se kattaa enintään 721 kehystä per otto, eli 30 s 24 fps:llä ja 24 s 30:llä (length, kiinteä pituus) ja on tarkoitettu pääasiassa pitkille videoille:

• Ensimmäinen otto: normaali klippi (prompt, alkukehys, keyframes, end_image), enintään 721 kehystä.
• Jatko-otto: extend_job_id (tai extend_video) kuten Jatka klippiä -kohdassa, samalla consistency-asetuksella. length on edelleen uuden oton kesto (enintään 721, eli 30 s lisää 24 fps:llä). Parannettu jatko-otto ottaa myös keyframes-kentän, jonka at lasketaan ensimmäisestä uudesta kehyksestä, sekä loppukehys end_image asetettuna oton viimeiselle kehykselle: esimerkiksi ensimmäisen oton alkukehys, jotta pitkä video toistuu silmukkana.

Vain Quality-tila (mode ltx25, ilman quality: "max"), enintään 1080p, ei Multi-Ref-tilassa (400 consistency_mode). Hinta: formaatin kiinteä hinta (480p ilman ääntä: 5 krediittiä) enintään 481 uudella kehyksellä (20 s 24 fps:llä), kaksinkertaistuu sen ylittyessä (katso ylläoleva hinnasto). Ruudunopeudet: 24, 30, 50 tai 60. Yli 30:lla pituus on kiinteä (fps_requires_fixed_duration muuten); 50 antaa lievän hidastuksen (katso fps). Renderöinti kestää pidempään kuin tavallinen klippi, ja sen alku voi odottaa isompaa näytönohjainta (pitkät otot). Sekvenssi pitää saman consistency-asetuksen kaikissa otoissaan. Toimitettu koko: sama kuin Quality-tilassa 720p:ssä ja 1080p:ssä; 480p:ssä lyhyt sivu on 448 (448 x 832, 832 x 448, 448 x 448), koska tämä kaista toimii 64:n monikertaisissa.

Joitakin prompteja ei tueta vielä. Niitä varten yksittäinen otto, joka on enintään 20 s (15 s end_image-kentän kanssa, kiinteällä pituudella), renderöidään standard-konsistenssilla samaan hintaan. Sen ylittyessä (length yli 481 duration_auto: false -asetuksella, tai yli 361 end_image-kentän kanssa), jatko-otossa tai sekvenssisssä pyyntö hylätään virheellä 400 consistency_explicit: lyhennä ottoa tai pyydä consistency: "standard".

Pitkä video (sekvenssit)

Klippi kestää enintään 481 kehystä, eli 20 s 24 fps:llä (721 parannetun konsistenssin kanssa, 30 s 24 fps:llä). Pidempää varten sekvenssi tallentaa jokaisen oton sitä mukaa kuin renderöinti valmistuu, sitten liittää ne yhdeksi MP4-tiedostoksi uudelleen enkoodaamatta. Esimerkiksi yksi minuutti on 3 ottoa à 20 s tai 2 ottoa à 30 s parannetussa konsistenssissa 24 fps:llä.

1. POST /sequences avaa sekvenssin ja vastaa { "sequence_id": "seq_...", ... }.
2. POST /videos "sequence_id": "seq_..." -kentällä jokaiselle otolle: ensimmäinen tavalliseen tapaan, seuraavat extend_job_id-kentällä asetettuna edelliseen ottoon. Jokainen otto tallennetaan sekvenssiin lähetysjärjestyksessä heti kun GET /videos/{jobId} näkee sen valmiina.
3. POST /sequences/{id}/export kun viimeinen otto on valmis. Se vastaa seconds-, resolution- ja file_url-kentillä.
4. GET /sequences/{id}/file: koottu video (MP4).

Lisäksi: GET /sequences/{id} antaa tilan (tallennetut tai vielä odottavat otot), POST /sequences/{id}/clips { "job_id": "..." } -kentällä tallentaa renderöinnin käsin, ja DELETE /sequences/{id} poistaa sekvenssin heti.

Säännöt. Jokaisella otolla on sama resoluutio (jatko-otot pitävät sen) ja sama äänenvalinta, kaikki äänellä tai kaikki äänettömänä, sama consistency ja sama ruudunopeus (fps): ensimmäinen otto asettaa ne, ja siitä poikkeava otto hylätään (409 consistency_mismatch, 409 sequence_fps_mismatch; 422 encoding_mismatch käsin tallennetulle otolle). Otto ilman fps-kenttää ottaa sekvenssin nopeuden. Enintään 30 ottoa per sekvenssi ja 5 sekvenssisssä käynnissä per lisenssi.

Mitä säilytämme ja kuinka kauan. Käynnissä olevan sekvenssin otot poistetaan 30 minuuttia viimeisen lisäyksen jälkeen, ja koottu video 24 tuntia viennin jälkeen. Sen jälkeen kaikki on poissa.

Projektikansion vienti

Projektikansio kokoaa yhteen ZIP-tiedostoon kaiken, mitä tarvitset videon jatkamiseen muualla tai sen automatisointiin: otot, niiden referenssit, leikkauksen ja manifestin, jolla jokaisen oton voi renderöidä uudelleen. Se on maksuton: mitään ei renderöidä.

• POST /videos/{jobId}/export: yksi POST /videos -renderöinti (yksittäinen otto, Multi-Ref, jatko).
• POST /sequences/{id}/project: sekvenssin kaikki otot peräkkäin.
• Valinnainen runko, samat valinnat kuin sovelluksen vienti-ikkunassa:
  • include_media (oletuksena true): ottojen videot ja niiden allekirjoitetut alkuperäiset. false: ei yhtään videota (ei leikettä, alkuperäistä eikä elokuvaa); otot säilyttävät tekstinsä, asetuksensa ja referenssinsä ("state": "expired"), ja manifestissa on videos_included: false.
  • include_references (oletuksena true): hahmojen näkymät ja elementtien kuvat, kansiossa references/. false: mitään ei kopioida; nimet, @maininnat, id ja sormenjäljet jäävät manifestiin (references_included: false).
  • exclude_references: referenssit, joita ei kopioida, yksi kerrallaan, id:n (character_id, subject_id), nimen tai @maininnan perusteella, esimerkiksi ["@Parc", "chr_..."] (enintään 200). Manifestissa on references_included: "partial" ja jokaisella pois jätetyllä "included": false (false, jos kaikki on jätetty pois). Merkintä, joka ei osoita mihinkään viennin referenssiin: 400 unknown_reference.
  • include_film (vain sekvenssi, oletuksena false): jo kootun sekvenssin elokuva; vaatii include_media-valinnan (muuten 400 invalid_export_options, kuten valinta, joka ei ole totuusarvo, tai exclude_references, joka ei ole tekstien luettelo).
  • manifest_only: true: pelkkä manifesti ilman ZIP-tiedostoa.

Vastaus on { "manifest": { ... }, "file_url": "...", "export_id": "exp_...", "expires_at": "...", "bytes": n }, ja GET /exports/{id}/file lataa ZIP-tiedoston. Yksi vienti kerrallaan lisenssiä kohden (409 export_in_progress), enintään 2 Gt (413 export_too_large: vie otot yksi kerrallaan).

Mitä säilytämme ja kuinka kauan. Jokaisesta hyväksytystä POST /videos -pyynnöstä palvelin säilyttää renderöinnin tiedot ilman yhtään kuvaa tai videota: tekstin, asetukset ja tunnisteet (base64-muodossa lähetetystä kuvasta jää vain sen tunniste-tiiviste). Ne poistetaan 24 tuntia lähettämisen jälkeen; sen jälkeen vienti vastaa 404 unknown_export. ZIP-tiedosto poistetaan 45 minuuttia ensimmäisen latauksen jälkeen, viimeistään 2 tuntia luomisesta. Otto, jota palvelimella ei enää ole, tulee tilalla "state": "expired", ilman tiedostoa mutta tekstin, asetusten ja referenssien kanssa: agentti voi renderöidä sen uudelleen api_request-kentällä.

Sekvenssi. Kokoaminen poistaa otot yksi kerrallaan. Jos haluat sekä otot että elokuvan, vie projekti ennen kokoamista, kokoa sitten ja vie uudelleen arvolla { "include_film": true }: elokuva lisätään, ja otot tulevat silloin tilalla expired.

Ultra-tila

Ultra-tila on hienoin videorenderöinti. Lisää "quality": "max" pyyntöön POST /videos (kun mode on ltx25, oletus). Se laskutetaan sekunneittain, tai kiinteään hintaan LoRA:n kanssa tai jatko-otossa, jos jatkettavaa klippiä ei ole renderöity sekunneittain; Ultra-oton jatko, eteen- tai taaksepäin, laskutetaan sekunneittain. POST /videos/quote antaa pyyntösi tarkan hinnan.

Sekunneittain

Klippi laskutetaan sekunneittain sen resoluution mukaan, ääni mukaan lukien:

• Pituus: vähintään 4 ja enintään 30 s, 24 kuvaa sekunnissa, tiedossa ennen renderöintiä: 5 s automaattisella pituudella (duration_auto, oletus), muuten length / fps (24, jos fps puuttuu), pyöristettynä sekuntiin.
• Formaatti: pyydetty, lähimmällä kuvasuhteella; 480p renderöidään 480p:nä. Yli 1080p: resolution_outside_ultra.
• Alkukuva (image): mahdollinen. Moottori voi hylätä tekstin tai kuvan lähetettäessä: 400 engine_refused, syy kentässä detail ja koodi kentässä code; mitään ei veloiteta.
• Ei siementä: seed ohitetaan, eikä vastaus anna sitä.
• Peruutus: vapaa niin kauan kuin renderöinti odottaa vuoroaan; laskennan alettua 409 render_in_progress, ja klippi toimitetaan ja laskutetaan.
• Ultra-tilassa ei ole loppukuvaa, keyframeja eikä parannettua konsistenssia.

Kiinteään hintaan

LoRA:n kanssa tai jatko-otossa, jos jatkettavaa klippiä ei ole renderöity sekunneittain, Ultra renderöidään täydellä videomallilla, kiinteään hintaan:

Hinta on kiinteä formaattikohtaisesti: ääni ja pituus eivät vaikuta siihen. Ultra alkaa 720p:stä: 480p-pyyntö renderöidään ja laskutetaan 720p:nä. POST /videos/quote antaa tarkan hinnan. 1080p (1920 x 1088) on yläraja kaikissa tiloissa: 4K:ta ei enää tarjota. Suurempi koko hylätään (ultra_4k_unavailable kun quality: "max", muuten resolution_above_quality).

• Pituus: enintään 481 kehystä kuten mikä tahansa klippi (20 s 24 fps:llä, 16 s 30:llä, 8 s 60:llä). Jatko-otot ja pitkät videot toimivat Ultra-tilassa myös. Jatko-otto pitää jatkamansa klipin koon, ja alle 720p:ssä se laskutetaan 720p-hinnalla.
• Aika: useita minuutteja 5 s:n klipille, pidempään 20 s:n klipille. Alku voi odottaa ison näytönohjaimen vapautumista.
• Ei siirtymää (end_image) Ultra-tilassa (ultra_incompatible).
• Ei keyframeja (keyframes) Ultra-tilassa (keyframes_mode).
• Tilillä oleva hahmo-LoRA toimii Ultra-tilassa kuten normaalitilassa.

Multi-Ref Video

Klippi, jossa 1-4 hahmoa (Ultra-tilassa enintään 12) esiintyy, jokainen tunnistettavana, valinnaisessa sijainnissa tallennettuja objekteja, eläimiä ja tallennettua sijaintia käyttäen tarpeen mukaan. Hahmot tulevat GET /characters -reitistä: luotu yhdestä valokuvasta API:n kautta tai sovelluksessa. Objektit, eläimet ja sijainnit tulevat kentästä GET /subjects. Lisää multiref-objekti POST /videos -kutsuun (lupa videos) ja kutsu jokaista hahmoa @Nimi-muodolla promptissa:

{
  "prompt": "@Lea walks toward @Tom in a sunny kitchen and hands him a cup. Sound: footsteps, soft music.",
  "multiref": {
    "characters": [
      { "character_id": "chr_8f3a...", "name": "Lea", "description": "a 28 year old woman with long red hair" },
      { "character_id": "chr_21bc...", "name": "Tom", "description": "a 30 year old man", "strength": 1.2 }
    ],
    "background_b64": "<optional: an image of the location>",
    "background_description": "a sunny kitchen"
  },
  "width": 1088, "height": 1920,
  "audio": true
}

• Prompt englanniksi, yksi kappale preesensissä; Sound: ääntä varten, vuorosanat lainausmerkeissä, exactly 2 people ja missä kukin seisoo kun se auttaa, ei kielteisiä muotoja. Olento kuvataan sillä mitä se on. @Nimi joka ei vastaa mitään hahmoa hylätään (unknown_mention).
• Formaatit (width x height): pysty 480 x 832, 720 x 1280, 1088 x 1920; vaaka 832 x 480, 1280 x 720, 1920 x 1088; neliö 480 x 480, 720 x 720, 1088 x 1088. Ei 4K; 480p vain Quality-tilassa.
• Tilat: Quality (oletus) tai Ultra (quality: "max"). Ei jatko-ottoa eikä siirtymää.
• Pituus: automaattinen (duration_auto, oletus) tai kiinteä duration_auto: false -asetuksella ja length 121 (5 s), 241 (10 s) tai 481 (20 s) 24 fps:llä; muilla nopeuksilla samat kestot kehyksinä laskettuna, enintään 481 (30:llä: 145, 297, 481; 60:llä: 297, 481).
• Ruudunopeus: fps 24, 30 (oletus) tai 60 kuten millä tahansa klipillä; length laskee kehykset tällä nopeudella, enintään 481 (16 s 30:llä, 8 s 60:llä).
• Hinta: klipin hinta. Quality-tilassa formaatin kiinteä hinta yllä olevasta hinnastosta, kaksinkertaistettuna äänellä; 480p ilman ääntä pysyy 5 krediitissä (Quality-tilan alhainen hinta ei koske Multi-Refiä). POST /videos/quote "multiref": true -kentällä antaa tarkan hinnan.
• Palvelin sovittaa näkymät videon tarkkaan formaattiin: lähetä hahmot sellaisinaan. Hahmo, jolla on vain yksi näkymä, renderöidään vastauksessa warnings-kentällä limited_likeness: samankaltaisuus on rajallinen.
• Profiilien äänet: äänen kanssa characters[0] ja characters[1] puhuvat oletuksena profiilinsa äänellä, kun se on verkossa (has_voice); voice generated antaa mallin tehdä äänen. Vastaus kertoo kunkin äänen kentässä voices (character_id, voice: character, custom tai generated).
• Hahmojen äänet (voice_b64): malli saa hahmon puhumaan kyseisellä äänellä, huulet mukaan lukien; palvelin ottaa ensimmäiset 5 sekuntia. Enintään kaksi ääntä, characters[0]:lla ja characters[1]:llä (moottori tukee 2 ääntä). Järjestä characters dialogin mukaan: characters[0] puhuu ensin, characters[1] vastaa. Vaatii äänen ("audio": true), muuten voice_requires_audio; ääni muulla hahmolla: voice_slot; lukukelvoton tiedosto: unsupported_audio_format; yli 4 MB: audio_too_large. Vain ensimmäiset 5 sekuntia käytetään: lähetä lyhyt pätkä. Koko pyyntörunko pysyy alle 30 MB:ssä (sen ylittyessä 413 ilman JSON-runkoa). Ei lisäveloitusta.
• Pollaus, lataus ja peruutus tapahtuvat kuten mille tahansa videolle (katso Pollaa, lataa, peruuta yllä).

Tallennetut objektit, eläimet ja sijainnit. Kaksi lisäkenttää multiref-objektissa asettaa subjects-kohteet, jotka olet tallentanut omista kuvistasi:

name oletuksena on kohteen nimen ensimmäinen sana, ja jokainen @Nimi promptissa yhdistetään kuten hahmon nimi. Sijainti subjects-kentässä tai objekti location-kentässä hylätään (invalid_subject_type). Hinta ei muutu: se on klipin hinta. Kohteesta käytetään sen 5 ensimmäistä kuvaa (Ultra-tilassa kaikki, enintään 6).

"multiref": {
  "characters": [{ "character_id": "chr_8f3a...", "name": "Lea" }],
  "subjects": [{ "subject_id": "sub_1c2d...", "name": "Rex" }],
  "location": { "subject_id": "sub_9e8f...", "name": "Loft" }
},
"prompt": "@Lea throws a ball to @Rex across @Loft. Sound: barking, laughter."

Ultra-tilassa Multi-Ref-klippi noudattaa sekunneittain laskutettavan Ultran sääntöjä: sama sekuntihinta, ääni mukaan lukien, vähintään 4 ja enintään 30 s 24 kuvalla sekunnissa (5 s automaattisella pituudella), 480p:stä 1080p:hen, ei siementä.

• Jokainen hahmo lähtee character sheetinsä kanssa (tai ilman sitä kaikkien kuviensa kanssa), ja palvelin kokoaa kaiken yhdeksi kuvaksi; jokainen esine, eläin tai paikka kaikkien kuviensa kanssa (enintään 6).
• Hahmon ensimmäinen renderöinti valmistelee tämän kuvan, mikä vie muutamia kymmeniä sekunteja enemmän: sen jobId alkaa silloin sdp- ja sitä seurataan kuten muita.
• Ei ääntä: voice_b64 ja profiilin ääni ohitetaan (warnings voice_ignored), eikä strength vaikuta.
• Moottori voi hylätä viitekuvan (esimerkiksi oikeat kasvot): renderöinti päättyy tilaan failed syineen, eikä mitään veloiteta.

Tyylit, asut ja liike. Vain Ultra-tilassa (quality: "max"): kolme multiref-kenttää lisää; muualla pyyntö hylätään (multiref_ultra_only), eikä sitä koskaan renderöidä ilman niitä.

• Enintään 30 kuvaa Ultra-tilassa, hahmot, kohteet, tyylit, asut ja sijainti yhteensä (multiref_too_many_images), joista enintään 12 hahmoa (sen yli multiref_characters_required). Suositus on 8: 9-12 hahmolla renderöinti etenee warnings-kentän many_characters-varoituksen kanssa, koska osa voi puuttua tai sekoittua. Tyyli styles-kentän ulkopuolella tai asu outfits-kentän ulkopuolella hylätään (invalid_subject_type).
• Liikkeen hinta: 3 krediittiä liikevideon sekunnilta (pyöristettynä ylöspäin täyteen sekuntiin), renderöinnin lisäksi, luettavissa GET /pricing -vastauksesta (ultra.motion_per_second); POST /videos/quote samalla multiref.motion-kentällä antaa motion_seconds-arvon ja tarkan hinnan.
• Suora lataus raskaalle liikevideolle: POST /motions kentällä { "size": <tavua> } (enintään 20 MB) palauttaa motion_id, upload_url, headers ja expires_in (900 s); lähetä tiedosto PUT upload_url -kutsulla täsmälleen näillä headers-otsakkeilla ja anna sitten multiref.motion.motion_id POST /videos -kutsulle 2 tunnin kuluessa. Yksi motion_id kelpaa yhteen renderöintiin.

"quality": "max",
"multiref": {
  "characters": [{ "character_id": "chr_8f3a...", "name": "Lea" }],
  "styles": [{ "subject_id": "sub_a1b2..." }],
  "outfits": [{ "subject_id": "sub_c3d4...", "name": "RedGown", "worn_by": "Lea" }],
  "motion": { "motion_id": "4f0c2a9b1d7e6a35", "description": "a low tracking shot from the side" }
},
"prompt": "@Lea walks along a seaside promenade at sunset."

Tyylien, asujen ja liikkeen virhekoodit löytyvät sivulta Rajat ja virheet.

MCP-palvelimen kanssa agentti hoitaa kaiken tämän tendre_multiref_video-toiminnolla: kuvaile kohtaus ja nimeä hahmot, objektit, eläimet ja sijainti (subjects, location_id).

Face swap

Omalla videollasi kuvattu henkilö muuttuu yhdeksi hahmoistasi: kasvot, hiukset, vartalo ja asu (tai vain pää, katso part), ja hänen eleensä, huulensa ja ympäristönsä säilyvät, samoin ääni, ellei hahmolla ole omaa ääntä (katso voice). Se on sovelluksen Face swap yhdellä enintään 20 sekunnin jaksolla: yksi hahmo, ilman ketjutusta ja ilman siirtymää. Pyyntö on POST /faceswap (lupa videos):

{
  "video_b64": "<the video in base64: MP4, MOV, WebM or MKV, 20 MB at most>",
  "character_id": "chr_8f3a...",
  "start": 2,
  "duration": 6,
  "scene": "@Lea wears a long red coat.",
  "zone": "normal",
  "likeness": 1
}

Video ja ääni yhteensä: enintään 22 Mt, jotta pyynnön runko pysyy alle 30 Mt:n (sen yli tulee 413 ilman JSON-runkoa).

• Palvelin valmistelee kaiken. Se leikkaa jakson, asettaa sen työkuvanopeuteen (30 fps lähteelle, jonka nopeus on 29 fps tai enemmän, myös 50 ja 60, muuten 24) ja työmuotoon (128:n kerrannaiset, lyhyt sivu 768, videotasi lähinnä oleva kuvasuhde) ja sovittaa hahmon näkymät tähän muotoon.
• Saat takaisin jakson videon työmuodossa, noin yksi megapikseli (esimerkiksi 768 x 1408 pystyvideolle), videosi mittasuhteilla 5 %:n tarkkuudella. Täysi resoluutio ja useampi hahmo peräkkäin ovat tendre.AI-tietokonesovelluksen omia: se liittää hahmon takaisin alkuperäiseen videoon sen täydellä resoluutiolla ja ketjuttaa useita hahmoja.
• Hinta: 6 krediittiä valmistellun jakson sekunnilta (seconds vastauksessa), pyöristettynä ylöspäin seuraavaan krediittiin. Vastaus antaa jobId, seed, cost ja valmistellun jakson (width, height, length, fps, seconds, audio, voice, views, part). Hahmo, jolla on vain yksi näkymä, renderöidään varoituksella warnings limited_likeness.
• Ei hinta-arviota: POST /videos/quote tai MCP:n tendre_quote ei tunne Face swapia. Laske hinta ennen lähettämistä lukemalla grid.body_swap reitistä GET /pricing: jakson sekunnit x per_block_720p (lohkon hinta) / block_seconds (lohkon kesto), pyöristettynä ylöspäin seuraavaan krediittiin.
• Jotkin kohtaukset renderöidään hahmon kolmesta päähän rajatusta muotokuvasta (heads_only vastauksessa), eikä sen näkymien asua enää pakoteta: kohtaus päättää.
• Face swap lasketaan hahmon käytöksi ja siirtää sen poistamista myöhemmäksi, kuten Multi-Ref.
• Seuranta, lataus ja peruutus ovat samat kuin minkä tahansa videon (katso yllä): GET /videos/{jobId}, GET /videos/{jobId}/file, POST /videos/{jobId}/cancel.
• Omat virheet: video_required, video_too_large, unreadable_video, invalid_start, passage_too_short, invalid_duration, invalid_zone, invalid_likeness, invalid_scene, invalid_description, invalid_character_name, invalid_part, invalid_voice_choice, character_required, unknown_character, audio_too_large (yli 2 Mt:n ääni), face_swap_too_large (jakso on yhä liian raskas valmistelun jälkeen: lyhennä duration), server_busy (kahta videota valmistellaan jo: yritä uudelleen Retry-After-ajan, 20 s, jälkeen), face_swap_unavailable ja face_swap_price_missing (Face swap suljettu tai ilman hintaa: yritä myöhemmin). Mitä kukin tarkoittaa: Rajat ja virheet.
• Videosi kulkee palvelimiemme kautta sen valmistelun ajan ja siirtyy sitten näytönohjaimelle, joka renderöi sen, kuten mikä tahansa lähdekuva.

Käytä vain videoita henkilöistä, jotka ovat antaneet suostumuksensa: se on käyttöehtojen sääntö.

MCP-palvelimen kanssa agentti tekee kaiken tämän työkalulla tendre_face_swap.