Seedance 1.0 Lite API: endpoint rapido per la generazione di video

Una singola richiesta POST, un'attesa di 30-60 secondi e ricevi un MP4 in 1080p. Questo è tutto ciò che offre l'API di Seedance 1.0 Lite. Per gli sviluppatori che costruiscono flussi di lavoro video automatizzati, che si tratti di animazioni di prodotti per e-commerce, pipeline di creatività pubblicitaria o sistemi di generazione di contenuti, questa è la guida all'integrazione.

Sintesi

• Un singolo endpoint POST accetta immagine + prompt di movimento e restituisce un MP4 in 1080p
• Modello asincrono: invia la richiesta, verifica il completamento, scarica il risultato
• Costo per chiamata: $0,20-$1,00 in base alla durata (2-12 secondi)
• Latenza tipica end-to-end: 30-60 secondi
• 10 crediti gratuiti alla registrazione, sufficienti per validare l'integrazione prima di impegnarsi
• Lo stesso pool di crediti funziona su tutti i modelli Arteza e Seedream

Perché gli sviluppatori integrano l'API

La versione con interfaccia grafica di Seedance 1.0 Lite è ottima per la generazione manuale. L'API sblocca i flussi di lavoro che l'uso manuale non può supportare:

• Animazione automatizzata del catalogo - avvia una generazione per ogni nuovo SKU aggiunto al tuo backend e-commerce
• Pipeline di creatività pubblicitaria - genera varianti secondo una pianificazione e inviale alle piattaforme pubblicitarie tramite le loro API
• Sistemi di generazione di contenuti - inserisci le immagini del CMS in Arteza e ricevi indietro le versioni animate
• Flussi di lavoro generati dagli utenti in tempo reale - permetti ai tuoi utenti di caricare un'immagine e ricevere una versione animata
• Lavori in batch - elabora centinaia di immagini sorgente durante la notte

A $0,20-$1,00 per chiamata e con un'esecuzione di 30-60 secondi, puoi costruire automazione video di livello produttivo che 18 mesi fa sarebbe stata economicamente impossibile.

Come ottenere l'accesso all'API

1. Registrati su la piattaforma - 10 crediti gratuiti vengono accreditati immediatamente
2. Vai alle impostazioni API nella tua dashboard
3. Genera una chiave API - conservala in modo sicuro (non inserirla mai in git)
4. Facoltativo: scegli un piano mensile su la pagina dei prezzi - $5, $25, $50 o $120

I tuoi 10 crediti gratuiti funzionano anche per le chiamate API. Puoi validare l'intera integrazione prima di pagare qualsiasi cosa.

Il modello di richiesta

L'interazione principale è una singola POST all'endpoint di generazione di Seedance 1.0 Lite.

Parametri obbligatori

Parametri facoltativi

Modello di risposta

L'API restituisce un ID lavoro e uno stato. La generazione è asincrona: verifica il completamento tramite polling o usa un webhook.

{
  "job_id": "sd1lite_abc123xyz",
  "status": "processing",
  "credits_charged": 42,
  "estimated_time_seconds": 45,
  "created_at": "2026-04-10T12:00:00Z"
}

Al completamento:

{
  "job_id": "sd1lite_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/...",
  "duration_seconds": 6,
  "resolution": "1080p",
  "credits_charged": 42,
  "completed_at": "2026-04-10T12:00:45Z"
}

Autenticazione

Tutte le richieste utilizzano l'autenticazione con token bearer tramite l'header Authorization:

Authorization: Bearer YOUR_API_KEY

Le chiavi API sono collegate al tuo account e vengono addebitate sul tuo saldo di crediti. Ruota le chiavi tramite la dashboard se sospetti una compromissione.

Esempio di codice: Python

Ecco un'integrazione Python minimale che invia un lavoro, verifica il completamento tramite polling e scarica il risultato.

import requests
import time
import os

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1"

def generate_video(image_url, prompt, duration=6, aspect="9:16"):
    # Invia il lavoro
    response = requests.post(
        f"{BASE_URL}/seedance-1-lite/generate",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "image": image_url,
            "prompt": prompt,
            "duration": duration,
            "resolution": "1080p",
            "aspect_ratio": aspect,
            "camera_lock": True,
        },
    )
    job = response.json()
    job_id = job["job_id"]
    
    # Verifica il completamento tramite polling
    while True:
        status_response = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        status = status_response.json()
        if status["status"] == "completed":
            return status["video_url"]
        if status["status"] == "failed":
            raise Exception(f"Generazione fallita: {status.get('error')}")
        time.sleep(5)

video_url = generate_video(
    image_url="https://example.com/product.jpg",
    prompt="Il prodotto ruota fluidamente, i riflessi si propagano sulla superficie, telecamera completamente fissa",
    duration=6,
    aspect="1:1",
)
print(f"Video pronto: {video_url}")

Esempio di codice: Node.js

const axios = require('axios');

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1';

