Seedance API

Med API-et kan du sende inn videogenereringsoppgaver for Seedance 2.5 og Seedance 2.0 programmatisk. Seedance 2.5 er den anbefalte modellen og støtter tekst-til-video, bilde-til-video basert på første ramme eller første og siste ramme, samt multimodale referanser til video. Genereringen skjer asynkront: du oppretter en oppgave, mottar en oppgave-ID umiddelbart, og henter deretter den ferdige videoen ved å polle oppgave-endepunktet eller via en webhook.

Opprett en API-nøkkel i dashbordet og send den med som en Bearer-token i alle forespørsler. Den fullstendige nøkkelen vises kun én gang når den opprettes.

Authorization: Bearer sk_live_xxxxxxxx

Send først inn en oppgave. Når oppgaven er godkjent, velger du hvordan du vil motta resultatet: enten ved å polle oppgave-endepunktet, eller ved å motta det endelige resultatet via en webhook.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cat surfing on a neon wave, cinematic lighting",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false
    }
  }'

curl https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer sk_live_xxx"

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrl = callbackData.data.results[0];
    // Save the video URL or update your own task record here.
  }

  if (callbackData.status === "failed") {
    const errorMessage = callbackData.data.failed_reason;
    // Mark your own task record as failed here.
  }

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

Opprett en videooppgave med POST /v1/videos/generations. Forespørselens body må inneholde model på øverste nivå, en valgfri callback_url og et input-objekt med prompt og genereringsinnstillinger.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cat surfing on a neon wave, cinematic lighting",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false
    }
  }'

generation_type styrer hvilke medietyper som godtas og hvordan modellen tolker dem.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cinematic drone shot over a futuristic coastal city at sunrise",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "1080p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false
    }
  }'

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "input": {
      "prompt": "the subject turns toward camera, soft studio motion",
      "generation_type": "image-to-video",
      "image_urls": ["https://your.cdn.com/first-frame.jpg"],
      "duration": 5,
      "resolution": "720p"
    }
  }'

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "input": {
      "prompt": "use the product from image 1 and the camera motion from the reference video",
      "generation_type": "reference-to-video",
      "image_urls": ["https://your.cdn.com/product.jpg"],
      "video_urls": ["https://your.cdn.com/camera-motion.mp4"],
      "audio_urls": [],
      "duration": 8,
      "resolution": "720p"
    }
  }'

Parameternavn, enum-verdier, endepunkter og eksempler er en del av API-betingelsene. Beskrivelsene nedenfor forklarer hvordan de ulike feltene fungerer.

Dette er suksessresponsen fra POST /v1/videos/generations. Den bekrefter at oppgaven er mottatt og at kreditter er reservert. Bruk den returnerte taskId for å polle GET /v1/tasks/:id, eller for å koble oppgaven til en callback ved fullføring eller feil.

{
  "taskId": "3f2aK9mR...",
  "credits": 100
}

Bruk GET /v1/tasks/:id for å hente gjeldende oppgavestatus. Ikke poll oftere enn hvert 10. sekund. Vi anbefaler å bruke webhooks i produksjonssystemer.

curl https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer sk_live_xxx"

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-5",
  "billing_status": "charged",
  "credits": 100,
  "failed_reason": null,
  "data": {
    "results": ["https://cdn.seevio.ai/.../x.mp4"],
    "video_expires_at": "2026-06-13T10:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

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

Hvis callback_url er oppgitt, kaller Seedance endepunktet ditt når oppgaven er fullført eller har feilet, og sender JSON-data med det endelige resultatet. Hvis endepunktet ditt returnerer en statuskode som ikke er 2xx, eller ikke svarer innen 15 sekunder, prøver vi å sende dataene på nytt opptil 5 ganger. Forøkene bruker samme task id, så du kan fjerne duplikater basert på denne. Returner en 200-respons så snart du har lagret callback-dataene trygt.

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-5",
  "data": {
    "results": ["https://cdn.seevio.ai/.../x.mp4"],
    "video_expires_at": "2026-06-13T10:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

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

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrl = callbackData.data.results[0];
    // Save the video URL or update your own task record here.
  }

  if (callbackData.status === "failed") {
    const errorMessage = callbackData.data.failed_reason;
    // Mark your own task record as failed here.
  }

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

POST /v1/videos/generations og GET /v1/tasks/:id returnerer dette feilformatet dersom selve API-forespørselen feiler – for eksempel ved ugyldige parametere, ugyldig API-nøkkel, utilstrekkelig kreditt, rate-begrensning eller hvis oppgaven ikke finnes. Enkelte feilmeldinger inneholder ekstra felt som required, available eller retry_after avhengig av situasjonen.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this task.",
    "required": 100,
    "available": 12
  }
}

Hastighetsbegrensninger (rate limits) gjelder per API-nøkkel med et glidende tidsvindu. Standardgrensen for videogenerering er 100 forespørsler i minuttet, mens statusforespørsler har romsligere grenser. HTTP 429-responser inneholder en Retry-After-header.

API-et bruker prinsippet reserver ved innsending, belast ved suksess og refunder ved feil. Brukssidene i dashbordet viser historikk over API-kreditter, oppgavelogger og tidsbasert bruksstatistikk.