Seedance 2.5

Funksjoner

Priser og kreditter

Videogenerering belastes i kreditter basert på den fakturerbare varigheten i sekunder. Uten videoinndata er den fakturerbare varigheten lik varigheten på den ferdige videoen. Med videoinndata inkluderes også varigheten på referansevideoen.

Tabellen nedenfor viser hvor mange kreditter som trekkes per sekund, ikke den totale kostnaden for en oppgave. Satsen avhenger av modell, utgangsoppløsning og om det brukes referansevideoer i referanse-til-video-modus. Se formlene og eksemplene under tabellen for å se hvordan totalkostnaden beregnes.

• Uten videoinndata: sekunder i ferdig video × pris uten video.
• Med videoinndata: (sekunder i ferdig video + målt varighet på referansevideo) × pris med video. Serveren måler den totale varigheten på referansevideoen og runder opp til nærmeste hele sekund før fakturering.
• Bruk av kun bilde- eller lydreferanser belastes med prisen uten video. Prisen med referansevideo gjelder kun i referanse-til-video-modus når det faktisk sendes med videoreferanser.

Kreditter reserveres ved innsending og trekkes når oppgaven er fullført. Oppgaver som mislykkes eller tidsavbrytes, refunderes automatisk. Statusen refund_failed betyr at refusjonen ikke kunne fullføres; sjekk API-loggene eller kontakt kundeservice.

Autentisering

Opprett en API-nøkkel i dashbordet. Den fullstendige nøkkelen vises bare én gang. Oppbevar den trygt på serveren din, og send den med som et Bearer-token i alle forespørsler.

https://api.seevio.ai

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Definer miljøvariabelen SEEVIO_API_KEY før du kjører disse eksemplene. Eksemplene i JavaScript kjøres på serveren din med Node.js, mens Python-eksemplene bruker requests-pakken.

Hurtigstart

Send inn denne minimale forespørselen, ta vare på returnert taskId, og bruk deretter eksempelet for statusspørring nedenfor. Verdien for kreditter i opprettelsesresponsen er det reserverte beløpet.

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
  }
}'

Eksempel på svar ved opprettelse av oppgave

Når forespørselen ovenfor er godkjent, returnerer API-et dette JSON-svaret. taskId er oppgaveidentifikatoren som brukes til påfølgende statusforespørsler; credits er antall kreditter som er reservert for denne oppgaven. Dette svaret bekrefter kun at oppgaven er opprettet, ikke at videoen er klar. Du må polle oppgavestatusen eller bruke en Webhook for å motta videoresultatene.

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

Opprett en oppgave

Send et JSON-objekt som inneholder model og input, samt en valgfri callback_url. Oppgi alltid den nøyaktige modell-ID-en som vises på denne siden; utelates model, velges seedance-2-0 automatisk.

Forespørselstekst (body)

Inndataparametere

Oppgi image_urls, video_urls og audio_urls som matriser med URL-strenger (string[]). Hver oppgitte URL må være offentlig tilgjengelig over HTTPS, inkludert mediefiler som ignoreres av den valgte modusen.

Bolske felt må være JSON true eller false, ikke strenger eller tall.

Opprettelsesrespons

HTTP 200 returnerer taskId (streng) og credits (tall). Dette bekrefter at oppgaven er opprettet, ikke at den er fullført. Beløpet nedenfor tilsvarer hurtigstart-eksempelet på 5 sekunder i 720p.

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

Genereringsmoduser og eksempler

Tekst til video

Generer ut fra en tekst-prompt. Medie-URL-er videresendes ikke i denne modusen.

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
  }
}'

Første ramme

Oppgi ett bilde som skal brukes som første ramme, og beskriv deretter bevegelsen i din prompt.

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"
  }
}'

Første og siste ramme

Oppgi to bilde-URL-er i rekkefølge: første ramme, og deretter siste ramme. Dette eksempelet ber også om den genererte videoens siste ramme.

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
  }
}'

Multimodalt referansemateriale

Kombiner referanser fra bilde, video og lyd. Tekst-prompt er fortsatt påkrevd. Referansevideo endrer formelen for fakturering.

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"
  }
}'

Lydreferanse

Bruk lyd som eneste referansetype, sammen med en påkrevd tekst-prompt som beskriver den ønskede videoen.

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"
    ]
  }
}'

Videoredigering

Beskriv endringen og legg ved kildevideoen. Sett duration=-1 og bruk adaptive skjermformat. Bruk en kildevideo på minst 4 sekunder for denne arbeidsflyten. Faktureringsreglene for duration=-1 vises ovenfor.

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"
  }
}'

Videoutvidelse

