Chiavi API bearer
Invia `Authorization: Bearer sk_seedancee2_live_xxxxx` con ogni richiesta.
Basata sul modello sottostante Seedance 2.0, la nostra API unifica e incapsula le capacità dei provider a monte e le espone come API pubblica standardizzata.
Integra una sola volta `pro`, `fast` e `mini`, mentre manteniamo i cambiamenti dei provider a monte dietro lo stesso contratto pubblico.
Esegui la generazione video da prompt o immagini tramite un'unica superficie API, senza esporre ai clienti differenze specifiche dei provider a monte.
Invia una richiesta di generazione, controlla lo stato del job o ricevi un webhook quando il video è pronto con una risposta SeeDanceE2 pulita.
L'API pubblica nasconde i provider a monte. Gli sviluppatori integrano tre nomi di modello pubblici, un solo schema di autenticazione e un solo ciclo di vita delle attività asincrone.
Invia `Authorization: Bearer sk_seedancee2_live_xxxxx` con ogni richiesta.
Crea un'attività di generazione asincrona, interroga per ID o ricevi callback di completamento.
Le risposte espongono crediti riservati, addebitati e rimborsati per mantenere la fatturazione verificabile.
Per clip destinate ai clienti e lavori di produzione standard.
Per flussi di anteprima ed esperimenti ripetuti sui prompt.
Per bozze leggere e generazione con budget ridotto.
Crea una chiave API nel tuo workspace e inviala come token bearer: Authorization: Bearer sk_seedancee2_live_xxxxx in ogni richiesta.
La generazione è asincrona. Invii un'attività, ricevi un ID attività, poi interroghi l'endpoint di stato o registri un webhook per essere avvisato quando il video è pronto.
Solo i livelli pubblici pro, fast e mini. La piattaforma instrada ogni richiesta verso il miglior modello video sottostante disponibile, così la tua integrazione non si rompe quando cambiano i provider.
L'uso dell'API attinge allo stesso saldo crediti dell'app web. Le risposte espongono credits_reserved, credits_charged e credits_refunded così ogni chiamata resta verificabile.
Sì. Invia un prompt testuale per il text-to-video, oppure allega l'URL di un'immagine di riferimento per l'image-to-video; la composizione dell'immagine viene preservata e viene generato solo il movimento descritto.
SeeDanceE2 espone un'API pubblica stabile per la generazione video. Le integrazioni devono usare solo i nomi di modello pubblici pro, fast e mini; i dettagli dei provider a monte restano nascosti dietro il contratto SeeDanceE2.
https://api.SeeDanceE2.aiEsempio minimo con curl:
curl -X POST "https://api.SeeDanceE2.ai/v1/videos/generations" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "mini",
"input": {
"prompt": "A cinematic drone shot of waves breaking against black volcanic rocks",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
},
"metadata": {
"customer_job_id": "job_123"
}
}'Esempio minimo in JavaScript:
const response = await fetch("https://api.SeeDanceE2.ai/v1/videos/generations", {
method: "POST",
headers: {
Authorization: "Bearer sk_seedancee2_live_xxxxx",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "mini",
input: {
prompt: "A cinematic drone shot of waves breaking against black volcanic rocks",
duration: 5,
resolution: "720p",
aspect_ratio: "16:9",
},
metadata: {
customer_job_id: "job_123",
},
}),
});
const result = await response.json();
console.log(result);Esempio minimo in Python:
import requests
response = requests.post(
"https://api.SeeDanceE2.ai/v1/videos/generations",
headers={
"Authorization": "Bearer sk_seedancee2_live_xxxxx",
"Content-Type": "application/json",
},
json={
"model": "mini",
"input": {
"prompt": "A cinematic drone shot of waves breaking against black volcanic rocks",
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
},
"metadata": {
"customer_job_id": "job_123",
},
},
timeout=60,
)
print(response.json())Tutte le richieste usano l'autenticazione con token bearer.
Authorization: Bearer sk_seedancee2_live_xxxxx
Content-Type: application/jsonPuoi inviare la chiave anche tramite x-api-key, ma Authorization: Bearer ... è la modalità consigliata.
pro, fast e mini.Se hai già una chiave API SeeDanceE2 funzionante, cambiare modello richiede solo la modifica del campo model nella richiesta. Esempio:
{
"model": "mini"
}diventa:
{
"model": "fast"
}oppure:
{
"model": "pro"
}Questi sono i nomi di modello pubblici che la tua integrazione deve usare.
| Modello | Posizionamento | Durata | Risoluzione |
|---|---|---|---|
pro | Generazione di produzione in qualità standard | 4-15 s | 480p, 720p, 1080p |
fast | Iterazione rapida e flussi di anteprima | 4-15 s | 480p, 720p |
mini | Generazione a costi contenuti | 4-15 s | 480p, 720p |
Le nuove integrazioni devono usare pro, fast e mini.
Proporzioni supportate:
16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveI crediti dell'API pubblica seguono le stesse regole di addebito visibili nel prodotto SeeDanceE2.
Formula:
credits = duration_seconds * per_second_rate * number_of_outputsImmagini, video e audio di riferimento al momento non comportano supplementi aggiuntivi per il cliente. I valori di crediti riservati e addebitati nella risposta API sono la fonte di verità per ogni attività.
Tariffe al secondo attualmente allineate alle regole di fatturazione del prodotto SeeDanceE2:
| Modello | 480p | 720p | 1080p |
|---|---|---|---|
pro | 10 crediti/s | 20 crediti/s | 50 crediti/s |
fast | 8 crediti/s | 16 crediti/s | Non supportato |
mini | 5 crediti/s | 10 crediti/s | Non supportato |
Esempi:
| Scenario | Crediti |
|---|---|
mini, 5 s, 720p | 50 |
pro, 4 s, 480p | 40 |
fast, 10 s, 720p | 160 |
pro, 5 s, 720p, 2 immagini di riferimento | 100 |
Se un'attività non riesce ed è idonea al rimborso, il payload di stato restituito mostra i crediti rimborsati.
Stati dell'attività restituiti dall'API pubblica:
| Stato | Significato |
|---|---|
pending | Accettata e in attesa di avvio |
processing | In esecuzione |
completed | Completata con successo |
failed | Terminata senza un output utilizzabile |
POST /v1/videos/generationsCampi di primo livello della richiesta:
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
model | string | Sì | Nome del modello pubblico: pro, fast o mini |
input | object | Sì | Parametri di generazione |
callback_url | string | No | URL webhook pubblico per callback di completamento o errore |
metadata | object | No | Metadati definiti dal cliente, restituiti nelle risposte di polling e webhook |
Campi di input:
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
prompt | string | Sì | Prompt testuale |
generation_type | string | No | omni_reference o first_and_last_frames; predefinito omni_reference |
image_urls | string[] | No | URL delle immagini di riferimento |
video_url | string | No | URL di un singolo video di riferimento |
video_urls | string[] | No | URL dei video di riferimento. Non inviare insieme a video_url |
audio_urls | string[] | No | URL degli audio di riferimento |
start_image_url | string | No | Immagine del primo fotogramma per first_and_last_frames |
end_image_url | string | No | Immagine dell'ultimo fotogramma per first_and_last_frames |
duration | integer | No | Durata dell'output in secondi, 4-15; predefinito 5 |
resolution | string | No | 480p, 720p o 1080p; le risoluzioni disponibili dipendono dal modello scelto |
aspect_ratio | string | No | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 o adaptive |
generate_audio | boolean | No | Genera audio sincronizzato quando supportato |
watermark | boolean | No | Richiede un output con filigrana |
seed | integer | No | Seed deterministico |
return_last_frame | boolean | No | Include l'immagine dell'ultimo fotogramma nel payload di output |
Esempio completo:
curl -X POST "https://api.SeeDanceE2.ai/v1/videos/generations" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"model": "pro",
"callback_url": "https://example.com/webhooks/seedancee2",
"input": {
"prompt": "A cinematic tracking shot through a rain-soaked neon market at night",
"image_urls": [
"https://example-cdn.com/reference-1.png",
"https://example-cdn.com/reference-2.png"
],
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"return_last_frame": true
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}'Risposta di successo:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "pending",
"model": "pro",
"credits_reserved": 100,
"created_at": "2026-06-29T10:00:00.000Z"
}
}GET /v1/videos/generations/{id}Esempio di polling:
const response = await fetch(
"https://api.SeeDanceE2.ai/v1/videos/generations/vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
{
headers: {
Authorization: "Bearer sk_seedancee2_live_xxxxx",
},
}
);
const result = await response.json();
console.log(result);Risposta durante l'elaborazione:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "processing",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Risposta al completamento:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "completed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"completed_at": "2026-06-29T10:06:20.000Z",
"credits_charged": 100,
"output": {
"video_url": "https://media.SeeDanceE2.ai/videos/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.mp4",
"thumbnail_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg",
"last_frame_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Risposta di errore:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "failed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"credits_charged": 0,
"credits_refunded": 100,
"error": {
"code": "generation_failed",
"message": "The video could not be generated. Please try again with a different prompt.",
"type": "generation_error"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}GET /v1/videos/generationsParametri di query supportati:
| Campo | Tipo | Descrizione |
|---|---|---|
status | string | Filtra per pending, processing, completed o failed |
limit | integer | Numero massimo di risultati. Predefinito 20, massimo 100 |
Esempio:
curl "https://api.SeeDanceE2.ai/v1/videos/generations?status=completed&limit=10" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx"GET /v1/modelsEsempio di risposta:
{
"data": [
{
"id": "pro",
"status": "active",
"resolutions": ["480p", "720p", "1080p"],
"duration": {
"min": 4,
"max": 15
}
}
]
}GET /v1/usageParametri di query supportati:
| Campo | Tipo | Descrizione |
|---|---|---|
start | string | Filtro facoltativo sulla data e ora di inizio in formato ISO 8601 |
end | string | Filtro facoltativo sulla data e ora di fine in formato ISO 8601 |
limit | integer | Numero massimo di righe della cronologia giornaliera. Predefinito 30, massimo 365 |
Esempio:
curl "https://api.SeeDanceE2.ai/v1/usage?start=2026-07-01T00:00:00.000Z&end=2026-07-31T23:59:59.999Z&limit=7" \
-H "Authorization: Bearer sk_seedancee2_live_xxxxx"Esempio di risposta:
{
"data": {
"range": {
"start": "2026-07-01T00:00:00.000Z",
"end": "2026-07-31T23:59:59.999Z"
},
"summary": {
"total_jobs": 12,
"pending_jobs": 1,
"processing_jobs": 2,
"completed_jobs": 8,
"failed_jobs": 1,
"credits_charged": 280,
"credits_refunded": 40,
"net_credits": 240
},
"by_model": [
{
"model": "mini",
"total_jobs": 7,
"pending_jobs": 0,
"processing_jobs": 1,
"completed_jobs": 5,
"failed_jobs": 1,
"credits_charged": 120,
"credits_refunded": 20,
"net_credits": 100
},
{
"model": "pro",
"total_jobs": 5,
"pending_jobs": 1,
"processing_jobs": 1,
"completed_jobs": 3,
"failed_jobs": 0,
"credits_charged": 160,
"credits_refunded": 20,
"net_credits": 140
}
],
"timeline": [
{
"date": "2026-07-01",
"total_jobs": 4,
"pending_jobs": 0,
"processing_jobs": 1,
"completed_jobs": 3,
"failed_jobs": 0,
"credits_charged": 100,
"credits_refunded": 0,
"net_credits": 100
}
]
}
}Se viene fornito callback_url, SeeDanceE2 invia una richiesta POST quando l'attività raggiunge completed o failed.
Header consigliati da verificare:
X-Seedancee2-Event: video.generation.completed
X-Seedancee2-Signature: t=1770000000,v1=...Se la firma dei webhook è attiva sul tuo account, il corpo viene firmato così:
payload_to_sign = "{timestamp}.{raw_json_body}"
signature = hex(hmac_sha256(webhook_secret, payload_to_sign))Payload del webhook al completamento:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "completed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"completed_at": "2026-06-29T10:06:20.000Z",
"credits_charged": 100,
"output": {
"video_url": "https://media.SeeDanceE2.ai/videos/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.mp4",
"thumbnail_url": "https://media.SeeDanceE2.ai/video-posters/2026/06/29/vid_01jz8b7q4x8k2p9w3m5c6n7r8s.jpg"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Payload del webhook in caso di errore:
{
"data": {
"id": "vid_01jz8b7q4x8k2p9w3m5c6n7r8s",
"status": "failed",
"model": "pro",
"created_at": "2026-06-29T10:00:00.000Z",
"credits_charged": 0,
"credits_refunded": 100,
"error": {
"code": "generation_failed",
"message": "The video could not be generated. Please try again with a different prompt.",
"type": "generation_error"
},
"metadata": {
"customer_job_id": "job_123",
"campaign": "launch_week"
}
}
}Immagini:
| Requisito | Valore |
|---|---|
| Formati | JPEG, PNG, WebP, BMP, TIFF, GIF |
| Quantità | Fino a 9 immagini di riferimento |
first_and_last_frames | Esattamente 2 immagini |
Video:
| Requisito | Valore |
|---|---|
video_url | 1 |
video_urls | Fino a 3 |
Audio:
| Requisito | Valore |
|---|---|
audio_urls | Fino a 3 |
Formato dell'errore:
{
"error": {
"code": "insufficient_credits",
"message": "Your credit balance is too low. Please top up.",
"type": "billing_error"
}
}Codici di errore pubblici attuali:
| Stato HTTP | Codice | Tipo | Descrizione |
|---|---|---|---|
| 400 | invalid_request | invalid_request_error | Parametri mancanti o non validi |
| 401 | invalid_api_key | authentication_error | Chiave API assente, non valida o disattivata |
| 402 | insufficient_credits | billing_error | Saldo crediti insufficiente |
| 404 | model_not_found | invalid_request_error | Il modello non esiste o è inattivo |
| 404 | task_not_found | invalid_request_error | L'ID attività non esiste |
| 500 | internal_error | api_error | Errore imprevisto del server |
pro, fast e mini.metadata per collegare callback e risultati di polling ai record aziendali interni.