Seedance 2.5

Mogelijkheden

Tarieven & credits

Voor het genereren van video's worden credits in rekening gebracht op basis van de factureerbare duur in seconden. Zonder video-invoer is de factureerbare duur gelijk aan de uitvoerduur. Met video-invoer is dit inclusief de duur van de referentievideo.

De onderstaande tabel toont het aantal credits dat per seconde in rekening wordt gebracht, niet de totale kosten van een taak. Het tarief is afhankelijk van het model, de uitvoerresolutie en of er referentievideo's worden meegeleverd in de referentie-naar-video-modus. Zie de formules en voorbeelden onder de tabel om de totale kosten te berekenen.

• Zonder video-input: output in seconden × tarief zonder video.
• Met video-input: (output in seconden + gemeten seconden referentievideo) × tarief met video. De server meet de totale duur van de referentievideo en rondt dit af naar boven op hele seconden voor de facturering.
• Bij gebruik van alleen afbeelding- of audioreferenties geldt het tarief zonder video. Het tarief voor referentievideo's is alleen van toepassing in de referentie-naar-video-modus wanneer er daadwerkelijk videoreferenties worden meegeleverd.

Credits worden gereserveerd bij indiening en afgeschreven bij succes. Mislukte of getimede taken gaan naar de terugbetalingsprocedure. Een facturatiestatus refund_failed betekent dat de terugbetaling niet is voltooid; controleer de API-logs of neem contact op met support.

Authenticatie

Maak een API-sleutel aan in het dashboard. De volledige sleutel wordt slechts eenmalig getoond. Bewaar deze op je server en stuur hem mee als Bearer-token bij elk request.

https://api.seevio.ai

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Stel de omgevingsvariabele SEEVIO_API_KEY in voordat je deze voorbeelden uitvoert. De JavaScript-voorbeelden draaien op je server met Node.js; de Python-voorbeelden gebruiken het requests-pakket.

Snelstart

Dien dit minimale request in, sla de geretourneerde taskId op en gebruik vervolgens het onderstaande voorbeeld om de taak op te vragen. De creditwaarde in de response bij aanmaken is het gereserveerde aantal.

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

Voorbeeldrespons taak aanmaken

Nadat het bovenstaande verzoek is geaccepteerd, retourneert de API deze JSON-respons. De taskId is de taak-id die wordt gebruikt voor volgende statusopvragingen; credits is het aantal credits dat voor deze taak is gereserveerd. Deze respons bevestigt dat de taak is aangemaakt, niet dat de video al klaar is. Je moet de status van de taak pollen of een webhook gebruiken om de videoresultaten te ontvangen.

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

Taak maken

Stuur een JSON-object met daarin model en input, plus een optionele callback_url. Geef altijd de model-ID op die op deze pagina wordt getoond; als je model weglaat, wordt automatisch seedance-2-0 geselecteerd.

Request body

Input-parameters

Geef image_urls, video_urls en audio_urls op als arrays van URL-strings (string[]). Elke opgegeven URL moet publiekelijk toegankelijk zijn via HTTPS, inclusief media die door de geselecteerde modus worden genegeerd.

Booleaanse velden moeten de JSON-waarde true of false hebben, geen strings of getallen.

Response bij aanmaken

HTTP 200 retourneert taskId (string) en credits (getal). Dit bevestigt het aanmaken van de taak, niet de voltooiing. De onderstaande waarde komt overeen met de snelstart van 5 seconden in 720p.

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

Generatiemodi & voorbeelden

Tekst naar video

Genereer op basis van een tekstprompt. Media-URL's worden in deze modus niet doorgestuurd.

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

Eerste frame

Geef één afbeelding op als het eerste frame en beschrijf de beweging in je 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"
  }
}'

Eerste en laatste frame

Geef twee afbeelding-URL's op in volgorde: eerst het beginframe, daarna het eindframe. Dit voorbeeld vraagt ook om het laatste frame van de gegenereerde video.

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

Multimodale referentie

Combineer afbeelding-, video- en audioreferenties. De prompt blijft vereist. Input van een referentievideo verandert de formule voor de facturering.

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

Audio-referentie

Gebruik audio als het enige referentietype, met een vereiste tekstprompt die de gewenste video beschrijft.

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

Videobewerking

Beschrijf de bewerking en lever de bronvideo aan. Stel duration=-1 in en gebruik de beeldverhouding adaptive. Gebruik voor deze workflow een bronclip van minimaal 4 seconden. De factureringsregel voor duration=-1 staat hierboven beschreven.

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

