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 Video

Testo, immagine o media in video.

POST

/api/v1/video/seedance

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`	`standardpro`
`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:16`
`duration` Clip duration.	`string`	Opzionale	`5`	`4–15 (seconds)`
`resolution` Output resolution.	`string`	Opzionale	`720p`	`720p1080p`
`image_url` Start frame — required for image-to-video.	`string (URL)`	Opzionale	`—`	`public https URL`
`end_image_url` Optional end frame.	`string (URL)`	Opzionale	`—`	`public https URL`
`media_urls` Required for media-to-video.	`string[] (URL)`	Opzionale	`—`	`≤ 12 public https URLs`
`generate_audio` Generate an audio track.	`boolean`	Opzionale	`true`	`truefalse`
`fixed_lens` Lock the camera lens.	`boolean`	Opzionale	`false`	`truefalse`
`seed` Not supported on the real channel.	`integer`	Opzionale	`—`	`-1 – 4294967295`

Invia lavoro

bash

curl -X POST https://seedance2ai.io/api/v1/video/seedance \
  -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"
  }'

GPT Image 2

Generazione di immagini ad alta fedeltà.

POST

/api/v1/image/gpt-image-2

Parametri

Parametro	Tipo	Obbligatorio	Predefinito	Valori consentiti
`type` Generation type.	`string`	Obbligatorio	`—`	`text-to-imageimage-to-image`
`channel` Generation channel. economy is lower-cost with polling-based delivery.	`string`	Opzionale	`standard`	`standardeconomy`
`prompt` Text prompt.	`string`	Obbligatorio	`—`	`3–20000 chars`
`resolution` Output resolution. auto only supports 1K; 1:1 cannot use 4K on the standard channel.	`string`	Obbligatorio	`—`	`1K2K4K`
`aspectRatio` Aspect ratio.	`string`	Obbligatorio	`—`	`auto1:15:49:1621:916:94:33:24:53:42:32:11:23:11:39:21`
`batchCount` Number of images.	`integer`	Opzionale	`1`	`1–4`
`imageUrls` Required for image-to-image.	`string[] (URL)`	Opzionale	`—`	`1–10 public https URLs`

Invia lavoro

bash

curl -X POST https://seedance2ai.io/api/v1/image/gpt-image-2 \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-gpt-image-001" \
  -d '{
    "type": "text-to-image",
    "prompt": "Editorial product photo of a transparent running shoe on chrome",
    "resolution": "1K",
    "aspectRatio": "1:1"
  }'

Nano Banana Pro

Output immagine stilizzato e premium.

POST

/api/v1/image/nano-banana-pro

Parametri

Parametro	Tipo	Obbligatorio	Predefinito	Valori consentiti
`type` Generation type.	`string`	Obbligatorio	`—`	`text-to-imageimage-to-image`
`prompt` Text prompt.	`string`	Obbligatorio	`—`	`3–10000 chars`
`image_size` Aspect ratio.	`string`	Opzionale	`auto`	`1:19:1616:93:44:33:22:35:44:521:9auto`
`output_format` Image format.	`string`	Opzionale	`png`	`pngjpeg`
`resolution` Output resolution.	`string`	Opzionale	`1K`	`1K2K4K`
`image_urls` Required for image-to-image.	`string[] (URL)`	Opzionale	`—`	`1–8 public https URLs`

Invia lavoro

bash

curl -X POST https://seedance2ai.io/api/v1/image/nano-banana-pro \
  -H "Authorization: Bearer $SEEDANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: demo-nbp-001" \
  -d '{
    "type": "text-to-image",
    "prompt": "A premium packaging mockup for an AI video studio",
    "image_size": "1:1",
    "resolution": "1K",
    "output_format": "png"
  }'

Controlla lo stato dell'attività

Interroga finché lo stato non è completato o fallito.

bash

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

json

{
  "id": "sd2_xxxxx",
  "status": "completed",
  "model": "seedance",
  "output": { "video_url": "https://..." },
  "credits_used": 30
}

Codici di errore

Codice	HTTP	Significato
`unauthorized`	`401`	Missing, invalid, or revoked API key.
`invalid_request`	`400`	Bad input or unsupported field.
`insufficient_credits`	`402`	Not enough credits on the balance.
`rate_limited`	`429`	Too many requests for this account.
`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.

Skill

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

bash

# Clone into Claude Code's skills folder
git clone https://github.com/tkaptop/seedance-skill ~/.claude/skills/seedance

Visualizza su GitHub

Usa con Claude Code

Premi Copia per far sì che l'AI catturi l'intera API in Markdown pulito, incollalo in Claude Code o Codex e lascia che configuri l'integrazione. Oppure indirizza l'agente direttamente all'endpoint del testo raw.

Apri llms.txt

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.