Seedance API

Met de API kun je programmatisch Seedance 2.5 en Seedance 2.0 videogeneratietaken indienen. Seedance 2.5 is het aanbevolen model en ondersteunt tekst-naar-video, afbeelding-naar-video (met eerste frame of eerste en laatste frame) en multimodale referentie-naar-video. Generatie verloopt asynchroon: je maakt een taak aan, ontvangt direct een taak-ID en haalt vervolgens de voltooide video op via polling van het taak-endpoint of via een webhook.

Maak een API-sleutel aan in het dashboard en stuur deze als Bearer-token mee bij elk verzoek. De volledige sleutel wordt slechts eenmalig getoond bij het aanmaken.

Authorization: Bearer sk_live_xxxxxxxx

Dien eerst een taak in. Zodra de taak is geaccepteerd, kies je een methode voor het ontvangen van het resultaat: poll het taak-endpoint of ontvang de eindstatus via een 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 });
}

Maak een videogeneratietaak aan met POST /v1/videos/generations. De request-body bevat een model op het hoogste niveau, een optionele callback_url en een input-object met prompt- en generatie-instellingen.

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 bepaalt welke media-inputs worden geaccepteerd en hoe het model deze interpreteert.

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

Parameternamen, enum-waarden, endpoint-paden en voorbeelden maken deel uit van het API-contract. De onderstaande beschrijvingen leggen de werking van elk veld uit.

Dit is de succesvolle response van POST /v1/videos/generations. Dit betekent dat de taak is geaccepteerd en dat de credits zijn gereserveerd. Gebruik de geretourneerde taskId om de status te polleren via GET /v1/tasks/:id of om deze te koppelen aan een callback bij voltooiing of een fout.

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

Gebruik GET /v1/tasks/:id om de huidige status van een taak op te halen. Poll niet vaker dan één keer per 10 seconden. Voor productiesystemen wordt het gebruik van webhooks aanbevolen.

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

Wanneer callback_url is opgegeven, roept Seedance je endpoint aan zodra de taak is voltooid of mislukt, en stuurt JSON-data met de definitieve resultaten. Als je endpoint een non-2xx statuscode retourneert of niet binnen 15 seconden reageert, wordt de poging tot maximaal 5 keer herhaald. Bij herhalingen wordt hetzelfde task id gebruikt, dus ontdubbel op basis van dit ID. Stuur direct een 200-response zodra je de callback-data veilig hebt opgeslagen.

{
  "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 en GET /v1/tasks/:id retourneren deze foutstructuur wanneer de API-aanroep zelf mislukt, zoals bij ongeldige parameters, een ongeldige API-sleutel, onvoldoende credits, rate limiting of wanneer de taak niet is gevonden. Sommige foutmeldingen bevatten extra velden zoals required, available of retry_after, afhankelijk van de situatie.

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

Rate limits worden per API-sleutel toegepast op basis van een sliding window. Voor generaties geldt een standaardlimiet van 100 aanvragen per minuut; statusopvragingen zijn ruimer ingesteld. HTTP 429-responses bevatten een Retry-After-header.

De API werkt op basis van reservering bij indiening, afschrijving bij succes en terugstorting bij fouten. De verbruikspagina's in het dashboard tonen de geschiedenis van je API-credits, taaklogboeken en verbruiksstatistieken over tijd.