Seedance 2.5 Flash
Luo videoita Seedance 2.5 Flash -mallilla käyttäen tekstiä, ensimmäistä ja viimeistä kehystä tai multimodaalisia viitteitä. Tämä sivu kattaa koko työnkulun pyynnöstä valmiiseen tulokseen.
Mallin API-tunniste: seedance-2-5-flash
Videon luominen tapahtuu asynkronisesti. Tallenna luontipyynnön palauttama taskId ja kysy sen tilaa tai ota vastaan webhook-ilmoitus.
Ominaisuudet
| Ominaisuus | Tuetut arvot |
|---|---|
| Tulostarkkuus | 480p · 720p |
| Tuloksen kesto | 4–30 sekuntia |
| Kuvasuhde | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive |
| Viitekuvat | Enintään 30 kuvaa |
| Viitevideot | Enintään 10 videota |
| Viiteäänitiedostot | Enintään 10 äänitiedostoa |
| Kaikki viitemateriaalit yhteensä | Yhteensä enintään 50 viitetiedostoa |
| Kokonaiskesto video-/ääniryhmää kohti | 30 sekuntia |
| seed | -1 – 2147483647 |
Hinnoittelu ja krediitit
Videoiden luominen veloitetaan krediitteinä sekuntiperusteisen laskutettavan keston mukaan. Jos videosisältöä ei käytetä syötteensä, laskutettava kesto on luodun videon pituus. Jos videosisältöä käytetään syötteenä, kesto sisältää myös viitevideon pituuden.
Alla olevassa taulukossa näytetään sekuntikohtaiset krediittiveloitukset, ei tehtävän kokonaiskustannusta. Hinta määräytyy mallin, resoluution sekä sen mukaan, käytetäänkö viitevideoita (reference-to-video-tila). Taulukon alla olevista kaavoista ja esimerkeistä näet, miten kokonaiskustannus lasketaan.
| Tulostarkkuus | Ilman videosisääntuloa | Videosisääntulon kanssa |
|---|---|---|
480p | 7 saldoa/sekunti | 5 saldoa/sekunti |
720p | 10 saldoa/sekunti | 7 saldoa/sekunti |
- Ilman videosisääntuloa: valmiin videon sekunnit × hinta ilman videota.
- Videosisääntulon kanssa: (valmiin videon sekunnit + mitatun viitevideon sekunnit) × hinta videon kanssa. Palvelin mittaa viitevideon kokonaiskeston ja pyöristää sen ylöspäin täysiin sekunteihin ennen veloitusta.
- Pelkkiä kuva- tai ääniviitteitä käytettäessä sovelletaan ilman videota -hintaa. Viitevideon laskutushintaa käytetään vain reference-to-video-tilassa silloin, kun pyynnössä toimitetaan videoviitteitä.
Laskutusesimerkit
5 sekunnin 720p tekstistä videoksi -luonti: 5 × 10 = 50 krediittiä.
5 sekunnin 720p-video 5 sekunnin viitevideolla: (5 + 5) × 7 = 70 krediittiä.
Krediitit varataan pyynnön yhteydessä ja veloitetaan, kun luonti onnistuu. Epäonnistuneet tai aikakatkaistut tehtävät siirtyvät hyvityskiertoon. Laskutustila refund_failed tarkoittaa, ettei hyvitystä voitu viedä loppuun; tarkista API-logit tai ota yhteys tukeen.
Miten saldoa veloitetaan, kun duration=-1
Kun kestoksi on asetettu -1, lopullisen videon kesto ei ole kiinteä, vaan malli määrittää sen.
Suosittelemme asettamaan kestoksi todellisen tarvitsemasi videomitan arvon -1 sijaan. Käytä arvoa -1 vain videon muokkaukseen, älä muihin videon luontitilanteisiin.
| Lähdemateriaalit | Miten veloitus lasketaan | Esimerkki |
|---|---|---|
| Kun käytössä on viitevideoita | Laske kaikkien viitevideoiden kesto yhteen ja pyöristä summa seuraavaan kokonaiseen sekuntiin (tätä kutsutaan nimellä T). Veloitus on (T + T) × videollinen hinta: toinen T vastaa arvioitua tuotoksen kestoa ja toinen syötetyn videon kestoa. | 720p 5 sekunnin viitevideolla: (5 + 5) × 7 = 70 saldoa. |
| Ilman viitevideoita (vain kuvia tai audiota) | Arvioituna tuotoksen kestona käytetään 30 sekuntia. Veloitus on 30 × videoton hinta. | 720p ilman viitevideoita: 30 × 10 = 300 saldoa. |
Autentikointi
Luo API-avain hallintapaneelissa. Täydellinen avain näytetään vain kerran. Säilytä se turvallisesti palvelimellasi ja lähetä se Bearer-tokenina jokaisen pyynnön yhteydessä.
Perus-URL
https://api.seevio.aiAuthorization: Bearer sk_live_your_api_key
Content-Type: application/jsonAseta SEEVIO_API_KEY-ympäristömuuttuja ennen näiden esimerkkien suorittamista. JavaScript-esimerkit ajetaan palvelimellasi Node.js-ympäristössä; Python-esimerkeissä käytetään requests-kirjastoa.
Pika-aloitus
Lähetä tämä minimipyyntö, tallenna palautettu taskId ja käytä alla olevaa tehtäväkyselyn esimerkkiä. Luontivastauksessa näkyvä krediittisumma on varattu enimmäismäärä.
curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEVIO_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedance-2-5-flash",
"input": {
"prompt": "A cat surfing at sunset, cinematic lighting",
"duration": 5,
"resolution": "720p",
"seed": 42,
"generation_type": "text-to-video",
"aspect_ratio": "16:9",
"generate_audio": true
}
}'Esimerkki tehtävän luonnin vastauksesta
Kun yllä oleva pyyntö on hyväksytty, API palauttaa tämän JSON-vastauksen. taskId on tehtävätunniste, jota käytetään myöhemmissä tilakyselyissä; credits tarkoittaa tälle tehtävälle varattujen hyvitysten määrää. Tämä vastaus vahvistaa vain tehtävän luomisen, ei sitä, että video on valmis. Sinun on seurattava tehtävän tilaa kyselyillä tai käytettävä webhookia saadaksesi valmiin videon tulokset.
{
"taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
"credits": 50
}Luo tehtävä
POST https://api.seevio.ai/v1/videos/generationsLähetä JSON-objekti, joka sisältää mallin (model) ja syötteen (input) sekä valinnaisen takaisinkutsuosoitteen (callback_url). Määritä aina tällä sivulla näkyvä mallitunnus (model ID). Jos mallia ei määritetä, käyttöön otetaan seedance-2-0.
Pyyntörunko
| Kenttä | Tyyppi | Pakollinen | Kuvaus ja rajoitukset |
|---|---|---|---|
model | string | Kyllä | Mallitunnus. Jos haluat käyttää mallia Seedance 2.5 Flash, määritä tämän kentän arvoksi seedance-2-5-flash. |
callback_url | string | Ei | Julkinen HTTPS-päätepiste onnistuneille ja epäonnistuneille POST-kutsuille. Yksityisiä verkkoja tai localhost-osoitteita ei sallita. Esimerkki: https://example.com/webhooks/seevio |
input | object | Kyllä | Luontiasetukset. Pitää sisältää prompt-tekstisyöte, joka ei ole tyhjä. |
Syöteparametrit
Anna parametrit image_urls, video_urls ja audio_urls URL-merkkijonojen taulukkoina (string[]). Jokaisen toimitetun URL-osoitteen on oltava julkisesti saatavilla HTTPS-yhteyden kautta, mukaan lukien valitun tilan sivuuttama media.
| Kenttä | Tyyppi | Pakollinen | Oletus | Kuvaus ja rajoitukset |
|---|---|---|---|---|
input.prompt | string | Kyllä | — | Kehete on pakollinen jokaisessa tilassa. Se voi sisältää enintään 10 000 merkkiä ennen välistysten poistoa, eikä se voi koostua pelkistä tyhjämerkeistä. Esimerkki: A cat surfing at sunset |
input.generation_type | string | Ei | text-to-video | Tuetut arvot text-to-video | image-to-video | reference-to-videotext-to-video, image-to-video tai reference-to-video. Jos tämä puuttuu, oletuksena on text-to-video ja se käyttää vain prompt-kenttää. image-to-video käyttää 1–2 järjestettyä kehyskuvaa. reference-to-video käyttää kuvia, videoita ja/tai ääntä; pelkkää ääntä käyttäviä viitteitä tuetaan pakollisen prompt-kentän kanssa. |
input.image_urls | string[] | Ehdollinen | [] | Toimita kuva-URL-osoitteita ohjaamaan ulkoasua. image-to-video-tilassa anna 1 kuva ensimmäiseksi kehykseksi tai 2 kuvaa järjestyksessä ensimmäinen kehys, viimeinen kehys. reference-to-video-tilassa anna enintään 30 kuvaa. Kunkin kuvan on oltava kooltaan alle 30 MB; katso alta mediatiedostojen vaatimukset muotojen ja mittojen osalta. Kaikki viitetyypit yhdistettynä sallivat enintään 50 tiedostoa. Jos puuttuu, oletus on []; ohitetaan text-to-video-tilassa. Esimerkki: ["https://example.com/first-frame.jpg"] |
input.video_urls | string[] | Ehdollinen | [] | Toimita viitevideon URL-osoitteita ohjaamaan liikettä tai muokkaamaan/jatkamaan videota, vain reference-to-video-tilassa. Enintään 10 tiedostoa, kukin enintään 100 MB ja 2–30 sekuntia pitkä; niiden kokonaiskesto ei saa ylittää 30 sekuntia. Kaikki viitetyypit yhdistettynä sallivat enintään 50 tiedostoa. Palvelin mittaa videon keston laskutusta varten. Jos puuttuu, oletus on []; ohitetaan muissa tiloissa. Esimerkki: ["https://example.com/source.mp4"] |
input.audio_urls | string[] | Ehdollinen | [] | Toimita viiteäänen URL-osoitteita ohjaamaan ääntä, vain reference-to-video-tilassa. Enintään 10 MP3-/WAV-tiedostoa, kukin enintään 15 MB ja 2–30 sekuntia pitkä; niiden kokonaiskesto ei saa ylittää 30 sekuntia. Kaikki viitetyypit yhdistettynä sallivat enintään 50 tiedostoa. Ääni voi olla ainoa viitetyyppi; prompt-teksti on edelleen pakollinen. Jos puuttuu, oletus on []; ohitetaan muissa tiloissa. Esimerkki: ["https://example.com/music.mp3"] |
input.duration | integer | Ei | 5 | Tuetut arvot -1 | 4–30Valmiin videon kesto kokonaislukuna välillä 4–30 sekuntia. Hyväksyy myös arvon -1 ainoastaan reference-to-video-tilassa. Käytä tätä lähdevideon kanssa muokkausta varten; laskutuksessa noudatetaan yllä mainittua erityissääntöä. Esimerkki: 5 |
input.aspect_ratio | string | Ei | adaptive | Tuetut arvot 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9, 4:3, 1:1, 3:4, 9:16, 21:9 tai adaptive. Jos puuttuu, oletus on adaptive, jolloin malli määrittää tulosteen kuvasuhteen. Käytä videon muokkaukseen tai jatkamiseen arvoa adaptive. image-to-video hyväksyy vain arvon adaptive; jätä tämä kenttä pois tai aseta sen arvoksi adaptive. Esimerkki: adaptive |
input.resolution | string | Ei | 720p | Tuetut arvot 480p | 720p480p tai 720p. Jos puuttuu, oletus on 720p kaikissa tuetuissa luontitiloissa. Korkeammat resoluutiot hylätään. Esimerkki: 720p |
input.generate_audio | boolean | Ei | true | Tuetut arvot true | falseArvo true pyytää synkronoitua ääntä; false ottaa äänen luonnin pois käytöstä. Jos puuttuu, oletus on true. Koskee kaikkia tuettuja luontitiloja. Esimerkki: true |
input.watermark | boolean | Ei | false | Tuetut arvot true | falseArvo true pyytää tekoälyvesileiman tulosteeseen; false pyytää tulosteen ilman vesileimaa. Jos puuttuu, oletus on false. Koskee kaikkia tuettuja luontitiloja. Esimerkki: false |
input.web_search | boolean | Ei | false | Tuetut arvot true | falseArvo true sallii verkkohaun, kun se on saatavilla mallille; false ottaa sen pois käytöstä. Jos puuttuu, oletus on false. Käyttöönotto ei takaa, että haku suoritetaan. Esimerkki: false |
input.return_last_frame | boolean | Ei | false | Tuetut arvot true | falseArvo true pyytää luodun videon viimeistä kehystä; false ei pyydä sitä. Jos puuttuu, oletus on false. Koskee kaikkia tuettuja luontitiloja. Kun kehystä pyydetään ja se on saatavilla, URL palautetaan kentässä data.last_frame_url; muuten se on null. Esimerkki: true |
input.seed | integer | Ei | — | Tuetut arvot -1 – 2147483647Kokonaisluku väliltä -1 ja 2147483647. Arvo -1 valitsee satunnaisen siemenen. Esimerkki: 42 |
input.output_format | string | Ei | mp4 | Tuetut arvot mp4 | movmp4 tai mov. Jos puuttuu, oletus on mp4. Valitsee videon säiliömuodon kaikissa tuetuissa luontitiloissa. |
Totuusarvojen (boolean) on oltava JSON-muodossa true tai false (ei merkkijonoina tai numeroina).
Luontivastaus
HTTP 200 palauttaa kentät taskId (merkkijono) ja credits (numero). Tämä vahvistaa tehtävän vastaanoton, ei sen valmistumista. Alla oleva summa vastaa 5 sekunnin 720p-pika-aloitusta.
{
"taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
"credits": 50
}Luontitilat ja esimerkit
Tekstistä videoksi
Luo video tekstikuvauksesta. Medialinkkejä ei välitetä tässä tilassa.
curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEVIO_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedance-2-5-flash",
"input": {
"prompt": "A cat surfing at sunset, cinematic lighting",
"duration": 5,
"resolution": "720p",
"seed": 42,
"generation_type": "text-to-video",
"aspect_ratio": "16:9",
"generate_audio": true
}
}'Ensimmäinen kehys
Toimita yksi kuva ensimmäiseksi kehykseksi ja kuvaile liikettä prompt-kentässä.
curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEVIO_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedance-2-5-flash",
"input": {
"prompt": "A cat surfing at sunset, cinematic lighting",
"duration": 5,
"resolution": "720p",
"seed": 42,
"generation_type": "image-to-video",
"image_urls": [
"https://example.com/first-frame.jpg"
],
"aspect_ratio": "adaptive"
}
}'Ensimmäinen ja viimeinen kehys
Toimita kaksi kuvalinkkiä järjestyksessä: ensimmäinen kehys, sitten viimeinen kehys. Tämä esimerkki pyytää myös valmiin videon viimeistä kehystä.
curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEVIO_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedance-2-5-flash",
"input": {
"prompt": "A cat surfing at sunset, cinematic lighting",
"duration": 5,
"resolution": "720p",
"seed": 42,
"generation_type": "image-to-video",
"image_urls": [
"https://example.com/first-frame.jpg",
"https://example.com/last-frame.jpg"
],
"aspect_ratio": "adaptive",
"return_last_frame": true
}
}'Multimodaalinen viite
Yhdistä kuva-, video- ja ääniviitteitä. Tekstikuvaus (prompt) on edelleen pakollinen. Viitevideon käyttö muuttaa hinnoittelukaavaa.
curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEVIO_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedance-2-5-flash",
"input": {
"prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
"duration": 5,
"resolution": "720p",
"seed": 42,
"generation_type": "reference-to-video",
"image_urls": [
"https://example.com/character.jpg"
],
"video_urls": [
"https://example.com/camera.mp4"
],
"audio_urls": [
"https://example.com/ambience.mp3"
],
"aspect_ratio": "adaptive"
}
}'Ääniviite
Käytä ääntä ainoana viitetyyppinä ja kuvaile haluttua videota pakollisella tekstikuvauksella.
curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEVIO_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedance-2-5-flash",
"input": {
"prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
"duration": 5,
"resolution": "720p",
"seed": 42,
"generation_type": "reference-to-video",
"audio_urls": [
"https://example.com/music.mp3"
]
}
}'Videon muokkaus
Kuvaile muokkaus ja toimita lähdevideo. Aseta duration=-1 ja käytä mukautuvaa kuvasuhdetta (adaptive). Käytä vähintään 4 sekunnin pituista lähdeklippiä tässä työnkulussa. Erityinen laskutussääntö arvolle duration=-1 on esitetty yllä.
curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEVIO_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedance-2-5-flash",
"input": {
"prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
"duration": -1,
"resolution": "720p",
"seed": 42,
"generation_type": "reference-to-video",
"video_urls": [
"https://example.com/source.mp4"
],
"aspect_ratio": "adaptive"
}
}'Videon jatkaminen
Kuvaile, miten lähdevideon pitäisi jatkua. Käytä mukautuvaa kuvasuhdetta (adaptive) ja aseta normaali kesto mallin sallimissa rajoissa.
curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEVIO_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedance-2-5-flash",
"input": {
"prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
"duration": 8,
"resolution": "720p",
"seed": 42,
"generation_type": "reference-to-video",
"video_urls": [
"https://example.com/source.mp4"
],
"aspect_ratio": "adaptive"
}
}'Tehtävän kysely
GET https://api.seevio.ai/v1/tasks/{taskId}Korvaa esimerkkitunnus luonnin yhteydessä palautetulla taskId-tunnuksella. Kyselyt palauttavat vain ne tehtävät, jotka kuuluvat kyseisen API-avaimen käyttäjälle; tuntemattomat tunnukset palauttavat virheen HTTP 404.
Tee kyselyitä aluksi 10–20 sekunnin välein, hidasta tahtia, jos saat virheen HTTP 429, ja lopeta kyselyt, kun tilaksi vaihtuu completed tai failed. Suosi webhookeja tuotantoympäristössä. Jokainen alla oleva koodiesimerkki tekee yhden kyselyn.
curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
-H "Authorization: Bearer $SEEVIO_API_KEY"| Tila | Kuvaus ja rajoitukset |
|---|---|
queued | Hyväksytty ja odottaa käsittelyä jonossa. |
generating | Videon luominen on käynnissä. |
completed | Valmis (onnistunut). Lataa tulokset osoitteesta data.results ennen niiden vanhenemista. |
failed | Valmis (epäonnistunut). Tarkista kentät failed_reason ja billing_status. |
| Kenttä | Tyyppi | Kuvaus ja rajoitukset |
|---|---|---|
id | string | Tehtävän tunniste. Vastaa luontivastauksen kenttää taskId. |
created_at | number | Tehtävän luontiaika Unix-aikana (sekunteina). |
model | string | Tässä tehtävässä käytetty julkinen mallitunnus. |
billing_status | string | reserved, charged, refunded tai refund_failed. |
credits | number | Tehtävälle varatut krediitit. Tämä arvo säilyy hyvityksen jälkeen; tarkista lopullinen laskutustulos kentästä billing_status. |
failed_reason | string | null | Epäonnistumisen syy virheellisissä tehtävissä; muuten null. Epäonnistuneiden tehtävien kyselyvastauksista puuttuu data-kenttä. |
data | object | Mukana onnistuneissa tehtäväkyselyissä. Sisältää valmiin tiedoston tiedot ja käsittelytiedot. |
data.results | string[] | Videolinkkien taulukko. Tyhjä, kunnes tehtävä valmistuu tai jos video on jo vanhentunut. |
data.video_expires_at | string | null | Videon vanhenemisaika ISO 8601 -muodossa, tai null ennen kuin se on saatavilla. Tallenna valmis video ennen tätä ajankohtaa. |
data.last_frame_url | string | null | Viimeisen kehyksen URL-osoite, jos sitä on pyydetty ja se on saatavilla; muuten null. |
data.processing_time | number | null | Tehtävän käsittelyaika sekunteina, jos se on saatavilla, muussa tapauksessa null. |
Valmis tehtävä: kyselyn vastaus videotuloksilla
Kun kysely palauttaa arvon status=completed, videon luonti on päättynyt. Löydät videoiden URL-osoitteet kohdasta data.results. Lataa videot ennen kohdassa data.video_expires_at ilmoitettua ajankohtaa. Tila billing_status=charged osoittaa, että varatut krediitit on veloitettu.
{
"id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
"created_at": 1788652800,
"model": "seedance-2-5-flash",
"is_draft": false,
"draft_task_id": null,
"status": "completed",
"billing_status": "charged",
"credits": 50,
"failed_reason": null,
"data": {
"results": [
"https://cdn.seevio.ai/api/videos/example.mp4"
],
"video_expires_at": "2026-09-07T00:00:00Z",
"last_frame_url": null,
"processing_time": 48
}
}Epäonnistunut tehtävä: kyselyn vastaus virhe- ja veloitustiedoilla
Kun kysely palauttaa arvon status=failed, luonti on epäonnistunut. Kohdasta failed_reason näet virheen syyn ja kohdasta billing_status hyvityksen tilanteen. Tässä esimerkissä tila refunded tarkoittaa, että krediitit on palautettu. credits-kentässä näkyy alkuperäinen varattu määrä, eikä vastaus sisällä data-kenttää.
{
"id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
"created_at": 1788652800,
"model": "seedance-2-5-flash",
"is_draft": false,
"draft_task_id": null,
"status": "failed",
"billing_status": "refunded",
"credits": 50,
"failed_reason": "provider_failed"
}Webhookit
Aseta callback_url-osoite luontipyyntöön vastaanottaaksesi JSON-muotoisen POST-kutsun, kun tehtävä valmistuu tai epäonnistuu. Palauta 2xx-vastaus 15 sekunnin kuluessa. Epäonnistuneita lähetyksiä yritetään uudelleen; käsittele toistuvat kutsut idempotentisti tehtävätunnuksen (task ID) perusteella.
Takaisinkutsun päätepisteen on hyväksyttävä POST-pyyntöjä, joiden runko on JSON-muotoinen (Content-Type: application/json).
Luo tehtävä webhook-paluukutsulla
curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
-H "Authorization: Bearer $SEEVIO_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedance-2-5-flash",
"input": {
"prompt": "A cat surfing at sunset, cinematic lighting",
"duration": 5,
"resolution": "720p",
"seed": 42,
"generation_type": "text-to-video",
"aspect_ratio": "16:9",
"generate_audio": true
},
"callback_url": "https://example.com/webhooks/seevio"
}'Tehtävä valmis: onnistuneen kutsun hyötykuorma
Kun luonti onnistuu, takaisinkutsu sisältää arvon status=completed. Tunnista tehtävä id-kentän avulla ja hae videon URL-osoitteet kohdasta data.results. Lataa ja tallenna tulokset ennen kohdassa data.video_expires_at ilmoitettua ajankohtaa.
created_at on tapahtuman luontiaika ja task_created_at tehtävän luontiaika Unix-sekunteina. Esimerkit näyttävät suositellut kentät; vastaukset voivat sisältää lisäkenttiä.
{
"id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
"created_at": 1788652848,
"model": "seedance-2-5-flash",
"status": "completed",
"task_created_at": 1788652800,
"billing_status": "charged",
"credits": 50,
"failed_reason": null,
"data": {
"results": [
"https://cdn.seevio.ai/api/videos/example.mp4"
],
"video_expires_at": "2026-09-07T00:00:00Z",
"last_frame_url": null,
"processing_time": 48
}
}Tehtävä epäonnistui: epäonnistuneen kutsun hyötykuorma
Jos luonti epäonnistuu, takaisinkutsu sisältää arvon status=failed. Tunnista tehtävä id-kentän avulla. Kohdasta failed_reason näet virheen syyn ja kohdasta credits_refunded palautettujen krediittien määrän.
{
"id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
"created_at": 1788652848,
"model": "seedance-2-5-flash",
"status": "failed",
"task_created_at": 1788652800,
"billing_status": "refunded",
"credits": 50,
"failed_reason": "provider_failed",
"credits_refunded": 50
}Esimerkki vastaanottimesta
export async function POST(request: Request) {
const callbackData = await request.json();
if (callbackData.status === "completed") {
const videoUrls = callbackData.data.results;
// Save the video URLs and mark this task as completed in your application.
console.log(callbackData.id, videoUrls);
}
if (callbackData.status === "failed") {
const { failed_reason, credits_refunded } = callbackData;
// Record the failure reason and refunded credits for this task.
console.error(callbackData.id, failed_reason, credits_refunded);
}
return new Response(null, { status: 200 });
}Tässä Next.js-esimerkissä luetaan JSON-muotoinen takaisinkutsun runko ja käsitellään onnistuneet sekä epäonnistuneet tehtävät suoraan. Lisää sovellukseesi tiedon säilytys ja tehtävätunnusten (task-ID) duplikaattien poisto. Aseta hitaat työt jonoon ennen takaisinkutsun kuittaamista.
Medialähdevaatimukset ja -rajoitukset
- Kaikkien media- ja callback-osoitteiden on oltava julkisia HTTPS-osoitteita. Vältä localhost-osoitetta, yksityisiä IP-osoitteita ja tiedostoja, jotka vaativat evästeitä tai kirjautumista. Viitevideon/-äänen URL-osoitteiden on osoitettava suoraan luettavaan mediatiedostoon.
- Reference-to-video-tilassa toimita vähintään yksi viite, enintään 30 kuvaa, 10 videota, 10 äänitiedostoa ja yhteensä enintään 50 materiaalia. Videoiden ja äänitiedostojen kokonaiskesto saa olla enintään 30 sekuntia per mediatyyppi.
- text-to-video ohittaa kaikki mediaviitteet. image-to-video huomioi vain ensimmäisen/viimeisen kehyksen kuvat ja ohittaa video- sekä ääniviitteet. Käytä reference-to-video-tilaa, jos haluat yhdistää eri mediatyyppejä.
- Kunkin viitevideon ja -äänitiedoston on oltava kestoltaan 2–30 sekuntia. Käytä videon muokkausesimerkeissä vähintään 4 sekunnin pituisia lähdeklippejä.
Kuvan vaatimukset
- Kunkin kuvan koon on oltava alle 30 kt.
- Tuetut tiedostomuodot: jpeg, png, webp, bmp, tiff, gif.
- Kuvasuhde (leveys ÷ korkeus): 0,4–2,5 (raja-arvot mukaan lukien).
- Sekä leveyden että korkeuden on oltava 300–6 000 pikseliä (raja-arvot mukaan lukien).
Videon vaatimukset
- Tuetut tiedostomuodot: mp4, mov.
- Yksittäinen video saa olla enintään 100 kt.
- Kuvanopeus: 24–60 kuvaa sekunnissa (FPS, raja-arvot mukaan lukien).
- Kuvasuhde (leveys ÷ korkeus): 0,4–2,5 (raja-arvot mukaan lukien).
- Pikseleiden kokonaismäärä (leveys × korkeus): 407 696–8 295 044 (raja-arvot mukaan lukien). Esimerkiksi 614 × 664 = 407 696 ja 3 326 × 2 494 = 8 295 044. Nämä ovat esimerkkejä pikselimääristä, eivät kiinteitä leveys- tai korkeusvaatimuksia.
Äänen vaatimukset
- Tuetut tiedostomuodot: wav, mp3.
- Yksittäinen äänitiedosto saa olla enintään 15 kt.