Seedance 2.0
Seedance 2.0
DokumentasjonKom i gang
API-oversiktTekst til videoBilde til video
API-referanse

API-oversikt

Forsta autentisering, innsending, statuskontroll og webhooker i Seedance 2.0 Open API.

Med Seedance 2.0 Open API kan du sende inn asynkrone videogenereringsjobber fra ditt eget produkt og hente resultatet nar behandlingen er ferdig.

Base URL

https://www.seedance2.ink

Authentication

Alle Open API-foresporsler bruker et Bearer-token som opprettes i Seedance-dashbordet.

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

Integrasjonsflyt

  1. Opprett en API Key i Seedance-dashbordet.
  2. Send inn en jobb med POST /api/open/v1/video/generations.
  3. Lagre den returnerte requestId.
  4. Poll GET /api/open/v1/video/generations/{requestId} til sluttstatus.
  5. Bruk eventuelt en webhook for a fa varsel nar jobben er ferdig.

Kjerneendepunkter

MethodEndpointDescription
GET/api/open/v1/modelsLister tilgjengelige modeller, varigheter, sideforhold, opplosninger og prisdata.
POST/api/open/v1/video/generationsOppretter en ny videogenereringsjobb.
GET/api/open/v1/video/generations/{requestId}Sjekker jobbstatus og returnerer utdata-URL nar jobben er ferdig.
POST/api/open/v1/video/generations/{requestId}/cancelAvbryter en jobb som star i ko eller behandles.

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

Statusverdier

StatusDescription
queuedForesporselen er godkjent og venter i koen.
processingGenereringen behandles na.
succeededJobben er fullfort og output.url er tilgjengelig.
failedJobben mislyktes. Sjekk error.
cancelledJobben ble avbrutt for den ble fullfort.

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

Webhooker

Du kan sette webhookUrl per foresporsel eller konfigurere en standard callback-URL pa API Key-niva.

  • Hvis begge er satt, prioriteres webhookUrl fra foresporselen.
  • Hvis et Webhook Secret er konfigurert, sendes x-seedance-signature med.
  • Webhooker sendes bare nar jobben har naadd en sluttstatus.
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
}

Feilkoder

HTTP statusError codeDescription
400invalid_requestRequest-body matcher ikke forventet schema.
401unauthorizedAPI Key mangler eller er ugyldig.
402insufficient_creditsDet er ikke nok credits til a opprette jobben.
404not_foundJobben finnes ikke for gjeldende API Key.
429rate_limitedMinuttgrensen eller manedskvoten er overskredet.
500internal_errorDet oppstod en uventet intern feil.

Neste steg

  • Les Tekst til video
  • Les Bilde til video

Kom i gang

Den raskeste maten a komme i gang med Seedance 2.0 pa.

Tekst til video

Generer videoer fra tekstprompter med Seedance 2.0 Open API.

Innholdsfortegnelse

Base URLAuthenticationIntegrasjonsflytKjerneendepunkterAvailable ModelsStatusverdierModels Endpoint ExampleWebhookerFeilkoderNeste steg