Video-extensie

Beschrijf hoe de bronvideo moet doorlopen. Gebruik de beeldverhouding adaptive en stel een normale outputduur in binnen het bereik van het model.

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

Taak opvragen

Vervang de voorbeeld-ID door de taskId die is geretourneerd bij het aanmaken. Queries retourneren alleen taken die eigendom zijn van de gebruiker van de API-sleutel; niet-toegankelijke of onbekende ID's retourneren HTTP 404.

Doe als uitgangspunt elke 10-20 seconden een poll, verminder de frequentie bij HTTP 429 en stop wanneer de status completed of failed is. Gebruik bij voorkeur webhooks voor productieomgevingen. Elk codevoorbeeld hieronder voert één query uit.

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

Voltooide taak: opvraagrespons met video-resultaten

Wanneer de opvraging status=completed retourneert, is het genereren van de video voltooid. Lees de video-URL's uit via data.results en download deze vóór data.video_expires_at. De status billing_status=charged geeft aan dat de gereserveerde credits in rekening zijn gebracht.

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

Mislukte taak: opvraagrespons met fout- en factureringsdetails

Wanneer de opvraging status=failed retourneert, is het genereren mislukt. Zie failed_reason voor de oorzaak en billing_status voor het resultaat van de terugbetaling. In dit voorbeeld betekent refunded dat de credits zijn teruggestort. Bij credits blijft het oorspronkelijk gereserveerde aantal staan en de respons bevat geen data.

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

Webhooks

Stel callback_url in het aanmaak-request in om een JSON POST te ontvangen wanneer de taak is voltooid of mislukt. Retourneer binnen 15 seconden een 2xx-response. Mislukte leveringen worden opnieuw geprobeerd; verwerk herhaalde leveringen idempotent op basis van de taak-ID.

Je callback-endpoint moet POST-verzoeken met een JSON-body accepteren (Content-Type: application/json).

Maak een taak met een 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-payloads verschillen van responses op taakqueries: ze bevatten geen billing_status en credits; details over fouten bevinden zich in data.failed_reason en data.credits_refunded. De created_at van de webhook is het tijdstip van de gebeurtenis in Unix-seconden.

Taak voltooid: payload voor succesvolle callback

Als het genereren is geslaagd, bevat de callback status=completed. Gebruik id om de taak te identificeren en data.results om de video-URL's op te halen. Download en bewaar de resultaten vóó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
  }
}

Taak mislukt: payload voor mislukte callback

Als het genereren mislukt, bevat de callback status=failed. Gebruik id om de taak te identificeren, data.failed_reason voor de reden van de fout en data.credits_refunded voor het aantal teruggestorte credits.

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

Voorbeeld van een ontvanger

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 });
}

Dit Next.js-voorbeeld leest de JSON-callback-body en verwerkt voltooide en mislukte taken direct. Voeg persistentie en taak-ID-deduplicatie toe voor je eigen applicatie; zet traag werk in de wachtrij voordat je de callback bevestigt.

Mediavereisten & beperkingen

• Alle media- en callback-URL's moeten openbare HTTPS-URL's zijn. Vermijd localhost, privé-IP-adressen en bestanden die cookies of een login vereisen. Referentievideo-/-audio-URL's moeten rechtstreeks naar leesbare media verwijzen.
• Geef bij reference-to-video ten minste één referentie op, met niet meer dan 30 afbeeldingen, 10 video's, 10 audiobestanden en 50 materialen in totaal. De totale videoduur en totale audioduur mogen elk maximaal 30 seconden bedragen.
• text-to-video negeert alle mediareferenties. image-to-video stuurt alleen de afbeeldingen voor het eerste/laatste frame door en negeert video- en audioreferenties. Gebruik reference-to-video om media te combineren.
• Elke referentievideo en elk audiobestand moet tussen de 2 en 30 seconden duren. Gebruik voor voorbeelden van videobewerking bronclips van minimaal 4 seconden.

Foutmeldingen

HTTP-fouten bevatten een error-object met een code en message. Een succesvol geaccepteerde taak kan later alsnog mislukken; vraag de taak op of handel de fout af via de callback.

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

Rate limits

Taken aanmaken: elke API-sleutel staat standaard maximaal 100 verzoeken per minuut toe. Aangepaste limieten zijn momenteel niet beschikbaar.

Taken opvragen: elke API-sleutel staat standaard maximaal 120 verzoeken per minuut toe. Zoekopdrachten en verzoeken voor het aanmaken van taken worden apart geteld.