Seedance 2.0
Seedance 2.0
DokumentationKom godt i gang
API-overblikTekst til videoBillede til video
API-reference

API-overblik

Forsta autentificering, indsendelse, statuskontrol og webhooks i Seedance 2.0 Open API.

Med Seedance 2.0 Open API kan du indsende asynkrone videogenereringsjobs fra dit eget produkt og hente resultatet, nar behandlingen er faerdig.

Base URL

https://www.seedance2.ink

Authentication

Alle Open API-requests bruger et Bearer-token, der oprettes i Seedance-dashboardet.

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

Integrationsflow

  1. Opret en API Key i Seedance-dashboardet.
  2. Indsend et job med POST /api/open/v1/video/generations.
  3. Gem den returnerede requestId.
  4. Poll GET /api/open/v1/video/generations/{requestId} indtil slutstatus.
  5. Brug eventuelt en webhook til at fa besked, nar jobbet er faerdigt.

Kerneendpoints

MethodEndpointDescription
GET/api/open/v1/modelsViser tilgaengelige modeller, varigheder, billedforhold, oplosninger og prisdata.
POST/api/open/v1/video/generationsOpretter et nyt videogenereringsjob.
GET/api/open/v1/video/generations/{requestId}Kontrollerer jobstatus og returnerer output-URL en, nar jobbet er faerdigt.
POST/api/open/v1/video/generations/{requestId}/cancelAnnullerer et job, der er i ko eller behandling.

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

Statusvaerdier

StatusDescription
queuedRequesten er accepteret og venter i ko.
processingGenereringen behandles lige nu.
succeededJobbet er gennemfort, og output.url er tilgaengelig.
failedJobbet mislykkedes. Tjek error.
cancelledJobbet blev annulleret for fuldforing.

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

Du kan angive webhookUrl pr. request eller konfigurere en standard callback-URL pa API Key-niveau.

  • Hvis begge findes, har requestens webhookUrl prioritet.
  • Hvis et Webhook Secret er konfigureret, sendes x-seedance-signature med.
  • Webhooks sendes kun, nar jobbet nar en slutstatus.
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
}

Fejlkoder

HTTP statusError codeDescription
400invalid_requestRequest-body matcher ikke det forventede schema.
401unauthorizedAPI Key mangler eller er ugyldig.
402insufficient_creditsDer er ikke nok credits til at oprette jobbet.
404not_foundJobbet findes ikke for den aktuelle API Key.
429rate_limitedMinutgraensen eller manedskvoten er overskredet.
500internal_errorDer opstod en uventet intern fejl.

Naeste skridt

  • Laes Tekst til video
  • Laes Billede til video

Kom godt i gang

Den hurtigste made at komme i gang med Seedance 2.0 pa.

Tekst til video

Generer videoer fra tekstprompts med Seedance 2.0 Open API.

Indholdsfortegnelse

Base URLAuthenticationIntegrationsflowKerneendpointsAvailable ModelsStatusvaerdierModels Endpoint ExampleWebhooksFejlkoderNaeste skridt