API Pubblica

Genera video e immagini dai tuoi strumenti

Crea una chiave, chiama l'API con autenticazione Bearer e verifica lo stato del task finché il risultato non è pronto. Funziona con Claude Code, Codex e qualsiasi client HTTP.

Gestisci chiavi

Avvio rapido

Passo 1

Crea una chiave

Genera una chiave API nella tua dashboard. Viene mostrata una sola volta, quindi conservala in un posto sicuro.

Passo 2

Chiama l'API

Invia una richiesta POST con la tua chiave Bearer e un header Idempotency-Key.

Passo 3

Verifica il risultato

Interroga l'endpoint dello stato dell'attività finché lo stato non è completato o fallito, poi leggi l'output.

Autenticazione

Ogni richiesta viene autenticata con una chiave API Bearer nell'header Authorization.

http

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
Idempotency-Key: a-unique-id-per-request

Seedance 2 Video

Testo, immagine o media in video.

Invia lavoro

POST

/api/v1/video/seedance2

Parametri

Parametro	Tipo	Obbligatorio	Predefinito	Valori consentiti
`mode` Generation mode.	`string`	Opzionale	`text-to-video`	`text-to-videoimage-to-videomedia-to-video`
`quality_tier` Quality tier.	`string`	Opzionale	`standard`	`ministandardpro`
`channel` Rendering channel.	`string`	Opzionale	`standard`	`standardrealwild`
`prompt` Text prompt.	`string`	Obbligatorio	`—`	`3–10000 chars`
`aspect_ratio` Aspect ratio.	`string`	Opzionale	`16:9`	`1:121:94:33:416:99:16adaptive`
`duration` Clip duration.	`string`	Opzionale	`5`	`4–15 (seconds)`
`resolution` Output resolution. 1080p-plus and 4k are available on pro only.	`string`	Opzionale	`720p`	`720p1080p1080p-plus4k`
`image_url` Start frame — required for image-to-video.	`string (URL)`	Opzionale	`—`	`public https URL, ≤ 30 MB`
`end_image_url` Optional end frame.	`string (URL)`	Opzionale	`—`	`public https URL, ≤ 30 MB`
`media_urls` Required for media-to-video. Images are limited to 30 MB; video URLs must support duration probing.	`string[] (URL)`	Opzionale	`—`	`≤ 12 public https image/video URLs`
`generate_audio` Generate an audio track.	`boolean`	Opzionale	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	Opzionale	`false`	`truefalse`
`seed` Optional deterministic seed.	`integer`	Opzionale	`—`	`-1 – 4294967295`

Seedance prompt guide

Seedance prompts work best as concrete director instructions. Describe the subject, action, scene, camera motion, visual style, and constraints, then map every reference asset to the right API parameter.

Use image_url for the opening frame, end_image_url for the closing frame, and media_urls for character, motion, style, source-video, or extension references.
Describe asset roles in natural language inside prompt. Do not send raw asset ids, asset:// URLs, or in-app-only labels such as @图片1.
For edits say “strictly edit the supplied source video”; for extensions say “continue from the supplied previous clip.”
For complex scenes, use ordered shots plus a style and constraint package: stable faces, natural motion, no deformation, no watermark, no logo, and no subtitles unless intended.

Richiesta

bash

curl -X POST https://www.seedance2ai.io/api/v1/video/seedance2 \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-video-001" \
  -d '{
    "mode": "text-to-video",
    "quality_tier": "standard",
    "prompt": "A cinematic shot of a glass train crossing a snowy mountain bridge",
    "aspect_ratio": "16:9",
    "duration": "5",
    "resolution": "720p"
  }'

Risposta202

json

{
  "id": "sd2_xxxxx",
  "status": "processing",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "credits_used": 30
}

I valori credits_used mostrati in questi esempi sono illustrativi. Il consumo effettivo viene calcolato all’invio e restituito dall’API.

Controlla lo stato dell'attività

GET

/api/v1/tasks/{id}

Richiesta

bash

curl https://www.seedance2ai.io/api/v1/tasks/sd2_xxxxx \
  -H "Authorization: Bearer $SEEDANCE_API_KEY"

Risposta200

json

{
  "id": "sd2_xxxxx",
  "status": "completed",
  "model": "seedance2",
  "quality_tier": "standard",
  "channel": "standard",
  "resolution": "720p",
  "credits_used": 30,
  "credits_refunded": 0,
  "output": {
    "video_url": "https://...",
    "last_frame_url": "https://...",
    "seed": 123
  },
  "error": null,
  "created_at": "2026-06-03T10:00:00.000Z",
  "updated_at": "2026-06-03T10:03:12.000Z"
}

status: processing · completed · failed

Codici di errore

All errors share this shape:

json

{ "error": { "code": "invalid_request", "message": "Invalid request body" } }

Codice	HTTP	Significato
`unauthorized`	`401`	Missing, invalid, or revoked API key.
`invalid_request`	`400`	Bad input or unsupported field.
`purchase_required`	`403`	Seedance 2.5 requires a successful credits or plan purchase; free promotional credits alone do not unlock it.
`insufficient_credits`	`402`	Not enough credits. Seedance 2.5 always returns HTTP 402 with insufficient_credits; when an authoritative quote is available, it may also include required_credits, available_credits, pricing_version, and promotion_applied.
`rate_limited`	`429`	Too many requests — the general limit is 30 requests per 60 seconds per account; Seedance requests that validate reference media are limited to 3 per 60 seconds per account and source IP, with a project-wide safety cap. Retry after the Retry-After response header (in seconds).
`idempotency_conflict`	`409`	Same Idempotency-Key reused with a different body, or still running.
`service_busy`	`503`	Temporary upstream or credit-concurrency issue. Retry.
`not_found`	`404`	Task does not exist or does not belong to this key owner.
`internal_error`	`500`	Unexpected server-side failure.

Usa con Claude Code

Usa Copy for AI per esportare l'intera API come Markdown pulito, incollalo in Claude Code o Codex e lascia che l'agente configuri l'integrazione. Oppure punta l'agente direttamente all'endpoint di testo grezzo.

Apri llms-api.txt DeepSeek Harness plugin

Skill

Installa la skill Seedance in Claude Code, Codex o qualsiasi altro agente: scrive prompt cinematografici e li renderizza tramite API per te.

bash

# Download the one-file skill from Seedance 2 AI
mkdir -p ~/.claude/skills/seedance
curl --fail --location -H "Authorization: Bearer $SEEDANCE_API_KEY" https://www.seedance2ai.io/downloads/seedance-skill.md -o ~/.claude/skills/seedance/SKILL.md.tmp &&
mv ~/.claude/skills/seedance/SKILL.md.tmp ~/.claude/skills/seedance/SKILL.md

Scarica skill

FAQ

Chi può usare l'API?

Chiunque abbia crediti. Non c'è alcun blocco basato sul piano — qualsiasi account con crediti può creare una chiave e chiamare l'API.

Come posso ottenere crediti?

Ricarica o abbonati nella pagina dei prezzi. I crediti vengono aggiunti al tuo saldo istantaneamente.

I crediti sono condivisi tra il sito web e l'API?

Sì — il tuo saldo crediti personale alimenta sia la generazione web sia le chiamate API. In un team, le chiamate API utilizzano il saldo personale di ciascun membro, non quello condiviso del team.

Come faccio a iniziare?

Crea una chiave API nella tua dashboard, poi chiama gli endpoint con un token Bearer (vedi Quickstart sopra).

E se una chiamata restituisce insufficient_credits?

Il tuo saldo è vuoto — ricarica sulla pagina dei prezzi e riprova.