Seedance 2.0
Seedance 2.0
DokumentationKom igang
API-oversiktText till videoBild till video
API-referens

API-oversikt

Forsta autentisering, inlamning, statuskontroll och webhookar i Seedance 2.0 Open API.

Med Seedance 2.0 Open API kan du skicka in asynkrona videogenereringsjobb fran din egen produkt och hamta resultatet nar bearbetningen ar klar.

Base URL

https://www.seedance2.ink

Authentication

Alla Open API-anrop anvander en Bearer-token som skapas i Seedance-dashboarden.

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

Integrationsflode

  1. Skapa en API Key i Seedance-dashboarden.
  2. Skicka in ett jobb med POST /api/open/v1/video/generations.
  3. Spara det returnerade requestId.
  4. Poll GET /api/open/v1/video/generations/{requestId} tills slutstatus.
  5. Anvand valfritt en webhook for att fa besked nar jobbet ar klart.

Viktiga endpoints

MethodEndpointDescription
GET/api/open/v1/modelsListar tillgangliga modeller, langder, bildformat, upplosningar och prisdata.
POST/api/open/v1/video/generationsSkapar ett nytt videogenereringsjobb.
GET/api/open/v1/video/generations/{requestId}Kontrollerar jobbstatus och returnerar output-URL nar jobbet ar klart.
POST/api/open/v1/video/generations/{requestId}/cancelAvbryter ett jobb som star i ko eller bearbetas.

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

Statusvarden

StatusDescription
queuedBegaran accepterades och vantar i kon.
processingGenereringen bearbetas just nu.
succeededJobbet ar klart och output.url ar tillganglig.
failedJobbet misslyckades. Kontrollera error.
cancelledJobbet avbrots innan det blev klart.

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

Webhookar

Du kan ange webhookUrl per request eller konfigurera en standardiserad callback-URL pa API Key-niva.

  • Om bada finns prioriteras requestens webhookUrl.
  • Om ett Webhook Secret ar konfigurerat skickas x-seedance-signature med.
  • Webhookar skickas bara nar jobbet nar ett slutligt statuslage.
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
}

Felkoder

HTTP statusError codeDescription
400invalid_requestRequest-body matchar inte det forvantade schemat.
401unauthorizedAPI Key saknas eller ar ogiltig.
402insufficient_creditsDet finns inte tillrackligt med credits for att skapa jobbet.
404not_foundJobbet hittades inte for aktuell API Key.
429rate_limitedGransen per minut eller manadskvoten har overskridits.
500internal_errorEtt ovantat internt fel intraffade.

Nasta steg

  • Las Text till video
  • Las Bild till video

Kom igang

Det snabbaste sattet att komma igang med Seedance 2.0.

Text till video

Generera videor fran textprompter med Seedance 2.0 Open API.

Innehållsförteckning

Base URLAuthenticationIntegrationsflodeViktiga endpointsAvailable ModelsStatusvardenModels Endpoint ExampleWebhookarFelkoderNasta steg