Panoramica API

Capisci autenticazione, invio delle richieste, controllo dello stato e webhook della Seedance 2.0 Open API.

La Seedance 2.0 Open API ti consente di inviare task asincroni di generazione video dal tuo prodotto e recuperare il risultato quando l elaborazione termina.

Base URL

https://www.seedance2.ink

Authentication

Tutte le richieste Open API usano un token Bearer creato nella dashboard Seedance.

Authorization: Bearer sd2_live_your_api_key

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

Flusso di integrazione

Crea una API Key nella dashboard Seedance.
Invia un task con POST /api/open/v1/video/generations.
Salva il requestId restituito.
Interroga GET /api/open/v1/video/generations/{requestId} fino allo stato finale.
Se vuoi, usa un webhook per ricevere la notifica di completamento.

Endpoint principali

Method	Endpoint	Description
`GET`	`/api/open/v1/models`	Restituisce modelli disponibili, durate, aspect ratio, risoluzioni e informazioni di prezzo.
`POST`	`/api/open/v1/video/generations`	Crea un nuovo task di generazione video.
`GET`	`/api/open/v1/video/generations/{requestId}`	Controlla lo stato del task e restituisce l URL finale quando e pronto.
`POST`	`/api/open/v1/video/generations/{requestId}/cancel`	Annulla un task in coda o in elaborazione.

Available Models

Model	Best for	Supported durations	Resolutions
`seedance-2.0`	Highest quality, multimodal generation	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-2.0-fast`	Faster turnaround	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-1.5-pro`	Lower-cost fallback workloads	`5` or `10` seconds	`480p`, `720p`, `1080p`

Supported aspect ratios:

16:9
9:16
1:1

Stati

Status	Description
`queued`	La richiesta e stata accettata ed e in coda.
`processing`	La generazione e in corso.
`succeeded`	Il task e completato con successo e `output.url` e disponibile.
`failed`	Il task e fallito. Controlla `error`.
`cancelled`	Il task e stato annullato prima del completamento.

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

Webhook

Puoi impostare webhookUrl per singola richiesta oppure configurare un URL di callback predefinito sulla API Key.

Se sono presenti entrambi, ha priorita il webhookUrl della richiesta.
Se e configurato un Webhook Secret, la richiesta include x-seedance-signature.
I webhook vengono inviati solo quando il task raggiunge uno stato finale.

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
}

Codici di errore

HTTP status	Error code	Description
`400`	`invalid_request`	Il body della richiesta non corrisponde allo schema previsto.
`401`	`unauthorized`	La API Key manca o non e valida.
`402`	`insufficient_credits`	I crediti non sono sufficienti per creare il task.
`404`	`not_found`	Il task non esiste per la API Key corrente.
`429`	`rate_limited`	Hai superato il limite al minuto o la quota mensile.
`500`	`internal_error`	Si e verificato un errore interno imprevisto.

Passi successivi

Leggere Testo in video
Leggere Immagine in video

La Seedance 2.0 Open API ti consente di inviare task asincroni di generazione video dal tuo prodotto e recuperare il risultato quando l elaborazione termina.

Base URL

https://www.seedance2.ink

Authentication

Tutte le richieste Open API usano un token Bearer creato nella dashboard Seedance.

Authorization: Bearer sd2_live_your_api_key

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

Flusso di integrazione

Crea una API Key nella dashboard Seedance.
Invia un task con POST /api/open/v1/video/generations.
Salva il requestId restituito.
Interroga GET /api/open/v1/video/generations/{requestId} fino allo stato finale.
Se vuoi, usa un webhook per ricevere la notifica di completamento.

Endpoint principali

Method	Endpoint	Description
`GET`	`/api/open/v1/models`	Restituisce modelli disponibili, durate, aspect ratio, risoluzioni e informazioni di prezzo.
`POST`	`/api/open/v1/video/generations`	Crea un nuovo task di generazione video.
`GET`	`/api/open/v1/video/generations/{requestId}`	Controlla lo stato del task e restituisce l URL finale quando e pronto.
`POST`	`/api/open/v1/video/generations/{requestId}/cancel`	Annulla un task in coda o in elaborazione.

Available Models

Model	Best for	Supported durations	Resolutions
`seedance-2.0`	Highest quality, multimodal generation	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-2.0-fast`	Faster turnaround	`4`-`15` seconds	`480p`, `720p`, `1080p`
`seedance-1.5-pro`	Lower-cost fallback workloads	`5` or `10` seconds	`480p`, `720p`, `1080p`

Supported aspect ratios:

16:9
9:16
1:1

Stati

Status	Description
`queued`	La richiesta e stata accettata ed e in coda.
`processing`	La generazione e in corso.
`succeeded`	Il task e completato con successo e `output.url` e disponibile.
`failed`	Il task e fallito. Controlla `error`.
`cancelled`	Il task e stato annullato prima del completamento.

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

Webhook

Puoi impostare webhookUrl per singola richiesta oppure configurare un URL di callback predefinito sulla API Key.

Se sono presenti entrambi, ha priorita il webhookUrl della richiesta.
Se e configurato un Webhook Secret, la richiesta include x-seedance-signature.
I webhook vengono inviati solo quando il task raggiunge uno stato finale.

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
}

Codici di errore

HTTP status	Error code	Description
`400`	`invalid_request`	Il body della richiesta non corrisponde allo schema previsto.
`401`	`unauthorized`	La API Key manca o non e valida.
`402`	`insufficient_credits`	I crediti non sono sufficienti per creare il task.
`404`	`not_found`	Il task non esiste per la API Key corrente.
`429`	`rate_limited`	Hai superato il limite al minuto o la quota mensile.
`500`	`internal_error`	Si e verificato un errore interno imprevisto.

Passi successivi

Leggere Testo in video
Leggere Immagine in video

Base URL

Authentication

Flusso di integrazione

Endpoint principali

Available Models

Stati

Models Endpoint Example

Webhook

Codici di errore

Passi successivi

Indice

Panoramica API

Base URL

Authentication

Flusso di integrazione

Endpoint principali

Available Models

Stati

Models Endpoint Example

Webhook

Codici di errore

Passi successivi

Indice