Seedance 1.0 Lite API: Endpoint per la generazione rapida di video

Una singola richiesta POST, un'attesa di 30-60 secondi, e ottieni un MP4 a 1080p. È tutto l'API Seedance 1.0 Lite. Per gli sviluppatori che costruiscono flussi di lavoro video automatizzati, che si tratti di animazioni di prodotti e-commerce, pipeline creative pubblicitarie o sistemi di generazione di contenuti, questa è la guida all'integrazione.

Perché gli sviluppatori integrano l'API

La versione UI 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 automatica del catalogo - attiva una generazione per ogni nuovo SKU aggiunto al tuo backend e-commerce
• Pipeline creative pubblicitarie - genera varianti secondo una pianificazione e inviala alle piattaforme pubblicitarie tramite le loro API
• Sistemi di generazione di contenuti - alimenta le immagini CMS in Arteza e ottieni versioni animate come risultato
• Flussi di lavoro con contenuti generati dagli utenti in tempo reale - consenti ai tuoi utenti di caricare un'immagine e ottenere una versione animata
• Job in batch - elabora centinaia di immagini sorgente durante la notte

A $0,14-$0,84 per chiamata e con un turnaround di 30-60 secondi, puoi costruire un'automazione video di qualità produttiva che sarebbe stata economicamente impossibile 18 mesi fa.

Ottenere l'accesso all'API

1. Registrati su la piattaforma - 50 crediti gratuiti arrivano immediatamente
2. Accedi alle impostazioni API nel tuo dashboard
3. Genera una chiave API - conservala in modo sicuro (non inviarla mai su git)
4. Opzionale: Acquista un bundle di crediti su la pagina dei prezzi - $10, $25, $50 o $100

I tuoi 50 crediti gratuiti funzionano anche per le chiamate API. Puoi convalidare l'integrazione completa senza pagare nulla.

Il modello di richiesta

L'interazione principale è un singolo POST all'endpoint di generazione Seedance 1.0 Lite.

Parametri obbligatori

Parametri facoltativi

Modello di risposta

L'API restituisce un ID job e uno stato. La generazione è asincrona: controlla il completamento 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 legate al tuo account e vengono addebitate sul tuo saldo di crediti. Ruota le chiavi tramite il dashboard se sospetti una fuga.

Esempio di codice: Python

Ecco un'integrazione Python minima che invia un job, controlla il completamento 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"):
    # Submit the job
    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"]
    
    # Poll for completion
    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"Generation failed: {status.get('error')}")
        time.sleep(5)

video_url = generate_video(
    image_url="https://example.com/product.jpg",
    prompt="Product rotates smoothly, highlights catch across the surface, camera completely locked",
    duration=6,
    aspect="1:1",
)
print(f"Video ready: {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') {
  // Submit the job
  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}` },
    }
  );

  // Poll for completion
  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',
  'Product rotates smoothly, highlights catch across the surface, camera completely locked',
  6,
  '1:1'
).then((url) => console.log('Video ready:', url));

Pattern di webhook (consigliato per la produzione)

Il polling funziona, ma i webhook sono più puliti su larga scala. Passa un webhook_url nella tua richiesta di generazione e l'API posterà il payload di completamento quando il job finisce.

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 handler webhook riceve lo stesso JSON di completamento dell'endpoint polling. Nessun loop di polling necessario.

Vuoi costruire questo da solo? Prova Seedance 1.0 Lite gratuitamente →

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

Limiti di velocità e concorrenza

Per una concorrenza o un volume più elevato, contatta il supporto. La piattaforma può supportare carichi di lavoro batch di 10.000+ job/giorno su configurazioni dedicate.

Gestione degli errori

I codici di stato HTTP standard si applicano:

Per le integrazioni in produzione, implementa sempre:

• Backoff esponenziale per errori 429 e 500
• Verifiche del saldo di crediti prima di eseguire grandi batch
• Convalida della firma webhook se usi webhook
• Chiavi di idempotenza per evitare addebiti duplicati su errori di rete

Gestione dei costi in produzione

Ogni chiamata addebita crediti alla tariffa standard: 7 crediti per secondo di video.

Suggerimenti per il controllo dei costi in produzione:

• Testa i prompt a 2 secondi prima di impegnarti in batch run a 12 secondi
• Imposta un budget di crediti mensile e fai in modo che il tuo codice si fermi quando viene raggiunto
• Monitora il campo credits_charged in ogni risposta per tracciare la spesa per workflow
• Usa webhook per evitare di bruciare tempo sul polling
• Memorizza i risultati riusciti quando possibile in modo che richieste identiche non si rigenerino

Pattern di integrazione reale

Animazione del catalogo e-commerce

Attiva un job Seedance 1.0 Lite ogni volta che un nuovo SKU viene aggiunto al tuo catalogo. Scrivi l'URL MP4 risultante nel tuo database di prodotti. Visualizza automaticamente sulle PDP.

Pipeline creative pubblicitaria

Il job cron giornaliero genera 10 nuove varianti pubblicitarie da diverse immagini sorgente. Spinge gli MP4 direttamente all'API Meta Ads come nuove creative. Chiude il ciclo tra generazione di contenuti e consegna pubblicitaria.

App di contenuto generato dagli utenti

Consenti agli utenti di caricare una foto nella tua app. Il tuo backend chiama Seedance 1.0 Lite con un prompt templato. Restituisci la versione animata all'utente in meno di un minuto. Addebita agli utenti abbastanza per coprire il costo API di ~$0,30 con un margine sano.

Potenziamento CMS

Collegati al tuo CMS in modo che qualsiasi nuova immagine in primo piano ottenga automaticamente una versione animata Seedance 1.0 Lite generata. Archivia entrambe le versioni, statica per fallback, animata per posizionamenti hero.

Aggiornamento batch del catalogo

Il job notturno rigenera versioni animate dei tuoi 500 prodotti principali con prompt di movimento stagionali. Creative fresca senza intervento umano.

Aggiornamento a Pro o 2.0 tramite API

Quando uno specifico job ha bisogno di qualità premium, cambia endpoint:

• /seedance-1-lite/generate - $0,14-$0,84, veloce, workhorse per volume
• /seedance-1-pro/generate - $0,48-$2,88, movimento premium, controllo del frame finale
• /seedance-2.0/generate - $2,43-$9,10, qualità cinema + audio nativo

Stessa chiave API, stesso pool di crediti, stessa autenticazione. Cambia modelli chiamando un endpoint diverso. Vedi la guida di confronto Pro per quando eseguire l'upgrade.

Inizia a integrare oggi

Registrati, ottieni la tua chiave API dal dashboard e fai la tua prima chiamata con i 50 crediti gratuiti. L'esempio Python 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 gratuitamente → - 50 crediti al primo accesso, nessuna carta richiesta, integrazione pronta per la produzione in meno di un'ora.