{ "aboutHtml": "

Seedance 2.0 Fast on ByteDance Seedin nopeuteen suunnattu Seedance 2.0 -perheen versio. Se tukee videon ja äänen yhteisgenerointia sekä tekstistä, kuvista, videosta ja äänestä rakennettua multimodaalista tehtävänantoa. Luoviin kykyihin kuuluvat uudet viitevetoiset kohtaukset, olemassa olevan aineiston muokkaukset ja kohtauksen jatkaminen. Dokumentoidut tulostetasot ovat 480p ja 720p.

Multimodaalinen viite: aineiston roolien määrittäminen

Kuva voi antaa hahmon, tuotteen, sommittelun tai visuaalisen käsittelyn. Viitevideo voi antaa toiminnan, kameraliikkeen tai tehosteen. Viiteääni voi antaa puheäänen sointivärin, musiikillisen melodian tai vuoropuhelusisällön. Selitä, minkä osan kustakin lähteestä haluat siirtää uuteen kohtaukseen; viite on hyödyllisempi, kun sillä on tietty luova rooli.

Esimerkiksi: ”Käytä Image 1:n keraamista lamppua tuotteena. Seuraa Video 1:n hidasta kameran kiertoa mutta sijoita lamppu rauhalliseen lukunurkkaukseen. Käytä Audio 1:tä musiikilliseen tunnelmaan.” Tarkoitettu tulos on uusi kohtaus, joka yhdistää valitun ulkoasun, liikkeen ja äänisuunnan, ei kaikkien viiteyksityiskohtien määrittelemätön jäljittely.

Dokumentoidut yhdistelmät sisältävät kuvat ja äänen, kuvat ja videon, videon ja äänen sekä kaikki kolme yhdessä. Pelkkää tekstiä ja ääntä tai pelkkää äänisyötettä ei tueta. Malli tukee myös tekstistä videoksi -tilaa ja kuvapohjaista generointia ensimmäisestä ruudusta tai ensimmäisen ja viimeisen ruudun parista. Kun tarkka päätepiste on tehtävänannon ytimessä, käytä erillistä päätepistetyönkulkua; viitekuvan kuvaaminen päätepisteeksi omni-viitekehotteessa on epäsuoraa ohjausta.

Olemassa olevan videon muokkaaminen

Malli voi lisätä, poistaa tai muokata elementtejä, korvata kohteen ja piirtää uudelleen tai korjata kohtauksen osia. Määritä lähdevideo, muutettava esine ja säilytettävät elementit. Kuvaa lisäykselle esiintymispaikka ja -aika. Tunnista poistettava esine johdonmukaisesti koko leikkeessä.

Käytännön muokkaustehtävänanto voi korvata esittelyn tavallisen pullon Image 1:n pullolla ja pyytää säilyttämään Video 1:n käden liikkeen, taustan ja kameraradan. Tarkista sekä korvaus että vakaiksi tarkoitetut alueet. Selkeät säilytysohjeet tekevät muokkauksesta helpommin arvioitavan kuin yleinen pyyntö ”parantaa” aineistoa.

Leikkeiden jatkaminen ja yhdistäminen

Seedance 2.0 Fast tukee jatkamista eteen- tai taaksepäin sekä kahden tai kolmen leikkeen yhdistämistä generoiduilla siirtymillä. Kerro jatkossa, tapahtuuko uusi toiminta annetun videon edellä vai jälkeen, ja kuvaa toiminta. Anna yhdistämisessä leikkeet tarkoitetussa järjestyksessä ja selitä niitä yhdistävä visuaalinen tapahtuma.

Yksinkertainen jatko palauttaa yleensä alkuperäisen aineiston ympärille kehitetyn uuden jatkon sen sijaan, että koko lähdeleikkeen toistaminen oletettaisiin. Jos tulosteen tulee sisältää alkuperäinen segmentti, kerro se tehtävänannossa. Kahden tai kolmen videon siirtymää täytettäessä dokumentoitu työnkulku voi yhdistää alkuperäistä ja uutta generoitua sisältöä. Tämä auttaa yhdistämään laajan tuotenäkymän yksityiskohtaotokseen tarkoituksellisella kameraliikkeellä.

Tuloste ja versioiden erot

Dokumentoitu Fast-tuloste on MP4 nopeudella 24 fps, 480p- tai 720p-tarkkuudella, 8-bittisellä värisyvyydellä ja 4–15 sekunnin leikkeinä. Tuetut suhteet ovat 21:9, 16:9, 4:3, 1:1, 3:4 ja 9:16. Tavallinen Seedance 2.0 -versio luettelee erikseen 1080p- ja 4K-tulosteet; ne eivät kuulu Fast-määritykseen. 2.0-perhe tukee viimeisen generoidun ruudun palauttamista mutta ei erillistä Draft-esikatselutilaa.

Äänen voi generoida aineiston kanssa tai jättää pois hiljaista leikettä varten. Generoitu ääni on mono. Dokumentoidut kehotekielet sisältävät englannin, espanjan, indonesian, portugalin ja japanin. Pidä puhuttu kieli yhtenäisenä vuoropuhelussa; opas neuvoo välttämään kielten sekoittamista erisnimiä lukuun ottamatta. Nimeä puhutun kohtauksen puhuja ja sijoita repliikki lainausmerkkeihin, määritä sitten esitys ja olennaiset äänitehosteet. Sovita vaadittu esitys valittuun leikepituuteen.

Viitteiden valmistelu ja syöterajojen huomiointi

Dokumentoidut viiterajat ovat enintään yhdeksän kuvaa, kolme videota ja kolme äänileikettä. Todellisia ihmiskasvoja sisältäviä suoria viitekuva- tai videolatauksia ei hyväksytä tässä dokumentoidussa valmistajaprofiilissa; muotokuvatyö käyttää sen tuettua muotokuva-aineistotyönkulkua. Jokaisen video- tai äänileikkeen tulee olla 2–15 sekuntia pitkä; videoiden yhteiskesto on enintään 15 sekuntia ja äänien yhteiskesto erikseen enintään 15 sekuntia. Videoviitteet käyttävät MP4:ää tai MOV:ia nopeudella 24–60 fps eivätkä saa ylittää 200 MB:tä kukin. Ääniviitteet käyttävät WAV:ia tai MP3:a eivätkä saa ylittää 15 MB:tä kukin. Luetellut kuvamuodot ovat JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ja HEIF. Kuvien tulee olla kukin alle 30 MB; pyynnön rungon kokonaisraja on 64 MB. Dokumentoidussa viitesyöteprofiilissa kuvan leveyden ja korkeuden on oltava aidosti välillä 300–6 000 pikseliä ja leveyden suhteen korkeuteen aidosti välillä 0.4–2.5. Viitevideot sallivat kussakin suunnassa 300–6 000 pikseliä ja suhteet 0.4–2.5 rajat mukaan lukien, kokonaispikselimäärällä 407 696–8 295 044. MP4- tai MOV-videot käyttävät H.264/AVC- tai H.265/HEVC-videota ja AAC- tai MP3-ääntä.

Järjestä aineistot ja viittaa niihin johdonmukaisesti nimillä Image 1, Video 1 tai Audio 1. Käytä näkyvän kohteen nimeä tai erottavaa piirrettä aineistonumeron lisäksi. Sovita päätepistekuvien rajaus videon tarkoitettuun suhteeseen, sillä ristiriita voi rajata kuvan tai aiheuttaa häiritsevän rajausmuutoksen. Keskity tehtävänannossa siirrettäviin piirteisiin, generoitavaan tapahtumaan ja säilytettäviin asioihin; pitkä kehote voi hajottaa ohjeet ja jättää sivuseikkoja ratkaisematta.

Otossuunnittelu, teksti ja tunnetut käyttäytymiset

Jäsennä monimutkainen tehtävänanto muotoon Shot 1, Shot 2 ja Shot 3 ja anna jokaiselle selkeä kohde, toiminta, sijainti ja ääni. Opas suosittelee yhtä kameraliikettä otosta kohden ja kertoo tarkkojen otoskohtaisten aikaleimojen olevan epävakaita. Anna jokaiselle hahmolle vakaa tunniste ja muutama erottava piirre; käytä kasvoidentiteetin ollessa tärkeä erillistä selkeää kasvokuvaa ja kokovartaloviitettä yhdistetyn hahmokääntöarkin sijaan.

Malli voi generoida tavallista tekstiä, kuten iskulauseita, tekstityksiä ja puhekuplia, joiden väriä, tyyliä, sijaintia ja sisääntuloa voidaan ohjata. Tavallisia merkkejä suositaan harvinaisten merkkien ja erikoissymbolien sijaan. Tarkista kirjaimet liikkeessä. Ei-toivotut tekstitykset, logot ja kahdentuneet hahmot ovat dokumentoituja käyttäytymisiä; nimenomaiset rajaukset ja puhtaat viitteet voivat vähentää niitä mutta eivät takaa poissaoloa. Yli neljä viitehenkilöä ilmoitetaan vakausriskiksi, ei kovaksi tiedostomäärärajaksi.

Toistuvat jatkot voivat kasata kuvanlaadun heikkenemistä, ja jatkon liitos voi hypätä tai palata taaksepäin. Rajoita päällekkäisiä jatkoja ja tarkista liitos editoinnissa. Viiteäänen sointiväri voi muuttua, kerronta voi päättyä napsahdukseen ja kiinan monitulkintaiset tai harvinaiset merkit voivat ääntyä väärin. Tarkista puhuttu repliikki ja loppuääni; lyhyt äänihäivytys voi auttaa katkeamiseen. Tarkistukset kuuluvat luovan tuloksen valmisteluun erityisesti silloin, kun puhe tai hahmojatkuvuus kantaa tarinaa.

", "aboutText": "Seedance 2.0 Fast on ByteDance Seedin nopeuteen suunnattu Seedance 2.0 -perheen versio. Se tukee videon ja äänen yhteisgenerointia sekä tekstistä, kuvista, videosta ja äänestä rakennettua multimodaalista tehtävänantoa. Luoviin kykyihin kuuluvat uudet viitevetoiset kohtaukset, olemassa olevan aineiston muokkaukset ja kohtauksen jatkaminen. Dokumentoidut tulostetasot ovat 480p ja 720p.\n\n### Multimodaalinen viite: aineiston roolien määrittäminen\n\nKuva voi antaa hahmon, tuotteen, sommittelun tai visuaalisen käsittelyn. Viitevideo voi antaa toiminnan, kameraliikkeen tai tehosteen. Viiteääni voi antaa puheäänen sointivärin, musiikillisen melodian tai vuoropuhelusisällön. Selitä, minkä osan kustakin lähteestä haluat siirtää uuteen kohtaukseen; viite on hyödyllisempi, kun sillä on tietty luova rooli.\n\nEsimerkiksi: ”Käytä Image 1:n keraamista lamppua tuotteena. Seuraa Video 1:n hidasta kameran kiertoa mutta sijoita lamppu rauhalliseen lukunurkkaukseen. Käytä Audio 1:tä musiikilliseen tunnelmaan.” Tarkoitettu tulos on uusi kohtaus, joka yhdistää valitun ulkoasun, liikkeen ja äänisuunnan, ei kaikkien viiteyksityiskohtien määrittelemätön jäljittely.\n\nDokumentoidut yhdistelmät sisältävät kuvat ja äänen, kuvat ja videon, videon ja äänen sekä kaikki kolme yhdessä. Pelkkää tekstiä ja ääntä tai pelkkää äänisyötettä ei tueta. Malli tukee myös tekstistä videoksi -tilaa ja kuvapohjaista generointia ensimmäisestä ruudusta tai ensimmäisen ja viimeisen ruudun parista. Kun tarkka päätepiste on tehtävänannon ytimessä, käytä erillistä päätepistetyönkulkua; viitekuvan kuvaaminen päätepisteeksi omni-viitekehotteessa on epäsuoraa ohjausta.\n\n### Olemassa olevan videon muokkaaminen\n\nMalli voi lisätä, poistaa tai muokata elementtejä, korvata kohteen ja piirtää uudelleen tai korjata kohtauksen osia. Määritä lähdevideo, muutettava esine ja säilytettävät elementit. Kuvaa lisäykselle esiintymispaikka ja -aika. Tunnista poistettava esine johdonmukaisesti koko leikkeessä.\n\nKäytännön muokkaustehtävänanto voi korvata esittelyn tavallisen pullon Image 1:n pullolla ja pyytää säilyttämään Video 1:n käden liikkeen, taustan ja kameraradan. Tarkista sekä korvaus että vakaiksi tarkoitetut alueet. Selkeät säilytysohjeet tekevät muokkauksesta helpommin arvioitavan kuin yleinen pyyntö ”parantaa” aineistoa.\n\n### Leikkeiden jatkaminen ja yhdistäminen\n\nSeedance 2.0 Fast tukee jatkamista eteen- tai taaksepäin sekä kahden tai kolmen leikkeen yhdistämistä generoiduilla siirtymillä. Kerro jatkossa, tapahtuuko uusi toiminta annetun videon edellä vai jälkeen, ja kuvaa toiminta. Anna yhdistämisessä leikkeet tarkoitetussa järjestyksessä ja selitä niitä yhdistävä visuaalinen tapahtuma.\n\nYksinkertainen jatko palauttaa yleensä alkuperäisen aineiston ympärille kehitetyn uuden jatkon sen sijaan, että koko lähdeleikkeen toistaminen oletettaisiin. Jos tulosteen tulee sisältää alkuperäinen segmentti, kerro se tehtävänannossa. Kahden tai kolmen videon siirtymää täytettäessä dokumentoitu työnkulku voi yhdistää alkuperäistä ja uutta generoitua sisältöä. Tämä auttaa yhdistämään laajan tuotenäkymän yksityiskohtaotokseen tarkoituksellisella kameraliikkeellä.\n\n### Tuloste ja versioiden erot\n\nDokumentoitu Fast-tuloste on MP4 nopeudella 24 fps, 480p- tai 720p-tarkkuudella, 8-bittisellä värisyvyydellä ja 4–15 sekunnin leikkeinä. Tuetut suhteet ovat 21:9, 16:9, 4:3, 1:1, 3:4 ja 9:16. Tavallinen Seedance 2.0 -versio luettelee erikseen 1080p- ja 4K-tulosteet; ne eivät kuulu Fast-määritykseen. 2.0-perhe tukee viimeisen generoidun ruudun palauttamista mutta ei erillistä Draft-esikatselutilaa.\n\nÄänen voi generoida aineiston kanssa tai jättää pois hiljaista leikettä varten. Generoitu ääni on mono. Dokumentoidut kehotekielet sisältävät englannin, espanjan, indonesian, portugalin ja japanin. Pidä puhuttu kieli yhtenäisenä vuoropuhelussa; opas neuvoo välttämään kielten sekoittamista erisnimiä lukuun ottamatta. Nimeä puhutun kohtauksen puhuja ja sijoita repliikki lainausmerkkeihin, määritä sitten esitys ja olennaiset äänitehosteet. Sovita vaadittu esitys valittuun leikepituuteen.\n\n### Viitteiden valmistelu ja syöterajojen huomiointi\n\nDokumentoidut viiterajat ovat enintään yhdeksän kuvaa, kolme videota ja kolme äänileikettä. Todellisia ihmiskasvoja sisältäviä suoria viitekuva- tai videolatauksia ei hyväksytä tässä dokumentoidussa valmistajaprofiilissa; muotokuvatyö käyttää sen tuettua muotokuva-aineistotyönkulkua. Jokaisen video- tai äänileikkeen tulee olla 2–15 sekuntia pitkä; videoiden yhteiskesto on enintään 15 sekuntia ja äänien yhteiskesto erikseen enintään 15 sekuntia. Videoviitteet käyttävät MP4:ää tai MOV:ia nopeudella 24–60 fps eivätkä saa ylittää 200 MB:tä kukin. Ääniviitteet käyttävät WAV:ia tai MP3:a eivätkä saa ylittää 15 MB:tä kukin. Luetellut kuvamuodot ovat JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ja HEIF. Kuvien tulee olla kukin alle 30 MB; pyynnön rungon kokonaisraja on 64 MB. Dokumentoidussa viitesyöteprofiilissa kuvan leveyden ja korkeuden on oltava aidosti välillä 300–6 000 pikseliä ja leveyden suhteen korkeuteen aidosti välillä 0.4–2.5. Viitevideot sallivat kussakin suunnassa 300–6 000 pikseliä ja suhteet 0.4–2.5 rajat mukaan lukien, kokonaispikselimäärällä 407 696–8 295 044. MP4- tai MOV-videot käyttävät H.264/AVC- tai H.265/HEVC-videota ja AAC- tai MP3-ääntä.\n\nJärjestä aineistot ja viittaa niihin johdonmukaisesti nimillä Image 1, Video 1 tai Audio 1. Käytä näkyvän kohteen nimeä tai erottavaa piirrettä aineistonumeron lisäksi. Sovita päätepistekuvien rajaus videon tarkoitettuun suhteeseen, sillä ristiriita voi rajata kuvan tai aiheuttaa häiritsevän rajausmuutoksen. Keskity tehtävänannossa siirrettäviin piirteisiin, generoitavaan tapahtumaan ja säilytettäviin asioihin; pitkä kehote voi hajottaa ohjeet ja jättää sivuseikkoja ratkaisematta.\n\n### Otossuunnittelu, teksti ja tunnetut käyttäytymiset\n\nJäsennä monimutkainen tehtävänanto muotoon Shot 1, Shot 2 ja Shot 3 ja anna jokaiselle selkeä kohde, toiminta, sijainti ja ääni. Opas suosittelee yhtä kameraliikettä otosta kohden ja kertoo tarkkojen otoskohtaisten aikaleimojen olevan epävakaita. Anna jokaiselle hahmolle vakaa tunniste ja muutama erottava piirre; käytä kasvoidentiteetin ollessa tärkeä erillistä selkeää kasvokuvaa ja kokovartaloviitettä yhdistetyn hahmokääntöarkin sijaan.\n\nMalli voi generoida tavallista tekstiä, kuten iskulauseita, tekstityksiä ja puhekuplia, joiden väriä, tyyliä, sijaintia ja sisääntuloa voidaan ohjata. Tavallisia merkkejä suositaan harvinaisten merkkien ja erikoissymbolien sijaan. Tarkista kirjaimet liikkeessä. Ei-toivotut tekstitykset, logot ja kahdentuneet hahmot ovat dokumentoituja käyttäytymisiä; nimenomaiset rajaukset ja puhtaat viitteet voivat vähentää niitä mutta eivät takaa poissaoloa. Yli neljä viitehenkilöä ilmoitetaan vakausriskiksi, ei kovaksi tiedostomäärärajaksi.\n\nToistuvat jatkot voivat kasata kuvanlaadun heikkenemistä, ja jatkon liitos voi hypätä tai palata taaksepäin. Rajoita päällekkäisiä jatkoja ja tarkista liitos editoinnissa. Viiteäänen sointiväri voi muuttua, kerronta voi päättyä napsahdukseen ja kiinan monitulkintaiset tai harvinaiset merkit voivat ääntyä väärin. Tarkista puhuttu repliikki ja loppuääni; lyhyt äänihäivytys voi auttaa katkeamiseen. Tarkistukset kuuluvat luovan tuloksen valmisteluun erityisesti silloin, kun puhe tai hahmojatkuvuus kantaa tarinaa.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b587f2fe1ead273c89c4bfb4960d30239ed3b5945e4bf65c2806928ed93ac441", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fi", "methods": [ { "html": "
•

ByteDance: Seedance 2.0 Fast

ByteDance /bytedance/seedance-2.0-fast

Aloitus

ByteDance Seedance 2.0 Fast luo audiovisuaalisia kohtauksia tekstistä sekä kuva-, video- ja ääniviitteistä. Nopeuteen suunnattu versio tukee liikkeen ja tyylin siirtoa, videomuokkauksia ja jatkamista eteen- tai taaksepäin dokumentoiduilla 480p- ja 720p-tulosteilla.

Hyväksytyt syötteet
Teksti · Kuvat · Ääni
Tulokset
Video
Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

Seedance 2.0 Fast on ByteDance Seedin nopeuteen suunnattu Seedance 2.0 -perheen versio. Se tukee videon ja äänen yhteisgenerointia sekä tekstistä, kuvista, videosta ja äänestä rakennettua multimodaalista tehtävänantoa. Luoviin kykyihin kuuluvat uudet viitevetoiset kohtaukset, olemassa olevan aineiston muokkaukset ja kohtauksen jatkaminen. Dokumentoidut tulostetasot ovat 480p ja 720p.

Multimodaalinen viite: aineiston roolien määrittäminen

Kuva voi antaa hahmon, tuotteen, sommittelun tai visuaalisen käsittelyn. Viitevideo voi antaa toiminnan, kameraliikkeen tai tehosteen. Viiteääni voi antaa puheäänen sointivärin, musiikillisen melodian tai vuoropuhelusisällön. Selitä, minkä osan kustakin lähteestä haluat siirtää uuteen kohtaukseen; viite on hyödyllisempi, kun sillä on tietty luova rooli.

Esimerkiksi: ”Käytä Image 1:n keraamista lamppua tuotteena. Seuraa Video 1:n hidasta kameran kiertoa mutta sijoita lamppu rauhalliseen lukunurkkaukseen. Käytä Audio 1:tä musiikilliseen tunnelmaan.” Tarkoitettu tulos on uusi kohtaus, joka yhdistää valitun ulkoasun, liikkeen ja äänisuunnan, ei kaikkien viiteyksityiskohtien määrittelemätön jäljittely.

Dokumentoidut yhdistelmät sisältävät kuvat ja äänen, kuvat ja videon, videon ja äänen sekä kaikki kolme yhdessä. Pelkkää tekstiä ja ääntä tai pelkkää äänisyötettä ei tueta. Malli tukee myös tekstistä videoksi -tilaa ja kuvapohjaista generointia ensimmäisestä ruudusta tai ensimmäisen ja viimeisen ruudun parista. Kun tarkka päätepiste on tehtävänannon ytimessä, käytä erillistä päätepistetyönkulkua; viitekuvan kuvaaminen päätepisteeksi omni-viitekehotteessa on epäsuoraa ohjausta.

Olemassa olevan videon muokkaaminen

Malli voi lisätä, poistaa tai muokata elementtejä, korvata kohteen ja piirtää uudelleen tai korjata kohtauksen osia. Määritä lähdevideo, muutettava esine ja säilytettävät elementit. Kuvaa lisäykselle esiintymispaikka ja -aika. Tunnista poistettava esine johdonmukaisesti koko leikkeessä.

Käytännön muokkaustehtävänanto voi korvata esittelyn tavallisen pullon Image 1:n pullolla ja pyytää säilyttämään Video 1:n käden liikkeen, taustan ja kameraradan. Tarkista sekä korvaus että vakaiksi tarkoitetut alueet. Selkeät säilytysohjeet tekevät muokkauksesta helpommin arvioitavan kuin yleinen pyyntö ”parantaa” aineistoa.

Leikkeiden jatkaminen ja yhdistäminen

Seedance 2.0 Fast tukee jatkamista eteen- tai taaksepäin sekä kahden tai kolmen leikkeen yhdistämistä generoiduilla siirtymillä. Kerro jatkossa, tapahtuuko uusi toiminta annetun videon edellä vai jälkeen, ja kuvaa toiminta. Anna yhdistämisessä leikkeet tarkoitetussa järjestyksessä ja selitä niitä yhdistävä visuaalinen tapahtuma.

Yksinkertainen jatko palauttaa yleensä alkuperäisen aineiston ympärille kehitetyn uuden jatkon sen sijaan, että koko lähdeleikkeen toistaminen oletettaisiin. Jos tulosteen tulee sisältää alkuperäinen segmentti, kerro se tehtävänannossa. Kahden tai kolmen videon siirtymää täytettäessä dokumentoitu työnkulku voi yhdistää alkuperäistä ja uutta generoitua sisältöä. Tämä auttaa yhdistämään laajan tuotenäkymän yksityiskohtaotokseen tarkoituksellisella kameraliikkeellä.

Tuloste ja versioiden erot

Dokumentoitu Fast-tuloste on MP4 nopeudella 24 fps, 480p- tai 720p-tarkkuudella, 8-bittisellä värisyvyydellä ja 4–15 sekunnin leikkeinä. Tuetut suhteet ovat 21:9, 16:9, 4:3, 1:1, 3:4 ja 9:16. Tavallinen Seedance 2.0 -versio luettelee erikseen 1080p- ja 4K-tulosteet; ne eivät kuulu Fast-määritykseen. 2.0-perhe tukee viimeisen generoidun ruudun palauttamista mutta ei erillistä Draft-esikatselutilaa.

Äänen voi generoida aineiston kanssa tai jättää pois hiljaista leikettä varten. Generoitu ääni on mono. Dokumentoidut kehotekielet sisältävät englannin, espanjan, indonesian, portugalin ja japanin. Pidä puhuttu kieli yhtenäisenä vuoropuhelussa; opas neuvoo välttämään kielten sekoittamista erisnimiä lukuun ottamatta. Nimeä puhutun kohtauksen puhuja ja sijoita repliikki lainausmerkkeihin, määritä sitten esitys ja olennaiset äänitehosteet. Sovita vaadittu esitys valittuun leikepituuteen.

Viitteiden valmistelu ja syöterajojen huomiointi

Dokumentoidut viiterajat ovat enintään yhdeksän kuvaa, kolme videota ja kolme äänileikettä. Todellisia ihmiskasvoja sisältäviä suoria viitekuva- tai videolatauksia ei hyväksytä tässä dokumentoidussa valmistajaprofiilissa; muotokuvatyö käyttää sen tuettua muotokuva-aineistotyönkulkua. Jokaisen video- tai äänileikkeen tulee olla 2–15 sekuntia pitkä; videoiden yhteiskesto on enintään 15 sekuntia ja äänien yhteiskesto erikseen enintään 15 sekuntia. Videoviitteet käyttävät MP4:ää tai MOV:ia nopeudella 24–60 fps eivätkä saa ylittää 200 MB:tä kukin. Ääniviitteet käyttävät WAV:ia tai MP3:a eivätkä saa ylittää 15 MB:tä kukin. Luetellut kuvamuodot ovat JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ja HEIF. Kuvien tulee olla kukin alle 30 MB; pyynnön rungon kokonaisraja on 64 MB. Dokumentoidussa viitesyöteprofiilissa kuvan leveyden ja korkeuden on oltava aidosti välillä 300–6 000 pikseliä ja leveyden suhteen korkeuteen aidosti välillä 0.4–2.5. Viitevideot sallivat kussakin suunnassa 300–6 000 pikseliä ja suhteet 0.4–2.5 rajat mukaan lukien, kokonaispikselimäärällä 407 696–8 295 044. MP4- tai MOV-videot käyttävät H.264/AVC- tai H.265/HEVC-videota ja AAC- tai MP3-ääntä.

Järjestä aineistot ja viittaa niihin johdonmukaisesti nimillä Image 1, Video 1 tai Audio 1. Käytä näkyvän kohteen nimeä tai erottavaa piirrettä aineistonumeron lisäksi. Sovita päätepistekuvien rajaus videon tarkoitettuun suhteeseen, sillä ristiriita voi rajata kuvan tai aiheuttaa häiritsevän rajausmuutoksen. Keskity tehtävänannossa siirrettäviin piirteisiin, generoitavaan tapahtumaan ja säilytettäviin asioihin; pitkä kehote voi hajottaa ohjeet ja jättää sivuseikkoja ratkaisematta.

Otossuunnittelu, teksti ja tunnetut käyttäytymiset

Jäsennä monimutkainen tehtävänanto muotoon Shot 1, Shot 2 ja Shot 3 ja anna jokaiselle selkeä kohde, toiminta, sijainti ja ääni. Opas suosittelee yhtä kameraliikettä otosta kohden ja kertoo tarkkojen otoskohtaisten aikaleimojen olevan epävakaita. Anna jokaiselle hahmolle vakaa tunniste ja muutama erottava piirre; käytä kasvoidentiteetin ollessa tärkeä erillistä selkeää kasvokuvaa ja kokovartaloviitettä yhdistetyn hahmokääntöarkin sijaan.

Malli voi generoida tavallista tekstiä, kuten iskulauseita, tekstityksiä ja puhekuplia, joiden väriä, tyyliä, sijaintia ja sisääntuloa voidaan ohjata. Tavallisia merkkejä suositaan harvinaisten merkkien ja erikoissymbolien sijaan. Tarkista kirjaimet liikkeessä. Ei-toivotut tekstitykset, logot ja kahdentuneet hahmot ovat dokumentoituja käyttäytymisiä; nimenomaiset rajaukset ja puhtaat viitteet voivat vähentää niitä mutta eivät takaa poissaoloa. Yli neljä viitehenkilöä ilmoitetaan vakausriskiksi, ei kovaksi tiedostomäärärajaksi.

Toistuvat jatkot voivat kasata kuvanlaadun heikkenemistä, ja jatkon liitos voi hypätä tai palata taaksepäin. Rajoita päällekkäisiä jatkoja ja tarkista liitos editoinnissa. Viiteäänen sointiväri voi muuttua, kerronta voi päättyä napsahdukseen ja kiinan monitulkintaiset tai harvinaiset merkit voivat ääntyä väärin. Tarkista puhuttu repliikki ja loppuääni; lyhyt äänihäivytys voi auttaa katkeamiseen. Tarkistukset kuuluvat luovan tuloksen valmisteluun erityisesti silloin, kun puhe tai hahmojatkuvuus kantaa tarinaa.

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Video POST /v1/videos
Syötetyypit
text, image, audio
Tulostyypit
video
Tulosteen muoto
alkuperäiset MP4-tavut; ei normalisointia eikä uudelleenkoodausta
KenttäTyyppiVaatimusArvot & rajatOletus
KenttämodelTyyppistringVaatimusPakollinenArvot & rajat
bytedance/seedance-2.0-fast
Oletus—
KenttäpromptTyyppistringVaatimusPakollinenArvot & rajatOletus—
KenttädurationTyyppiintegerVaatimusPakollinenArvot & rajat
4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Vähimmäismäärä: 1
Enimmäismäärä: 600
Oletus—
KenttäresolutionTyyppistringVaatimusValinnainenArvot & rajat
480p, 720p
Oletus—
Kenttäaspect_ratioTyyppistringVaatimusValinnainenArvot & rajat
1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21
Oletus—
Kenttägenerate_audioTyyppibooleanVaatimusValinnainenArvot & rajat
false, true
Ehdot: generate_audio-kentän pois jättäminen valitsee äänen sisältävän hinnan; false valitsee äänettömän hinnan. Tarkista tuloksen has_audio-kentästä, palautettiinko ääniraita.
Oletus—
Kenttäframe_imagesTyyppiarrayVaatimusValinnainenArvot & rajat
Kohteiden vähimmäismäärä: 1
Kohteiden enimmäismäärä: 2
Syötteen sisältö: Kuvaolioiden taulukko. Jokaisessa on type=image_url, url-kentän sisältävä image_url ja frame_type=first_frame tai last_frame. Kukin rooli esiintyy enintään kerran. Käytä julkisia HTTPS-kuvan URL-osoitteita.
Tarkat avaimet: type, image_url, frame_type
Ehdot: Nämä avaimet koskevat jokaista kuvaoliota. Jätä frame_images pois pelkkää tekstiä sisältävästä pyynnöstä.
Oletus—
Kenttäinput_referencesTyyppiarrayVaatimusValinnainenArvot & rajat
Syötteen sisältö: Kuva- tai ääniviiteolioiden taulukko. Aseta type-kentän arvoksi image_url tai audio_url ja anna vastaava url-kentän sisältävä URL-olio. Videoviitteitä ei edelleenkään voida hinnoitella.
Ehdot: Jätä frame_images pois käyttääksesi viitetilaa. Käytä julkisia HTTPS-osoitteita.
Oletus—
KenttäsizeTyyppistringVaatimusValinnainenArvot & rajat
480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720
Merkkijonomalli: ^[1-9][0-9]*x[1-9][0-9]*$
Oletus—
KenttäseedTyyppiintegerVaatimusValinnainenArvot & rajat
Vähimmäismäärä: −9 223 372 036 854 775 808
Enimmäismäärä: 9 223 372 036 854 775 807
Oletus—
Kenttäcallback_urlTyyppistringVaatimusValinnainenArvot & rajat
Merkkijonomalli: ^https://
Oletus—
Kenttäsession_idTyyppistringVaatimusValinnainenArvot & rajatOletus—
KenttätraceTyyppiobjectVaatimusValinnainenArvot & rajatOletus—
KenttäuserTyyppistringVaatimusValinnainenArvot & rajatOletus—
Syöteaineistojen yhdistelmät

Tekstistä videoksi · Kirjoitettu kehote. · Pakollinen: model, prompt, duration

Anna tekstikehote ja tuettu kesto kokonaisina sekunteina. Käytä täsmälleen lueteltua kokoa tai resoluutiota ja kuvasuhdetta, jotka muodostavat luetellut mitat.

model: Tyyppi: string · bytedance/seedance-2.0-fast

prompt: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä

Kuvasta videoksi · Kirjoitettu kehote ja ruutukuva. · Pakollinen: model, prompt, duration, frame_images

frame_images on oliotaulukko, jossa on type=image_url, url-kentän sisältävä image_url ja frame_type. Käytä julkista HTTPS-kuvan URL-osoitetta; first_frame ja last_frame saavat kumpikin esiintyä kerran. Käytä lueteltua tuloskokoa tai yhteensopivia mittoja. Älä lisää videoviitteitä.

Tarkat avaimet: type, image_url, frame_type

model: Tyyppi: string · bytedance/seedance-2.0-fast

prompt: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä

Reference to video · Kirjoitettu kehote sekä kuva- tai ääniviitteet. · Pakollinen: model, prompt, duration, input_references

input_references on taulukko. Jokaisessa oliossa on type=image_url tai type=audio_url sekä vastaava url-kentän sisältävä URL-olio. Käytä julkisia HTTPS-linkkejä. Jätä frame_images pois valitaksesi viitetilan. Videoviitteitä ei voida hinnoitella.

model: Tyyppi: string · bytedance/seedance-2.0-fast

prompt: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä

Menetelmän parametrit ja elinkaari
ParametriSopimus
Parametricontent_typeSopimusapplication/json
ParametrirequiredSopimusmodel, prompt, duration
Parametrimaterial_typesSopimustext, image, audio
Parametriadditional_propertiesSopimusfalse
Parametrioptional_controlsSopimusresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user

Elinkaari: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila
Ei määritetty Kun nopea tila on valittu
Flex-tila
Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho
Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

AsetuksetHinnastoEnnustettu määräLaskutusyksikköLaskutusehdotVeloitus
AsetuksetTokenien perushinnatHinnastoPerushintaEnnustettu määrä—Laskutusyksikkö—Laskutusehdot—Veloitus
Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia
Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia
Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia
Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia
Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
AsetuksetVideotokenin hintaHinnasto—Ennustettu määrä—Laskutusyksikkö1K videotokenia kohdenLaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa.Veloitus
Tuloste · Videotokenin hinta · Arvio vain vertailua varten $0.0084 1K videotokenia kohden

Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.

AsetuksetVideotokenin hintaHinnasto—Ennustettu määrä—Laskutusyksikkö1K videotokenia kohdenLaskutusehdotsyöte: with_video_inputVeloitus
reference · Videotokenin hinta · Arvio vain vertailua varten $0.00495 1K videotokenia kohden

Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.

AsetuksetVideotokenin hintaHinnasto—Ennustettu määrä—Laskutusyksikkö1K videotokenia kohdenLaskutusehdotääni: without_audioVeloitus
Tuloste · Videotokenin hinta · Arvio vain vertailua varten $0.0084 1K videotokenia kohden

Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.

AsetuksetArvioitu luontikustannusHinnasto—Ennustettu määräyhden generoinnin arvioLaskutusyksikkö—Laskutusehdot—Veloitus
Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.18144 arvio ennen generointia

Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Viitehinnaston tiedot

Mallitason viitehinnastot eivät muuta menetelmän valintaa, hinta-arvioita tai veloituksia. Käytössä olevat veloitukset käyttävät valitun Ailoot-menetelmän hintoja.

Videokokoonpanojen hintaviitteet

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

AsetuksetLaskutusehdotVeloitus
AsetuksetVideotokenin hintaLaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa.Veloitus
Tuloste · Videotokenin hinta $0.0084 1K videotokenia kohden

Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.

AsetuksetVideotokenin hintaLaskutusehdotääni: without_audioVeloitus
Tuloste · Videotokenin hinta $0.0084 1K videotokenia kohden

Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.

AsetuksetVideotokenin hintaLaskutusehdotsyöte: with_video_inputVeloitus
reference · Videotokenin hinta $0.00495 1K videotokenia kohden

Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.

Esimerkkipyynnöt

Ailoot Ultra · Video

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{"model":"bytedance/seedance-2.0-fast","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Vastaanota ja tallenna tulokset

Ailoot Ultra · Video

allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet

Tarkista työn tila
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Muut sisällön lukukerrat
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n    target=Path('owned-'+label+'.bin')\n    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL.

Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.

Jos alkuperäinen vastaus on tarkistettava

503 result_pending_check + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä

Vastauksen kentät
KenttäTyyppiMerkitys
KenttäindexTyyppiintegerMerkitysTämän videon nollasta alkava sijainti tulosluettelossa.
Kenttäcontent_urlTyyppistringMerkitysAllekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle.
Kenttäsha256Tyyppistring | nullMerkitysAlkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla.
Kenttäsize_bytesTyyppiinteger | nullMerkitysAlkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla.
Kenttäduration_msTyyppiinteger | nullMerkitysVideon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla.
KenttäwidthTyyppiinteger | nullMerkitysVideon leveys pikseleinä; null, jos tietoa ei ole saatavilla.
KenttäheightTyyppiinteger | nullMerkitysVideon korkeus pikseleinä; null, jos tietoa ei ole saatavilla.
Kenttävideo_codecTyyppistring | nullMerkitysVideokoodekin tunniste; null, jos sitä ei ole kirjattu.
Kenttähas_audioTyyppiboolean | nullMerkitysSisältääkö video ääniraidan; null, jos asiaa ei ole mitattu.
Kenttäaudio_codecTyyppistring | nullMerkitysÄänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu.
Virheet ja seuraavat vaiheet
VastausEhtoSeuraava vaihe
Vastaus404 · not_found_errorEhtoVideoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt.Seuraava vaiheTarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta.
Vastaus401 · authentication_errorEhtoAPI-avain ei vastaa todennettua tiliä.Seuraava vaiheTarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä.
Vastaus400 · invalid_request_errorEhtoPyyntöä ei voitu lukea tai latausindeksi on virheellinen.Seuraava vaiheKorjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi.
Vastaus422 · price_unavailableEhtoValittua videokokoonpanoa ei voida hinnoitella.Seuraava vaiheValitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä.
Vastaus422 · invalid_request_errorEhtoVideosyöte tai alkuperäinen jatkotehtävä on virheellinen.Seuraava vaiheKäytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella.
Vastaus402 · billing_errorEhtoKäytettävissä oleva saldo tai rajoitukset eivät salli katevarausta.Seuraava vaiheTarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä.
Vastaus503 · server_errorEhtoVideon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla.Seuraava vaiheOdota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan.
Vastaus503 · result_pending_checkEhtoAlkuperäinen videotulos ja veloitus on tarkistettava.Seuraava vaiheSäilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana.
Vastaus503 · owned_result_unavailableEhtoOlemassa olevan videon lataus ei ole tilapäisesti saatavilla.Seuraava vaiheTarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation.
Vastaus409 · video_not_readyEhtoVideosisältöä ei ole julkaistu.Seuraava vaiheTarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta.

Aliakset

Mallin aliakset

Ailoot Ultra bytedance/seedance-2.0-fast

Menetelmäpolkujen aliakset

Käytä yllä näytettyjä menetelmäpolkuja.

Liittyvät kutsujan ID:t

bytedance/seedance-2.0-fast

", "method_identity": { "effective_request_model_id": "bytedance/seedance-2.0-fast", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|bytedance%2Fseedance-2.0-fast", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Videoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Tarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta.", "type": "not_found_error" }, { "condition": "API-avain ei vastaa todennettua tiliä.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Tarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä.", "type": "authentication_error" }, { "condition": "Pyyntöä ei voitu lukea tai latausindeksi on virheellinen.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi.", "type": "invalid_request_error" }, { "condition": "Valittua videokokoonpanoa ei voida hinnoitella.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Valitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä.", "type": "price_unavailable" }, { "condition": "Videosyöte tai alkuperäinen jatkotehtävä on virheellinen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Käytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella.", "type": "invalid_request_error" }, { "condition": "Käytettävissä oleva saldo tai rajoitukset eivät salli katevarausta.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Tarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä.", "type": "billing_error" }, { "condition": "Videon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Odota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Alkuperäinen videotulos ja veloitus on tarkistettava.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Säilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Olemassa olevan videon lataus ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Tarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation.", "type": "server_error" }, { "condition": "Videosisältöä ei ole julkaistu.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Tarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Anna tekstikehote ja tuettu kesto kokonaisina sekunteina. Käytä täsmälleen lueteltua kokoa tai resoluutiota ja kuvasuhdetta, jotka muodostavat luetellut mitat.", "required": [ "model", "prompt", "duration" ], "required_material": "Kirjoitettu kehote." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images on oliotaulukko, jossa on type=image_url, url-kentän sisältävä image_url ja frame_type. Käytä julkista HTTPS-kuvan URL-osoitetta; first_frame ja last_frame saavat kumpikin esiintyä kerran. Käytä lueteltua tuloskokoa tai yhteensopivia mittoja. Älä lisää videoviitteitä.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Kirjoitettu kehote ja ruutukuva." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references on taulukko. Jokaisessa oliossa on type=image_url tai type=audio_url sekä vastaava url-kentän sisältävä URL-olio. Käytä julkisia HTTPS-linkkejä. Jätä frame_images pois valitaksesi viitetilan. Videoviitteitä ei voida hinnoitella.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Kirjoitettu kehote sekä kuva- tai ääniviitteet." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Tämän videon nollasta alkava sijainti tulosluettelossa.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Allekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Alkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Alkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Videon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videon leveys pikseleinä; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videon korkeus pikseleinä; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videokoodekin tunniste; null, jos sitä ei ole kirjattu.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Sisältääkö video ääniraidan; null, jos asiaa ei ole mitattu.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Äänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-fast" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "generate_audio-kentän pois jättäminen valitsee äänen sisältävän hinnan; false valitsee äänettömän hinnan. Tarkista tuloksen has_audio-kentästä, palautettiinko ääniraita.", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Nämä avaimet koskevat jokaista kuvaoliota. Jätä frame_images pois pelkkää tekstiä sisältävästä pyynnöstä.", "content": "Kuvaolioiden taulukko. Jokaisessa on type=image_url, url-kentän sisältävä image_url ja frame_type=first_frame tai last_frame. Kukin rooli esiintyy enintään kerran. Käytä julkisia HTTPS-kuvan URL-osoitteita.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "Jätä frame_images pois käyttääksesi viitetilaa. Käytä julkisia HTTPS-osoitteita.", "content": "Kuva- tai ääniviiteolioiden taulukko. Aseta type-kentän arvoksi image_url tai audio_url ja anna vastaava url-kentän sisältävä URL-olio. Videoviitteitä ei edelleenkään voida hinnoitella.", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-fast" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Videotokenin hinta", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.", "dimensions": { "conditions": "syöte: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Videotokenin hinta", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Arvioitu luontikustannus", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-fast\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "bytedance/seedance-2.0-fast", "nativeProvenance": { "input_facts_canonical_sha256": "6ba230f795f9d6d85ef3a7b65290ca5e42997d6d88d2a0ae5cc59001a21436ff", "input_html_sha256": "ee01991c47aed1ef6b56d392427eb777c2431b37690dfcc082aa54c08b5b6f79", "private_audit_sha256": "f2926513b3c25048ce12d6409713155ae92e1e9b18052d7c5442019d03269af9", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/fi/bytedance-seedance-2-0-fast/", "description": "ByteDance Seedance 2.0 Fast luo audiovisuaalisia kohtauksia tekstistä sekä kuva-, video- ja ääniviitteistä. Nopeuteen suunnattu versio tukee liikkeen ja tyylin siirtoa, videomuokkauksia ja jatkamista eteen- tai taaksepäin dokumentoiduilla 480p- ja 720p-tulosteilla.", "locale": "fi", "md_url": "https://ailoot.ai/models/fi/bytedance-seedance-2-0-fast/index.md", "title": "ByteDance: Seedance 2.0 Fast — Ailoot", "url": "https://ailoot.ai/models/fi/bytedance-seedance-2-0-fast/" }, "rawModel": { "about": "Seedance 2.0 Fast on ByteDance Seedin nopeuteen suunnattu Seedance 2.0 -perheen versio. Se tukee videon ja äänen yhteisgenerointia sekä tekstistä, kuvista, videosta ja äänestä rakennettua multimodaalista tehtävänantoa. Luoviin kykyihin kuuluvat uudet viitevetoiset kohtaukset, olemassa olevan aineiston muokkaukset ja kohtauksen jatkaminen. Dokumentoidut tulostetasot ovat 480p ja 720p.\n\n### Multimodaalinen viite: aineiston roolien määrittäminen\n\nKuva voi antaa hahmon, tuotteen, sommittelun tai visuaalisen käsittelyn. Viitevideo voi antaa toiminnan, kameraliikkeen tai tehosteen. Viiteääni voi antaa puheäänen sointivärin, musiikillisen melodian tai vuoropuhelusisällön. Selitä, minkä osan kustakin lähteestä haluat siirtää uuteen kohtaukseen; viite on hyödyllisempi, kun sillä on tietty luova rooli.\n\nEsimerkiksi: ”Käytä Image 1:n keraamista lamppua tuotteena. Seuraa Video 1:n hidasta kameran kiertoa mutta sijoita lamppu rauhalliseen lukunurkkaukseen. Käytä Audio 1:tä musiikilliseen tunnelmaan.” Tarkoitettu tulos on uusi kohtaus, joka yhdistää valitun ulkoasun, liikkeen ja äänisuunnan, ei kaikkien viiteyksityiskohtien määrittelemätön jäljittely.\n\nDokumentoidut yhdistelmät sisältävät kuvat ja äänen, kuvat ja videon, videon ja äänen sekä kaikki kolme yhdessä. Pelkkää tekstiä ja ääntä tai pelkkää äänisyötettä ei tueta. Malli tukee myös tekstistä videoksi -tilaa ja kuvapohjaista generointia ensimmäisestä ruudusta tai ensimmäisen ja viimeisen ruudun parista. Kun tarkka päätepiste on tehtävänannon ytimessä, käytä erillistä päätepistetyönkulkua; viitekuvan kuvaaminen päätepisteeksi omni-viitekehotteessa on epäsuoraa ohjausta.\n\n### Olemassa olevan videon muokkaaminen\n\nMalli voi lisätä, poistaa tai muokata elementtejä, korvata kohteen ja piirtää uudelleen tai korjata kohtauksen osia. Määritä lähdevideo, muutettava esine ja säilytettävät elementit. Kuvaa lisäykselle esiintymispaikka ja -aika. Tunnista poistettava esine johdonmukaisesti koko leikkeessä.\n\nKäytännön muokkaustehtävänanto voi korvata esittelyn tavallisen pullon Image 1:n pullolla ja pyytää säilyttämään Video 1:n käden liikkeen, taustan ja kameraradan. Tarkista sekä korvaus että vakaiksi tarkoitetut alueet. Selkeät säilytysohjeet tekevät muokkauksesta helpommin arvioitavan kuin yleinen pyyntö ”parantaa” aineistoa.\n\n### Leikkeiden jatkaminen ja yhdistäminen\n\nSeedance 2.0 Fast tukee jatkamista eteen- tai taaksepäin sekä kahden tai kolmen leikkeen yhdistämistä generoiduilla siirtymillä. Kerro jatkossa, tapahtuuko uusi toiminta annetun videon edellä vai jälkeen, ja kuvaa toiminta. Anna yhdistämisessä leikkeet tarkoitetussa järjestyksessä ja selitä niitä yhdistävä visuaalinen tapahtuma.\n\nYksinkertainen jatko palauttaa yleensä alkuperäisen aineiston ympärille kehitetyn uuden jatkon sen sijaan, että koko lähdeleikkeen toistaminen oletettaisiin. Jos tulosteen tulee sisältää alkuperäinen segmentti, kerro se tehtävänannossa. Kahden tai kolmen videon siirtymää täytettäessä dokumentoitu työnkulku voi yhdistää alkuperäistä ja uutta generoitua sisältöä. Tämä auttaa yhdistämään laajan tuotenäkymän yksityiskohtaotokseen tarkoituksellisella kameraliikkeellä.\n\n### Tuloste ja versioiden erot\n\nDokumentoitu Fast-tuloste on MP4 nopeudella 24 fps, 480p- tai 720p-tarkkuudella, 8-bittisellä värisyvyydellä ja 4–15 sekunnin leikkeinä. Tuetut suhteet ovat 21:9, 16:9, 4:3, 1:1, 3:4 ja 9:16. Tavallinen Seedance 2.0 -versio luettelee erikseen 1080p- ja 4K-tulosteet; ne eivät kuulu Fast-määritykseen. 2.0-perhe tukee viimeisen generoidun ruudun palauttamista mutta ei erillistä Draft-esikatselutilaa.\n\nÄänen voi generoida aineiston kanssa tai jättää pois hiljaista leikettä varten. Generoitu ääni on mono. Dokumentoidut kehotekielet sisältävät englannin, espanjan, indonesian, portugalin ja japanin. Pidä puhuttu kieli yhtenäisenä vuoropuhelussa; opas neuvoo välttämään kielten sekoittamista erisnimiä lukuun ottamatta. Nimeä puhutun kohtauksen puhuja ja sijoita repliikki lainausmerkkeihin, määritä sitten esitys ja olennaiset äänitehosteet. Sovita vaadittu esitys valittuun leikepituuteen.\n\n### Viitteiden valmistelu ja syöterajojen huomiointi\n\nDokumentoidut viiterajat ovat enintään yhdeksän kuvaa, kolme videota ja kolme äänileikettä. Todellisia ihmiskasvoja sisältäviä suoria viitekuva- tai videolatauksia ei hyväksytä tässä dokumentoidussa valmistajaprofiilissa; muotokuvatyö käyttää sen tuettua muotokuva-aineistotyönkulkua. Jokaisen video- tai äänileikkeen tulee olla 2–15 sekuntia pitkä; videoiden yhteiskesto on enintään 15 sekuntia ja äänien yhteiskesto erikseen enintään 15 sekuntia. Videoviitteet käyttävät MP4:ää tai MOV:ia nopeudella 24–60 fps eivätkä saa ylittää 200 MB:tä kukin. Ääniviitteet käyttävät WAV:ia tai MP3:a eivätkä saa ylittää 15 MB:tä kukin. Luetellut kuvamuodot ovat JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ja HEIF. Kuvien tulee olla kukin alle 30 MB; pyynnön rungon kokonaisraja on 64 MB. Dokumentoidussa viitesyöteprofiilissa kuvan leveyden ja korkeuden on oltava aidosti välillä 300–6 000 pikseliä ja leveyden suhteen korkeuteen aidosti välillä 0.4–2.5. Viitevideot sallivat kussakin suunnassa 300–6 000 pikseliä ja suhteet 0.4–2.5 rajat mukaan lukien, kokonaispikselimäärällä 407 696–8 295 044. MP4- tai MOV-videot käyttävät H.264/AVC- tai H.265/HEVC-videota ja AAC- tai MP3-ääntä.\n\nJärjestä aineistot ja viittaa niihin johdonmukaisesti nimillä Image 1, Video 1 tai Audio 1. Käytä näkyvän kohteen nimeä tai erottavaa piirrettä aineistonumeron lisäksi. Sovita päätepistekuvien rajaus videon tarkoitettuun suhteeseen, sillä ristiriita voi rajata kuvan tai aiheuttaa häiritsevän rajausmuutoksen. Keskity tehtävänannossa siirrettäviin piirteisiin, generoitavaan tapahtumaan ja säilytettäviin asioihin; pitkä kehote voi hajottaa ohjeet ja jättää sivuseikkoja ratkaisematta.\n\n### Otossuunnittelu, teksti ja tunnetut käyttäytymiset\n\nJäsennä monimutkainen tehtävänanto muotoon Shot 1, Shot 2 ja Shot 3 ja anna jokaiselle selkeä kohde, toiminta, sijainti ja ääni. Opas suosittelee yhtä kameraliikettä otosta kohden ja kertoo tarkkojen otoskohtaisten aikaleimojen olevan epävakaita. Anna jokaiselle hahmolle vakaa tunniste ja muutama erottava piirre; käytä kasvoidentiteetin ollessa tärkeä erillistä selkeää kasvokuvaa ja kokovartaloviitettä yhdistetyn hahmokääntöarkin sijaan.\n\nMalli voi generoida tavallista tekstiä, kuten iskulauseita, tekstityksiä ja puhekuplia, joiden väriä, tyyliä, sijaintia ja sisääntuloa voidaan ohjata. Tavallisia merkkejä suositaan harvinaisten merkkien ja erikoissymbolien sijaan. Tarkista kirjaimet liikkeessä. Ei-toivotut tekstitykset, logot ja kahdentuneet hahmot ovat dokumentoituja käyttäytymisiä; nimenomaiset rajaukset ja puhtaat viitteet voivat vähentää niitä mutta eivät takaa poissaoloa. Yli neljä viitehenkilöä ilmoitetaan vakausriskiksi, ei kovaksi tiedostomäärärajaksi.\n\nToistuvat jatkot voivat kasata kuvanlaadun heikkenemistä, ja jatkon liitos voi hypätä tai palata taaksepäin. Rajoita päällekkäisiä jatkoja ja tarkista liitos editoinnissa. Viiteäänen sointiväri voi muuttua, kerronta voi päättyä napsahdukseen ja kiinan monitulkintaiset tai harvinaiset merkit voivat ääntyä väärin. Tarkista puhuttu repliikki ja loppuääni; lyhyt äänihäivytys voi auttaa katkeamiseen. Tarkistukset kuuluvat luovan tuloksen valmisteluun erityisesti silloin, kun puhe tai hahmojatkuvuus kantaa tarinaa.", "alias_of": null, "aliases": [], "author": "ByteDance", "available": null, "canonical_model": "bytedance/seedance-2.0-fast", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image", "video", "audio" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Konfiguraation täydet hintatiedot lisätiedoissa." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "24999f354c53561f1fcfc3f1", "label": "Videokokoonpanojen hintaviitteet", "profiles": [ { "basis": "Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.", "dimensions": { "conditions": "Tässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa." }, "label": "Videotokenin hinta", "units": [ { "amount": "0.0084", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.", "dimensions": { "conditions": "ääni: without_audio" }, "label": "Videotokenin hinta", "units": [ { "amount": "0.0084", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "out", "unit": "video_token" } ] }, { "basis": "Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.", "dimensions": { "conditions": "syöte: with_video_input" }, "label": "Videotokenin hinta", "units": [ { "amount": "0.00495", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "key": "video_token", "label": "Video-token price", "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "rate_role": "typed_video_token_primary_reference", "side": "reference", "unit": "video_token" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "bytedance/seedance-2.0-fast", "input": [ "text", "image", "audio" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Videoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Tarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta.", "type": "not_found_error" }, { "condition": "API-avain ei vastaa todennettua tiliä.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Tarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä.", "type": "authentication_error" }, { "condition": "Pyyntöä ei voitu lukea tai latausindeksi on virheellinen.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Korjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi.", "type": "invalid_request_error" }, { "condition": "Valittua videokokoonpanoa ei voida hinnoitella.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Valitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä.", "type": "price_unavailable" }, { "condition": "Videosyöte tai alkuperäinen jatkotehtävä on virheellinen.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Käytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella.", "type": "invalid_request_error" }, { "condition": "Käytettävissä oleva saldo tai rajoitukset eivät salli katevarausta.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Tarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä.", "type": "billing_error" }, { "condition": "Videon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Odota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Alkuperäinen videotulos ja veloitus on tarkistettava.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Säilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Olemassa olevan videon lataus ei ole tilapäisesti saatavilla.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Tarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation.", "type": "server_error" }, { "condition": "Videosisältöä ei ole julkaistu.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Tarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Anna tekstikehote ja tuettu kesto kokonaisina sekunteina. Käytä täsmälleen lueteltua kokoa tai resoluutiota ja kuvasuhdetta, jotka muodostavat luetellut mitat.", "required": [ "model", "prompt", "duration" ], "required_material": "Kirjoitettu kehote." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images on oliotaulukko, jossa on type=image_url, url-kentän sisältävä image_url ja frame_type. Käytä julkista HTTPS-kuvan URL-osoitetta; first_frame ja last_frame saavat kumpikin esiintyä kerran. Käytä lueteltua tuloskokoa tai yhteensopivia mittoja. Älä lisää videoviitteitä.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Kirjoitettu kehote ja ruutukuva." }, { "mode": "Reference to video", "model": { "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "input_references on taulukko. Jokaisessa oliossa on type=image_url tai type=audio_url sekä vastaava url-kentän sisältävä URL-olio. Käytä julkisia HTTPS-linkkejä. Jätä frame_images pois valitaksesi viitetilan. Videoviitteitä ei voida hinnoitella.", "required": [ "model", "prompt", "duration", "input_references" ], "required_material": "Kirjoitettu kehote sekä kuva- tai ääniviitteet." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Tämän videon nollasta alkava sijainti tulosluettelossa.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Allekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Alkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Alkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Videon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videon leveys pikseleinä; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Videon korkeus pikseleinä; null, jos tietoa ei ole saatavilla.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Videokoodekin tunniste; null, jos sitä ei ole kirjattu.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Sisältääkö video ääniraidan; null, jos asiaa ei ole mitattu.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Äänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "bytedance/seedance-2.0-fast" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "bytedance/seedance-2.0-fast" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480p", "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "480p", "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "type": "string" }, { "availability": "source_interface", "conditions": "generate_audio-kentän pois jättäminen valitsee äänen sisältävän hinnan; false valitsee äänettömän hinnan. Tarkista tuloksen has_audio-kentästä, palautettiinko ääniraita.", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Nämä avaimet koskevat jokaista kuvaoliota. Jätä frame_images pois pelkkää tekstiä sisältävästä pyynnöstä.", "content": "Kuvaolioiden taulukko. Jokaisessa on type=image_url, url-kentän sisältävä image_url ja frame_type=first_frame tai last_frame. Kukin rooli esiintyy enintään kerran. Käytä julkisia HTTPS-kuvan URL-osoitteita.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "conditions": "Jätä frame_images pois käyttääksesi viitetilaa. Käytä julkisia HTTPS-osoitteita.", "content": "Kuva- tai ääniviiteolioiden taulukko. Aseta type-kentän arvoksi image_url tai audio_url ja anna vastaava url-kentän sisältävä URL-olio. Videoviitteitä ei edelleenkään voida hinnoitella.", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "input_references", "required": false, "schema": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 9223372036854775807, "minimum": -9223372036854775808, "name": "seed", "required": false, "schema": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "1:1", "3:4", "9:16", "4:3", "16:9", "21:9", "9:21" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": { "oneOf": [ { "additionalProperties": false, "properties": { "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url" ], "type": "object" }, { "additionalProperties": false, "properties": { "audio_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "audio_url" } }, "required": [ "type", "audio_url" ], "type": "object" } ] }, "type": "array" }, "model": { "const": "bytedance/seedance-2.0-fast" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "480p", "720p" ] }, "seed": { "maximum": 9223372036854775807, "minimum": -9223372036854775808, "type": "integer" }, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "480x480", "480x640", "480x854", "640x480", "854x480", "1120x480", "720x720", "720x960", "720x1280", "720x1680", "960x720", "1280x720", "1680x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist.", "Request geometry is required for the pre-generation estimate and reserve. Returned geometry and track time describe the generated output; final charge follows the actual billed configuration.", "Video references with *_with_video_input quantity are rejected; image/audio references only where model reference types admit them." ] }, "unsupported": [ "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image", "audio" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "seed", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images", "reference_to_video" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Videotokenin hinta", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu.", "dimensions": { "conditions": "syöte: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Videotokenin hinta", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Arvioitu luontikustannus", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('request.json').write_text('{\"model\":\"bytedance/seedance-2.0-fast\",\"prompt\":\"A serene mountain landscape at sunset\",\"duration\":4,\"resolution\":\"480p\",\"size\":\"480x480\",\"generate_audio\":false}', encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')\n target=Path('owned-'+label+'.bin')\n subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image", "audio" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "input: with_video_input", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" } ] }, { "basis": "The video-token rate is the primary price reference. Per-second headline estimates are separate references, not an extra charge.", "dimensions": { "conditions": "audio: without_audio", "quoted_unit": "per 1,000 video tokens" }, "label": "Video-token price", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.00495000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_with_video_input", "label": "Video-token price", "native_amount_usd_per_unit": "0.00000495", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "reference", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "video_tokens_without_audio", "label": "Video-token price", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "public_unit_label": "per 1,000 video tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_token" }, { "amount": "0.18144", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "0.18144", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "bytedance/seedance-2.0-fast", "request_model_id": "bytedance/seedance-2.0-fast", "route_label": "Ultra" } ], "name": "ByteDance: Seedance 2.0 Fast", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 0.18144, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 0.18144, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000112", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": false, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": false, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "manufacturer_reference" }, "dimensions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "label": "Ultra", "units": [ { "amount": "0.0000066", "amount_unit": "usd_per_token", "conditions": { "billable_token_source": "usage.completion_tokens", "estimated_quantity_formula": "(input_video_duration+output_video_duration)*output_width*output_height*output_fps/1024", "image_audio_ref_independent_charge": "not listed separately in this tariff", "input_includes_video": true, "maker_model_id": "dreamina-seedance-2-0-fast-260128", "minimum_token_schedule": "depends on resolution/aspect/output duration; separate official estimate table, actual usage governs", "minimum_tokens_when_video_input": true, "offline_not_supported": true, "quoted_unit": "1000000_video_tokens", "resolution": "480p/720p" }, "key": "base", "label": "base", "profile_index": 1, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "video_token" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "basis": "video token", "billing_original_currency": "USD", "billing_original_rate": "0.0000084", "key": "video_tokens", "label": "video token", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.0084000", "amount_unit": "usd_per_thousand_tokens", "basis": "audio=false", "billing_original_currency": "USD", "billing_original_rate": "0.0000084", "key": "video_tokens_without_audio", "label": "video token", "native_amount_usd_per_unit": "0.0000084", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" }, { "amount": "0.004950000", "amount_unit": "usd_per_thousand_tokens", "basis": "video_reference_present Source-only tariff component.", "billing_original_currency": "USD", "billing_original_rate": "0.000004950", "key": "video_tokens_with_video_input", "label": "video token", "native_amount_usd_per_unit": "0.000004950", "native_quantity": 1, "quantity": 1000, "side": "out", "unit": "video_token" } ] } ], "public_id": "bytedance/seedance-2.0-fast", "short": "ByteDance Seedance 2.0 Fast luo audiovisuaalisia kohtauksia tekstistä sekä kuva-, video- ja ääniviitteistä. Nopeuteen suunnattu versio tukee liikkeen ja tyylin siirtoa, videomuokkauksia ja jatkamista eteen- tai taaksepäin dokumentoiduilla 480p- ja 720p-tulosteilla." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "ByteDance Seedance 2.0 Fast luo audiovisuaalisia kohtauksia tekstistä sekä kuva-, video- ja ääniviitteistä. Nopeuteen suunnattu versio tukee liikkeen ja tyylin siirtoa, videomuokkauksia ja jatkamista eteen- tai taaksepäin dokumentoiduilla 480p- ja 720p-tulosteilla.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_exact_canonical_sha256": "80cfc33075db80dbcf1aac91eb64c2eaaaf570b97d9b91cc83f8b686c4460710", "raw_model_js_projection_sha256": "afd035903f5957a927c7a10e906d1efa4990b3e3d37847eb578316ade1ad8841", "raw_model_json_sha256": "80cfc33075db80dbcf1aac91eb64c2eaaaf570b97d9b91cc83f8b686c4460710", "renderer_sha256": "303a59603e2bc29ba8fda690e95fd32cec68de223d92e26054a88babff801dd7" }, "sourceRevision": "36abfb2d599319819083dd1f75ddc4844b8f73725bb1096502c4c20cde9e40e4" }