async function generateVideo(imageUrl, prompt, duration = 6, aspect = '9:16') {
  // Invia il lavoro
  const { data: job } = await axios.post(
    `${BASE_URL}/seedance-1-lite/generate`,
    {
      image: imageUrl,
      prompt,
      duration,
      resolution: '1080p',
      aspect_ratio: aspect,
      camera_lock: true,
    },
    {
      headers: { Authorization: `Bearer ${API_KEY}` },
    }
  );

  // Verifica il completamento tramite polling
  while (true) {
    const { data: status } = await axios.get(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers: { Authorization: `Bearer ${API_KEY}` } }
    );

    if (status.status === 'completed') return status.video_url;
    if (status.status === 'failed') throw new Error(status.error);

    await new Promise((r) => setTimeout(r, 5000));
  }
}

generateVideo(
  'https://example.com/product.jpg',
  'Il prodotto ruota fluidamente, i riflessi si propagano sulla superficie, telecamera completamente fissa',
  6,
  '1:1'
).then((url) => console.log('Video pronto:', url));

Pattern con webhook (consigliato per la produzione)

Il polling funziona, ma i webhook sono più eleganti su larga scala. Passa un webhook_url nella tua richiesta di generazione e l'API invierà il payload di completamento tramite POST quando il lavoro termina.

response = requests.post(
    f"{BASE_URL}/seedance-1-lite/generate",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "image": image_url,
        "prompt": prompt,
        "duration": 6,
        "webhook_url": "https://your-app.com/webhooks/seedance",
    },
)

Il tuo gestore webhook riceve lo stesso JSON di completamento dell'endpoint di polling. Nessun ciclo di polling necessario.

Vuoi crearlo tu stesso? Prova Seedance 1.0 Lite gratis →

Pronto a provare Seedance 1.0 Lite? Inizia a creare gratis →

Limiti di frequenza e concorrenza

Per una concorrenza o un volume maggiori, contatta il supporto. La piattaforma può supportare carichi di lavoro in batch di oltre 10.000 lavori al giorno su configurazioni dedicate.

Gestione degli errori

Si applicano i codici di stato HTTP standard:

Per le integrazioni in produzione, implementa sempre:

• Backoff esponenziale per gli errori 429 e 500
• Controlli del saldo crediti prima di grandi esecuzioni in batch
• Validazione della firma del webhook se utilizzi i webhook
• Chiavi di idempotenza per evitare addebiti duplicati in caso di errori di rete

Gestione dei costi in produzione

Ogni chiamata addebita crediti in base alla durata: 2 crediti per un clip di 2-3 secondi, fino a 7 crediti per 12 secondi.

Consigli per il controllo dei costi in produzione:

• Testa i prompt a 2 secondi prima di avviare esecuzioni in batch da 12 secondi
• Imposta un budget mensile di crediti e fai in modo che il codice si interrompa quando viene raggiunto
• Monitora il campo credits_charged in ogni risposta per tracciare la spesa per flusso di lavoro
• Usa i webhook per evitare di sprecare tempo nel polling
• Salva in cache i risultati riusciti quando possibile, così le richieste identiche non vengono rigenerate

Pattern di integrazione reali

Animazione del catalogo e-commerce

Avvia un lavoro Seedance 1.0 Lite ogni volta che un nuovo SKU viene aggiunto al tuo catalogo. Salva l'URL dell'MP4 risultante nel tuo database prodotti. Visualizzalo automaticamente nelle pagine di dettaglio prodotto.

Pipeline di creatività pubblicitaria

Un cron job giornaliero genera 10 nuove varianti di annunci da diverse immagini sorgente. Invia gli MP4 direttamente all'API di Meta Ads come nuovi elementi creativi. Chiude il ciclo tra la generazione di contenuti e la consegna degli annunci.

App di contenuti generati dagli utenti

Permetti agli utenti di caricare una foto nella tua app. Il tuo backend chiama Seedance 1.0 Lite con un prompt predefinito. Restituisce la versione animata all'utente in meno di un minuto. Addebita agli utenti un importo sufficiente a coprire il costo API di circa $0.20 con un margine adeguato.

Miglioramento del CMS

Integra il tuo CMS in modo che ogni nuova immagine in evidenza ottenga automaticamente una versione animata generata da Seedance 1.0 Lite. Conserva entrambe le versioni: quella statica come fallback e quella animata per i posizionamenti hero.

Aggiornamento in batch del catalogo

Un lavoro notturno rigenera le versioni animate dei tuoi 500 prodotti più importanti con prompt di movimento stagionali. Contenuti freschi senza intervento umano.

Aggiornamento a Pro o 2.0 tramite API

Quando un lavoro specifico richiede qualità premium, cambia endpoint:

• /seedance-1-lite/generate - $0,20-$1,00, veloce, ideale per grandi volumi
• /seedance-1-pro/generate - $0,20-$1,00, movimento premium, controllo del frame finale
• /seedance-2.0/generate - $1.20-$4.40, qualità cinematografica e audio nativo

Stessa chiave API, stesso pool di crediti, stessa autenticazione. Cambia modello chiamando un endpoint diverso. Consulta la guida al confronto Pro per sapere quando aggiornare.

Inizia a integrare oggi

Registrati, ottieni la tua chiave API dalla dashboard ed esegui la tua prima chiamata con i 10 crediti gratuiti. L'esempio Python qui sopra viene eseguito end-to-end in circa 45 secondi e ti fornisce un pattern di integrazione funzionante su cui costruire.

Ottieni la tua chiave API gratis → - 10 crediti alla registrazione, nessuna carta richiesta, integrazione pronta per la produzione in meno di un'ora.