Näin käytät Seedance 2.5:tä | Kentät, rajat, laskutus

Näin käytät Seedance 2.5:tä isännöidyn API:n kautta: pyynnön kentät ja rajat, referenssimedian säännöt, kyselysilmukka, laskutetut sekunnit ja virhe 80006.
Seedance 2.5:n käytön osaaminen on enimmäkseen sen pyyntömuodon osaamista. Yksi kutsu kantaa promptin, neljä tuotosasetusta ja enintään kolmenlaista referenssimediaa; alusta palauttaa tehtävän id:n; valmis video noudetaan kyselemällä. Mekaniikat jotka eroavat vanhemmasta versiosta ovat 30 sekunnin katto, referenssibudjetin koko ja laskutussääntö joka tekee referenssivideosta kalliimman kuin hintataulukko antaa ymmärtää.
Varmista ennen kaikkea muuta että olet 2.5:ssä
Useat isännät pitivät Seedance 2.0:n oletuksena kun lisäsivät 2.5:n sen rinnalle, joten mallimerkkijono ratkaisee mitä saat. Julkaistu 2.5-versio tarjoillaan tunnisteella joka päättyy -face. Vanhemmat koodiesimerkit siteeraavat tunnistetta ilman tuota päätettä, eikä se enää ratkea.
Toinen tarkistus ei vaadi koodin lukemista. Lähetä pyyntö 20 sekunnin generoinnista. 2.0:ssa se hylätään kestokentästä ennen kuin tehtävää on olemassa, joten mitään ei veloiteta.
Näin käytät Seedance 2.5:tä isännöidyn API:n kautta
Generointipyyntö ottaa nämä kentät.
| Kenttä | Vaihteluväli | Oletus |
|---|---|---|
prompt | enintään 20,000 merkkiä | ei mitään |
duration | 4–30 sekuntia, tai -1 | 5 |
resolution | 480p, 720p, 1080p | 720p |
aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive | adaptive |
generate_audio | true tai false | true |
content_filter | true tai false | true |
Prompti vaaditaan text-to-video-generoinnissa ja on valinnainen heti kun referenssimediaa on läsnä. Sen sisällä lainausmerkeissä olevat rivit generoidaan puheeksi samassa ajossa kuvan kanssa, monoraitana joka kattaa dialogin, tehosteet ja musiikin.
Kentän duration asettaminen arvoon -1 antaa kestopäätöksen mallille. Varaus otetaan 30 sekunnin katosta, joten budjetoi täyspitkä klippi kun käytät sitä.
Näiden lisäksi pyyntö paljastaa kentän output_format mp4:lle tai mov:lle, sekä kentät bitrate_mode, watermark, return_last_frame, seed, image_with_roles, omni_reference_task_type ja tools-taulukon. return_last_frame on se kenttä jolla on merkitystä ketjutuksessa, koska yhden generoinnin viimeinen ruutu on se joka siementää seuraavan.
Referenssimedian säännöt jotka hylkäävät pyynnön
Referenssimedian validointi on tiukkaa ja se laukeaa ennen kuin tehtävä luodaan, mikä tekee hylkäyksestä ilmaisen mutta myös helpon osua toistuvasti.
- Kuvat: enintään 30 pyyntöä kohti, jpeg, png, webp, bmp, tiff, gif, heic tai heif, kukin alle 30 MB.
- Video: enintään 10 klippiä, mp4 tai mov, kukin enintään 200 MB, kukin 2–30 sekuntia, yhteensä 30 sekuntia.
- Ääni: enintään 10 raitaa, wav tai mp3, kukin enintään 15 MB, kukin 2–30 sekuntia, yhteensä 30 sekuntia.
Jokainen näistä on julkinen HTTP(S)-URL. Data-URI:t hylätään koko alustalla, joten isännöi tiedosto ensin.
Referenssikuvat ja -ääni eivät lisää laskuun mitään. Referenssivideo lisää, kahdella tavalla, ja se on seuraava osio.
Laskun laskeminen ennen lähettämistä
Laskutus tapahtuu valmiin videon sekunneissa hinnalla, jonka määrää tarkkuus ja se oliko referenssivideo liitettynä.
| Tarkkuus | Pelkkä generointi | Referenssivideon kanssa |
|---|---|---|
| 480p | $0.118589 | $0.071153 |
| 720p | $0.266824 | $0.160094 |
| 1080p | $0.461856 | $0.275904 |
Laskutetut sekunnit ovat kahdesta luvusta suurempi: ylöspäin pyöristetty referenssivideon kesto plus tuotoksen kesto, tai ylöspäin pyöristetty viisi kolmasosaa tuotoksen kestosta.
Kaksi laskettua esimerkkiä näyttää miksi sillä on merkitystä.
Kymmenen sekunnin 1080p-generointi ilman referenssiklippiä laskuttaa kymmenen sekuntia hintaan $0.461856, eli noin $4.62.
Sama kymmenen sekunnin 1080p-tuotos kuusisekuntisella referenssiklipillä laskuttaa suuremman luvuista 16 sekuntia ja 17 sekuntia, siis 17 sekuntia hintaan $0.275904, eli noin $4.69. Alaraja syö matalamman sekuntihinnan hyödyn.
Pienempi työ näyttää vaikutuksen terävämmin. Viiden sekunnin 720p-tuotos kolmisekuntisella referenssiklipillä laskuttaa yhdeksän sekuntia kahdeksan sijaan, mikä tekee noin $1.44, kun samat viisi sekuntia tyhjästä generoituna on runsaat $1.33.
Kysely, ajoitus ja hyvitykset
Työ on asynkroninen. Lähettäminen palauttaa tehtävän id:n, ja video noudetaan kyselemällä tuota tehtävää kunnes se ilmoittaa valmistumisesta.
Generointi kestää keskimäärin kahdesta viiteen minuuttia. Kysely on ilmaista, joten kiinteä viidentoista tai kahdenkymmenen sekunnin väli on järkevä eikä aggressiivisesta harventamisesta ole hyötyä.
Epäonnistuneet työt hyvitetään täysimääräisesti. Epäonnistuneen tehtävän käyttöluvut näyttävät palasiko varattu määrä, ja se kannattaa tarkistaa kun erä on käyttäytynyt oudosti.
Hylkäyksen lukeminen
Turvallisuushylkäykset palauttavat virheen 80006. Virhe ei yksilöi mikä vaihe laukesi, joten syy voi olla prompti, referenssitiedosto tai generoitu tuotos.
Aloita promptista. Nimetyt oikeat julkisuuden henkilöt, kolmannen osapuolen immateriaalioikeudet ja laiton sisältö on estetty mallin sisällä, eikä mikään isännän asetus poista niitä. Tarkista sitten referenssikuvat, koska kasvot tai logo toimitetussa valokuvassa voi laukaista saman tuloksen kuin niiden nimeäminen.
Kentän content_filter oletusarvo on true. Sen asettaminen falseksi reitittää pyynnön vähemmän rajoittavan kanavan kautta eikä poista valvontaa käytöstä. Se on reitityssäädin eikä kytkin, ja vanhempi alias nsfw_checker menee yhä validoinnista läpi.
Usein kysytyt kysymykset
Mitä mallimerkkijonoa kutsun Seedance 2.5:lle?
Julkaistu versio kantaa tunnistetta joka päättyy -face. Tunnisteet ilman tuota päätettä tulevat julkaisua edeltävistä esimerkeistä eivätkä enää ratkea.
Miten generoin yli 30 sekunnin klipin?
Ketjuttamalla generointeja. Kolmekymmentä sekuntia on pyyntökohtainen katto, joten pidemmät teokset ovat erillisiä töitä jotka liitetään editorissa, ja return_last_frame antaa puhtaan luovutuskohdan.
Miksi referenssivideo maksoi enemmän kuin hintataulukko antoi ymmärtää? Referenssiklipistä laskutetaan sen oma kesto tuotoksen päälle, eikä pyynnöstä koskaan laskuteta vähempää kuin viisi kolmasosaa tuotoksen kestosta ylöspäin pyöristettynä. Kumpi luvuista on suurempi, siitä tulee laskutetut sekunnit.
Päästääkö sisältösuodattimen pois kytkeminen mitä tahansa läpi?
Ei. content_filter-arvon asettaminen falseksi valitsee vähemmän rajoittavan kanavan, ja valvonta pätee yhä. Mallitason estot oikeille julkisuuden henkilöille, kolmannen osapuolen IP:lle ja laittomalle sisällölle pysyvät voimassa siitä riippumatta.
Lyhyesti
Seedance 2.5:n käyttö järjestyksessä: varmista -face-mallimerkkijono, aseta kesto 4 ja 30 sekunnin väliin, valitse tarkkuus ja kuvasuhde, jätä ääni päälle ellet halua hiljaisuutta, liitä referenssikuvia vapaasti koska ne ovat ilmaisia, lähetä, ja kysele sitten viidentoista sekunnin välein kahdesta viiteen minuuttia. Hinnoittele työ laskutettujen sekuntien eikä tuotossekuntien mukaan aina kun referenssivideo on mukana, ja kohtele virhettä 80006 hyvityksenä plus uudelleenkirjoituksena.


