Seedance 2.5 API: päätepiste, parametrit ja todellinen laskutus
Seedance 2.5 API on asynkroninen, hinnoiteltu sekunneittain, ja siinä on kolme laskutussääntöä jotka yllättävät. Kaikki mitä tarvitset ennen ensimmäisen kutsun kirjoittamista.
Alkaen $0.07 sekunnilta, 480p referenssiklipin kanssa
Mitä Seedance 2.5 API antaa sinulle
Yksi POST luo työn, yksi GET kyselee sen tilaa, ja kysely on ilmaista. Seedance 2.5 API päättelee tilansa siitä, mitkä mediakentät täytät, eikä erillisestä parametrista.
Pelkkä prompti on text-to-video. Lisää kuvia, niin Seedance 2.5 API ajaa image-to-video. Lisää ensimmäinen ja viimeinen ruutu, niin se animoi siirtymän. Lisää lähdeklippi, niin se muokkaa tai jatkaa.
POST palauttaa tehtävän id:n heti ja generointi kestää kahdesta viiteen minuuttia. Seedance 2.5 API -integraatio tarvitsee kyselysilmukan tai jonon, ei synkronista pyyntöä.
Alusta tarjoaa sen nimellä doubao-seedance-2.5-face. Seedance 2.5 API:n mallimerkkijonon kirjoittaminen väärin on yleisin ensimmäisen kutsun virhe, ja se palauttaa synkronisen virheen eikä veloitusta.
Yksi otsake, työtilakohtainen, ei projektin id:tä. Seedance 2.5 API -avain kantaa sen työtilan laskutusalueen, joka sen myönsi.
Jokainen epäonnistunut työ palauttaa krediitit kokonaan, myös moderoinnin hylkäykset. Seedance 2.5 API ei koskaan veloita renderöinnistä, jota et saanut.
Täällä ei ole generaattoria. Seedance 2.5 API -kutsut ajetaan hostatulla API:lla, ja jokainen alla oleva parametri ja hinta on otettu sen julkaistusta dokumentaatiosta.
Seedance 2.5 API:n tärkeimmät parametrit
Neljä kenttää, jotka ratkaisevat kustannuksen ja lopputuloksen.
duration
Neljästä kolmeenkymmeneen sekuntia, oletus viisi. Arvo -1 antaa mallin valita, mutta Seedance 2.5 API varaa krediitit 30 sekunnin katon mukaan ja hyvittää erotuksen, mikä voi laukaista 402:n ohuella saldolla.
resolution
480p, 720p tai 1080p, oletus 720p. Seedance 2.5 API:ssa ei ole 4K:ta, ja sen pyytäminen palauttaa virheen eikä heikennettyä klippiä.
content_filter
Totuusarvo, oletuksena true. False ohjaa Seedance 2.5 API -pyynnön vähemmän rajoittavaan kanavaan ja tekee promptista pakollisen. Alusta dokumentoi sen reitityksenä eikä katkaisijana.
omni_reference_task_type
Ilmoita edit tai extend, niin Seedance 2.5 API validoi säännöt lähetyshetkellä sen sijaan että kaataisi työn minuutteja myöhemmin. Kannattaa asettaa jokaisessa referenssipohjaisessa työssä.
Neljä askelta toimivaan Seedance 2.5 API -kutsuun
- 1
Luo avain
Luo avain alustan hallintapaneelissa ja lähetä se bearer-tokenina. Seedance 2.5 API hylkää kaiken muun authorization-otsakkeessa.
- 2
POSTaa työ
Lähetä malli, prompti ja mahdolliset media-URL:t videoiden generointipäätepisteeseen. Jokainen Seedance 2.5 API:n mediakenttä ottaa vastaan julkisia HTTP- tai HTTPS-osoitteita; base64 hylätään koko alustalla.
- 3
Kysele tehtävän tilaa
Tee GET tehtävän id:llä kunnes tila on completed tai failed. Seedance 2.5 API:n tilan kysely ei maksa mitään, joten kahden sekunnin väli riittää.
- 4
Lue lopputulos
Valmis Seedance 2.5 API -tehtävä sisältää videoiden URL-osoitteet ja lisäksi viimeisen ruudun osoitteen, jos sitä pyysit. Vie itsellesi talteen kaikki mitä haluat säilyttää, koska toimitetut URL-osoitteet eivät ole pysyviä.
Seedance 2.5 API: vastaukset
Laskutettavan videon sekunneista, $0.071153–$0.461856 riippuen resoluutiosta ja siitä, sisälsikö pyyntö referenssiklipin. Kymmenen sekunnin 1080p-renderöinti maksaa noin $4.62. Referenssikuvat ja referenssiääni eivät lisää laskuun mitään.
Tuotoksen kesto plus jokaisen referenssivideon koko pituus, ja jokaisessa videota sisältävässä pyynnössä vähimmäismäärä on viisi kolmasosaa tuotoksen kestosta. Kahden sekunnin lähde ja viiden sekunnin tuotos laskutetaan yhdeksänä sekuntina seitsemän sijaan, mikä yllättää useimmat ensimmäiset integraatiot.
doubao-seedance-2.5-face hostatulla API:lla. Vanhemmat oppaat mainitsevat doubao-seedance-2.5 ilman päätettä, mikä on julkaisua edeltävä nimi eikä toimi. Tarkista mallin sivu äläkä luota koodiesimerkkiin.
Tilan kysely on dokumentoitu tapa ja se on ilmaista, joten lyhyt kyselysilmukka on yksinkertaisin Seedance 2.5 API -integraatio. Koska generointi kestää kahdesta viiteen minuuttia, kahden tai viiden sekunnin kyselyväli ei aiheuta merkittävää kuormaa eikä vaadi callback-infrastruktuuria.
Skeeman validointi, eikä mitään veloitettu. Yleisiä syitä ovat kelvoton resoluutio, size-arvo yhdistettynä ensimmäiseen tai viimeiseen ruutuun, tai puuttuva prompti text-to-video-pyynnössä. Virhe nimeää ongelmallisen kentän.
Joko tehtävätyypin sääntö tai moderointi. Virhe 80006 on turvallisuushylkäys eikä nimeä vaihetta. Parametriristiriita muokkaustyössä tuottaa erilaisen virheen, ja omni_reference_task_type-kentän ilmoittaminen muuttaa sen seuraavalla kerralla välittömäksi 400:ksi.
Enintään 30 kuvaa, 10 videoklippiä yhteensä 30 sekuntia ja 10 ääniraitaa. Kuvataulukko ja roolimerkityt kuvataulukot ovat toisensa poissulkevia, joten valitse yksi kutakin Seedance 2.5 API -pyyntöä kohti.
Kyllä, samassa päätepisteessä eri mallin id:llä. Seedance 2.0 katkaisee 15 sekuntiin siinä missä 2.5 yltää 30:een, ja pyynnön muoto on riittävän lähellä, että version vaihtaminen on lähinnä merkkijonon muutos.
Avain kantaa sen työtilan laskutusalueen, joka sen myönsi, eikä erillistä projektiotsaketta ole. Tiimit, jotka tarvitsevat erillisen kirjanpidon, luovat erilliset työtilat eivätkä erillisiä avaimia yhden sisään, koska käyttö kootaan työtilan tasolla.
Aloita Seedance 2.5 API:n dokumentaatiosta
Julkaistut parametrit, ajantasaiset sekuntihinnat, ilmainen tilan kysely ja automaattiset hyvitykset epäonnistumisista.
Liittyvät: Seedance 2.5 API