Beskriv hvordan kildevideoen skal fortsette. Bruk adaptive skjermformat og sett en normal varighet innenfor modellens tillatte område.

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"
  }
}'

Spør om en oppgave

Erstatt eksempel-ID-en med den taskId du fikk ved opprettelse. Statusspørringer returnerer kun oppgaver som tilhører brukeren av den gitte API-nøkkelen; utilgjengelige eller ukjente ID-er returnerer HTTP 404.

Start med å gjøre en spørring (poll) hvert 10.–20. sekund. Ved HTTP 429 bør du øke intervallet, og stoppe når statusen er completed eller failed. Vi anbefaler webhooks i produksjon. Hvert kodeeksempel nedenfor utfører én enkelt spørring.

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

Fullført oppgave: statussvar med videoresultater

Når statusforespørselen returnerer status=completed, er videogenereringen fullført. Hent video-URL-ene fra data.results og last dem ned før data.video_expires_at. billing_status=charged viser at de reserverte kredittene har blitt trukket.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "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
  }
}

Mislykket oppgave: statussvar med feil- og faktureringsinformasjon

Når statusforespørselen returnerer status=failed, ble ikke genereringen fullført. Se failed_reason for årsaken, og billing_status for refusjonsstatusen. I dette eksempelet betyr refunded at kredittene har blitt refundert. credits viser det opprinnelige reserverte beløpet, og svaret inneholder ikke data.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "failed",
  "billing_status": "refunded",
  "credits": 100,
  "failed_reason": "provider_failed"
}

Webhooks

Angi callback_url i opprettelsesforespørselen for å motta en JSON POST når oppgaven er fullført eller feiler. Returner en 2xx-respons innen 15 sekunder. Meldinger som ikke blir levert, prøves på nytt; håndter gjentatte leveringer idempotent basert på oppgave-ID.

Ditt endepunkt for tilbakesending må godta POST-forespørsler med en JSON-meldingskropp (Content-Type: application/json).

Opprett en oppgave med callback

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"
}'

Webhook-data skiller seg fra svarene på statusspørringer: de utelater billing_status og credits, og feildetaljer ligger i data.failed_reason og data.credits_refunded. Webhook-feltet created_at er tidspunktet for selve hendelsen i Unix-sekunder.

Oppgave fullført: payload for vellykket tilbakesending

Når genereringen lykkes, inneholder tilbakesendingen status=completed. Bruk id for å identifisere oppgaven og data.results for å hente video-URL-ene. Last ned og lagre resultatene før data.video_expires_at.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "completed",
  "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
  }
}

Oppgave mislyktes: payload for mislykket tilbakesending

Når genereringen mislykkes, inneholder tilbakesendingen status=failed. Bruk id for å identifisere oppgaven, data.failed_reason for årsaken til feilen, og data.credits_refunded for antall refunderte kreditter.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "failed",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 100
  }
}

Eksempel på mottaker (receiver)

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.data;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

Dette Next.js-eksempelet leser JSON-tilbakesendingskroppen og håndterer fullførte og mislykkede oppgaver direkte. Legg til datalagring og deduplisering av oppgave-ID-er i applikasjonen din, og legg tidkrevende oppgaver i kø før tilbakesendingen bekreftes.

Mediekrav og begrensninger

• Alle medie- og callback-URL-er må være offentlige HTTPS-URL-er. Unngå localhost, private IP-adresser og filer som krever informasjonskapsler (cookies) eller pålogging. URL-er for referansevideo og -lyd må peke direkte til lesbare mediefiler.
• I reference-to-video må du oppgi minst én referanse, med maksimalt 30 bilder, 10 videoer, 10 lydfiler og totalt 50 materialer til sammen. Total videovarighet og total lydvarighet kan ikke overstige 30 sekunder hver.
• text-to-video ignorerer alle mediereferanser. image-to-video videresender kun bildene for første/siste ramme og ignorerer video- og lydreferanser. Bruk reference-to-video for å kombinere ulike medier.
• Hver referansevideo og referanselydfil må være mellom 2 og 30 sekunder. For videoredigering bør du bruke kildeklipp på minst 4 sekunder.

Feilmeldinger

HTTP-feil returnerer et error-objekt med code og message. En oppgave som ble mottatt uten feil, kan fortsatt mislykkes senere; sjekk status på oppgaven eller håndter feil via callback.

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

Grenser for forespørsler (rate limits)

Opprett oppgaver: Hver API-nøkkel tillater som standard opptil 100 forespørsler i minuttet. Skreddersydde ratebegrensninger er foreløpig ikke tilgjengelig.

Hent oppgaver: Hver API-nøkkel tillater som standard opptil 120 forespørsler i minuttet. Forespørsler om opphenting og oppretting av oppgaver telles hver for seg.