Seedance 2.0
Seedance 2.0
DocumentatieAan de slag
API-overzichtTekst naar videoAfbeelding naar video
API-referentie

API-overzicht

Begrijp authenticatie, jobindiening, statuscontrole en webhooks van de Seedance 2.0 Open API.

Met de Seedance 2.0 Open API kun je asynchrone videogeneratietaken vanuit je eigen product indienen en het resultaat ophalen zodra de verwerking klaar is.

Base URL

https://www.seedance2.ink

Authentication

Alle Open API-verzoeken gebruiken een Bearer-token dat in het Seedance-dashboard is aangemaakt.

Authorization: Bearer sd2_live_your_api_key
{
  "success": false,
  "error": {
    "code": "unauthorized",
    "message": "Invalid API key"
  }
}

Integratiestroom

  1. Maak een API Key aan in het Seedance-dashboard.
  2. Dien een taak in met POST /api/open/v1/video/generations.
  3. Bewaar de geretourneerde requestId.
  4. Poll GET /api/open/v1/video/generations/{requestId} tot de taak klaar is.
  5. Gebruik optioneel een webhook voor voltooiingsmeldingen.

Belangrijkste endpoints

MethodEndpointDescription
GET/api/open/v1/modelsGeeft beschikbare modellen, duur, beeldverhoudingen, resoluties en prijsinformatie terug.
POST/api/open/v1/video/generationsMaakt een nieuwe videogeneratietaak aan.
GET/api/open/v1/video/generations/{requestId}Controleert de taakstatus en geeft na voltooiing de output-URL terug.
POST/api/open/v1/video/generations/{requestId}/cancelAnnuleert een taak die in de wachtrij staat of nog verwerkt wordt.

Available Models

ModelBest forSupported durationsResolutions
seedance-2.0Highest quality, multimodal generation4-15 seconds480p, 720p, 1080p
seedance-2.0-fastFaster turnaround4-15 seconds480p, 720p, 1080p
seedance-1.5-proLower-cost fallback workloads5 or 10 seconds480p, 720p, 1080p

Supported aspect ratios:

  • 16:9
  • 9:16
  • 1:1

Statuswaarden

StatusDescription
queuedHet verzoek is geaccepteerd en wacht in de queue.
processingDe generatie wordt momenteel verwerkt.
succeededDe taak is succesvol voltooid en output.url is beschikbaar.
failedDe taak is mislukt. Controleer error.
cancelledDe taak is voor voltooiing geannuleerd.

Models Endpoint Example

curl https://www.seedance2.ink/api/open/v1/models
{
  "success": true,
  "data": [
    {
      "id": "seedance-2.0",
      "type": "video_generation",
      "mode": "image_to_video",
      "durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
      "aspectRatios": ["16:9", "9:16", "1:1"],
      "resolutions": ["480p", "720p", "1080p"],
      "usdPerSecond": {
        "480p": 0.05,
        "720p": 0.1,
        "1080p": 0.2
      }
    }
  ]
}

Webhooks

Je kunt webhookUrl per request instellen of een standaard callback-URL op API Key-niveau configureren.

  • Als beide aanwezig zijn, heeft de request-specifieke webhookUrl voorrang.
  • Als een Webhook Secret is ingesteld, wordt x-seedance-signature meegestuurd.
  • Webhooks worden alleen verzonden wanneer de taak een eindstatus bereikt.
x-seedance-signature: <hex_sha256_hmac>
{
  "success": true,
  "requestId": "req_1234567890",
  "status": "succeeded",
  "output": {
    "type": "video",
    "url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
  },
  "error": null
}

Foutcodes

HTTP statusError codeDescription
400invalid_requestDe request-body komt niet overeen met het verwachte schema.
401unauthorizedDe API Key ontbreekt of is ongeldig.
402insufficient_creditsEr zijn niet genoeg credits om de taak aan te maken.
404not_foundDe taak bestaat niet voor de huidige API Key.
429rate_limitedDe limiet per minuut of maandquotum is overschreden.
500internal_errorEr is een onverwachte interne fout opgetreden.

Volgende stappen

  • Lees Tekst naar video
  • Lees Afbeelding naar video

Aan de slag

De snelste manier om productief te worden met Seedance 2.0.

Tekst naar video

Genereer video s uit tekstprompts met de Seedance 2.0 Open API.

Inhoudsopgave

Base URLAuthenticationIntegratiestroomBelangrijkste endpointsAvailable ModelsStatuswaardenModels Endpoint ExampleWebhooksFoutcodesVolgende stappen