Seedance 2.5

Ominaisuudet

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.

• 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ä.

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.

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ä.

https://api.seevio.ai

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Aseta 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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "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": 100
}

Luo tehtävä

Lähetä JSON-objekti, joka sisältää mallin (model) ja syötteen (input) sekä valinnaisen callback_url-osoitteen. Määritä aina tällä sivulla näkyvä mallitunnus; jos mallia ei määritetä, käyttöön otetaan seedance-2-0.

Pyyntörunko

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.

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": 100
}

Luonnos → 1080p-valmisversio

Seedance 2.5 tukee kaksivaiheista työnkulkua: luo ensin 480p-luonnos (Draft) tarkistaaksesi visuaalisen ilmeen ja liikkeen, ja käytä sitä sitten pohjana tarkemman 1080p-valmisversion luomiseen. Molemmat vaiheet käyttävät POST /v1/videos/generations -päätepistettä ja luovat erilliset, laskutettavat tehtävät.

Luonnostila voi vähentää kokeilukustannuksia. Sen sijaan, että loisit jokaisen kokeilun suoraan 1080p-tarkkuudella, voit luoda useita edullisempia 480p-luonnoksia, valita niistä parhaan ja luoda vasta siitä korkealaatuisen 1080p-valmisversion. Näin voit kokeilla eri vaihtoehtoja edullisesti ennen lopullisen version tilaamista korkealla resoluutiolla.

1. Luo 480p-luonnos (Draft)

Aseta input.draft=true ja anna tavalliseen tapaan tekstiprompti, viitteet ja generointiasetukset. Luonnostilassa resoluution oletusarvona on 480p; muut tarkkuudet hylätään. Voit ottaa käyttöön return_last_frame-asetuksen luonnokselle alla näytetyllä tavalla.

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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "draft": true,
    "duration": 5,
    "resolution": "480p",
    "return_last_frame": true
  }
}'

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 50
}

2. Odota luonnoksen valmistumista

Tallenna luontivastauksen taskId ja pollaa GET /v1/tasks/TASK_ID -päätepistettä, kunnes tilaksi vaihtuu completed. Kyselyn vastauksessa näkyy is_draft=true; voit esikatsella videon kentästä data.results. Pyydetty viimeinen kehys on saatavilla kentässä data.last_frame_url, jos se on käytettävissä.

Voit myös vastaanottaa webhook-ilmoituksen, kun luonnos valmistuu. Aseta callback_url luonnoksen luontipyynnön päätasolle. Kun luonnos valmistuu, kyseiseen URL-osoitteeseen lähetetään ilmoitus, jolloin sovelluksesi voi tallentaa tuloksen, päivittää tehtävän tilan tai käynnistää jatkokäsittelyn. Katso takaisinkutsun tietomuoto tämän sivun Webhook-osiosta.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "is_draft": true,
  "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": "https://cdn.seevio.ai/api/images/draft-last-frame.jpg",
    "processing_time": 48
  }
}

3. Luo 1080p-valmisversio

Korvaa tämän esimerkin draft_task_id valmiin luonnoksesi taskId-tunnisteella. Valmisversio perii luonnoksen sisällön ja keston. Resoluution oletusarvona on 1080p, eikä muita resoluutioita hyväksytä. output_format-, watermark- ja return_last_frame-asetukset voidaan määrittää itsenäisesti jokaiselle valmisversiolle; callback_url asetetaan pyynnön päätasolla.

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",
  "input": {
    "draft_task_id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
    "resolution": "1080p",
    "output_format": "mp4",
    "watermark": false,
    "return_last_frame": true
  }
}'

Vastaus sisältää uuden taskId-tunnisteen valmisversiota varten. Pollaa tätä uutta tunnusta tai odota sen webhook-ilmoitusta. Valmisversion kyselyvastauksessa is_draft on false ja draft_task_id vastaa alkuperäisen luonnoksen API-tehtävätunnusta. Alkuperäinen luonnos säilyy käytettävissä. Jokainen hyväksytty valmisversiopyyntö luo uuden, erikseen laskutettavan tehtävän.

{
  "taskId": "final_7mQx2pN8kR4vT9cL6bW3",
  "credits": 150
}

Luonnosten ja valmisversioiden laskutus

Luonnoksissa käytetään yllä mainittuja 480p-hintoja (mukaan lukien mahdollinen viitevideo). Valmisversioissa käytetään 1080p-perushintaa 30 krediittiä/sekunti; viitevideon syötteestä ei veloiteta uudelleen. Esimerkiksi 5 sekunnin luonnos ilman viitevideota maksaa 50 krediittiä ja 5 sekunnin valmisversio maksaa 150 krediittiä lisää.

Kun kesto on duration=-1, sekä luonnos että valmisversio varaavat krediittejä enintään 30 sekunnin mukaan. Luonnoksessa otetaan huomioon myös mahdollinen viitevideo. Kun tehtävä valmistuu, veloitus korjataan vastaamaan todellista videon kestoa, jos se voidaan määrittää, ja käyttämättömät varatut krediitit palautetaan. Valmisversio voi varata enintään 900 krediittiä.

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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "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",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "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",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "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",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "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",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Tehtävän kysely

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"

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",
  "is_draft": false,
  "draft_task_id": null,
  "status": "completed",
  "billing_status": "charged",
  "credits": 100,
  "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",
  "is_draft": false,
  "draft_task_id": null,
  "status": "failed",
  "billing_status": "refunded",
  "credits": 100,
  "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",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "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",
  "status": "completed",
  "task_created_at": 1788652800,
  "billing_status": "charged",
  "credits": 100,
  "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",
  "status": "failed",
  "task_created_at": 1788652800,
  "billing_status": "refunded",
  "credits": 100,
  "failed_reason": "provider_failed",
  "credits_refunded": 100
}

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ä.

Virheet

HTTP-virheiden yhteydessä palautetaan error-objekti, jossa on kentät code ja message. Onnistuneesti vastaanotettu tehtävä voi silti epäonnistua myöhemmin; tee tehtäväkysely tai käsittele epäonnistumisesta tuleva webhook-kutsu.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

Käyttörajat

Tehtävien luonti: kukin API-avain sallii oletusarvoisesti enintään 100 pyyntöä minuutissa. Mukautettuja pyyntörajoituksia ei ole tällä hetkellä saatavilla.

Tehtävien kyselyt: kukin API-avain sallii oletusarvoisesti enintään 120 pyyntöä minuutissa. Kyselypyynnöt ja tehtävien luontipyynnöt lasketaan erikseen.