Come si usa l'API Seedance 2.0? Realizza il tuo primo video in 5 minuti

TL;DR

• Seedance 2.0 è il modello di generazione video di ByteDance, disponibile su HiAPI in tre livelli: Mini, Fast e Standard. Apri la pagina del modello per generare online; i nuovi utenti ricevono 200 crediti alla registrazione.
• Fatturazione al secondo: Mini 720p costa $0.0586 al secondo, Standard 720p $0.293 al secondo, 1080p sulla linea ext $0.342 al secondo; l'audio non ha costi aggiuntivi.
• L'API richiede solo due passaggi: invia con POST /v1/tasks, poi controlla il risultato con taskId. Gli esempi curl e Python qui sotto funzionano subito copiandoli.

Cosa può fare Seedance 2.0?

• Testo in video: da 4 a 15 secondi, da 480p a 4K, sei formati (16:9, 9:16, 1:1, 4:3, 3:4, 21:9); con il video da immagine puoi anche usare adaptive per seguire l'immagine originale.
• Video da immagine: passa il primo fotogramma (first_frame_url) e, se vuoi, aggiungi il fotogramma finale (last_frame_url) per controllare l'inquadratura conclusiva.
• Riferimenti multimodali: fino a 9 immagini di riferimento, 3 video di riferimento e 3 audio di riferimento, per fissare personaggi, movimenti di camera o ritmo.
• Audio nativo: generate_audio è attivo per impostazione predefinita; ambiente e effetti sonori vengono generati in sincrono con le immagini.

Questa ripresa di prodotto da 5 secondi in 720p è stata generata direttamente da un unico prompt:

A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a
brushed-concrete pedestal, soft diffused studio light, the screen wakes to
show a glowing minimalist watch face, faint reflections move across the metal
bezel, premium tech commercial look, calm and clean.

Genera con questo prompt →

Due percorsi per iniziare

Prova online (senza scrivere codice)

1. Apri la pagina del modello Seedance 2.0 e registrati o accedi.
2. Incolla il prompt e scegli durata, risoluzione e formato.
3. Fai clic su genera e scarica direttamente il video una volta prodotto (i tre campioni latte da 5 secondi in 720p nella pagina dei prezzi hanno impiegato 168–230 secondi dall'invio al completamento).

Chiamata API

1. Crea una API Key nella console.
2. Invia l'attività con POST https://api.hiapi.ai/v1/tasks; ricevi taskId.
3. Controlla lo stato con GET /v1/tasks/{taskId}; quando status è success, scarica il video da output[0].url.

curl: il primo video

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "input": {
      "prompt": "A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a brushed-concrete pedestal, soft diffused studio light.",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

Risposta:

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

Controlla il risultato:

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Python: invio, polling, download

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(prompt, model="seedance-2.0", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # 同一个任务重试提交时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

url = generate(
    "A barista pours steamed milk into a latte, camera slowly pulls back",
    model="seedance-2.0-mini", duration=5, resolution="480p", aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

Quando metti a punto il prompt, sostituisci model con seedance-2.0-mini e usa la risoluzione 480p: 5 secondi costano solo $0.136; una volta definito, passa a Standard o alla linea ext per l'alta definizione.

Video da immagine e riferimenti multimodali

Video da immagine con primo fotogramma: aggiungi first_frame_url in input e scrivi adaptive come formato per seguire le proporzioni dell'immagine:

{
  "model": "seedance-2.0",
  "input": {
    "prompt": "Slow cinematic push-in on the product with a soft light sweep, keep the product still and centered",
    "first_frame_url": "https://your-cdn.example.com/product.jpg",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "resolution": "720p"
  }
}

Immagini, video e audio di riferimento: usa rispettivamente reference_image_urls (immagini di riferimento più fotogrammi iniziale e finale, massimo 9 in totale), reference_video_urls (massimo 3 segmenti, per un totale non superiore a 15 secondi) e reference_audio_urls (massimo 3 segmenti, per un totale non superiore a 15 secondi).

Combinazioni di input per Mini: per Mini scegli una sola tra primo fotogramma, immagine di riferimento e video di riferimento; duration e resolution sono obbligatori; per Standard aspect_ratio è obbligatorio.

Linea ext: aggiungi "route": "ext" al livello superiore, il nome del modello resta invariato. ext supporta solo 720p, 1080p e 4K, costa meno al secondo, ma non accetta video di riferimento.

Da sapere prima della messa in produzione

• Usa i callback invece del polling: aggiungi al livello superiore della richiesta "callback": {"url": "https://tuo-dominio/hiapi/callback"}; HiAPI notifica attivamente al termine dell'attività (successo o fallimento); deduplica per taskId.
• I video vengono conservati per circa 7 giorni: dopo aver ottenuto output[0].url, trasferiscilo sul tuo storage; per la conservazione a lungo termine puoi usare lo storage persistente di HiAPI (con costi aggiuntivi in base allo spazio occupato).
• Specifica tutti i parametri: scrivi esplicitamente duration, resolution e aspect_ratio, così i costi corrispondono al budget previsto.
• Rimborso automatico in caso di errore: le attività fallite non vengono addebitate; paghi solo i secondi generati con successo.

Domande frequenti

Come scegliere tra Mini, Fast e Standard?

Usa Mini per mettere a punto i prompt, Mini o Fast 720p per i video brevi per i social, Standard o la linea ext per 1080p / 4K. Per i prezzi dettagliati vedi Prezzi dell'API Seedance 2.0.

Si possono scrivere prompt in cinese?

Sì. Sono supportati sia il cinese che l'inglese; i risultati sono più stabili se descrivi in frasi separate inquadratura, azione, illuminazione e audio.

Si possono generare video verticali?

Sì. Imposta aspect_ratio a 9:16; per il video da immagine scrivi adaptive per seguire le proporzioni del primo fotogramma.

Quanto tempo serve per un video?

I tre campioni latte da 5 secondi in 720p nella pagina dei prezzi hanno impiegato 168–230 secondi dall'invio al completamento. In produzione usa i callback per ricevere i risultati, non affidarti a tempi di attesa fissi.

Copia il prompt dell'orologio qui sopra e vai alla pagina del modello per generare il tuo primo video; se vuoi altri prompt già pronti, guarda Esempi di prompt per Seedance 2.0.