Seedance 2.0 Fast API: endpoint economico per la generazione di video

Una richiesta HTTP, un clip video di qualità cinematografica, $1,94. Questa è l'economia unitaria dello sviluppo sull'API Seedance 2.0 Fast. Endpoint dedicati per text-to-video e image-to-video, prezzi deterministici, lo stesso motore qualitativo di Seedance 2.0 standard e un vantaggio di costo di circa il 20% che fa la differenza quando si lavora su larga scala.

Ecco la guida completa per sviluppatori.

A cosa serve la Fast API

Se stai sviluppando un'app, uno strumento o un servizio che genera video per gli utenti, come un pianificatore social, una piattaforma di marketing automation, un motore di contenuti per l'e-commerce o uno strumento creativo interno, la Seedance 2.0 Fast API è l'endpoint cinematografico più economico su cui costruire nel 2026.

Stessa qualità visiva di Seedance 2.0 standard. Costo per secondo inferiore. Throughput di calcolo maggiore. Progettata per l'integrazione in workflow che producono video in grandi volumi.

Il target tipico è uno sviluppatore o un team che deve generare video in modo programmatico sulla base degli input degli utenti, non un singolo creator che genera un clip alla volta tramite l'interfaccia grafica.

I due endpoint

Endpoint text-to-video:

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/text-to-video

Genera un video a partire da un prompt testuale. Nessuna immagine sorgente richiesta.

Endpoint image-to-video:

POST https://arteza.ai/api/v1/bytedance/seedance-2.0/fast/image-to-video

Genera un video a partire da un'immagine sorgente caricata, con un prompt di movimento.

Entrambi gli endpoint accettano body di richiesta simili e restituiscono lo stesso formato di risposta. Scegli in base alla disponibilità di un'immagine sorgente da animare.

Autenticazione

Ogni richiesta richiede una chiave API nell'header Authorization. Genera una chiave dal tuo Arteza dashboard.

Authorization: Bearer YOUR_API_KEY

Le chiavi sono legate al tuo account e scalano dal saldo crediti. Ruotale quando necessario tramite il pannello di controllo.

Formato della richiesta: text-to-video

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "Slow dolly in on a ceramic coffee cup on a wooden cafe table, morning window light, shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Parametri:

• prompt (obbligatorio, stringa): Il prompt testuale che descrive il video desiderato.
• duration (obbligatorio, intero): Durata del clip in secondi. Intervallo: 4-15.
• aspect_ratio (obbligatorio, stringa): Uno tra "16:9", "9:16", "1:1".

Formato della richiesta: image-to-video

POST /api/v1/bytedance/seedance-2.0/fast/image-to-video
{
  "image_url": "https://your-cdn.com/source-image.jpg",
  "prompt": "Slow push in with shallow depth of field, cinematic 35mm film look",
  "duration": 5,
  "aspect_ratio": "16:9"
}

Parametri:

• image_url (obbligatorio, stringa): URL pubblicamente accessibile dell'immagine sorgente. Formati supportati: JPG, PNG, WebP.
• prompt (obbligatorio, stringa): Prompt di movimento che descrive come animare l'immagine.
• duration (obbligatorio, intero): Durata del clip in secondi. Intervallo: 4-15.
• aspect_ratio (obbligatorio, stringa): Dovrebbe corrispondere all'aspect ratio dell'immagine sorgente per i migliori risultati.

Formato della risposta

Entrambi gli endpoint restituiscono un ID job asincrono:

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "queued",
  "estimated_seconds": 45,
  "cost_credits": 242
}

Interroga l'endpoint di stato finché il job non è completato:

GET /api/v1/jobs/sdf_2026_abc123xyz

Una risposta completata:

{
  "job_id": "sdf_2026_abc123xyz",
  "status": "completed",
  "video_url": "https://cdn.arteza.ai/output/sdf_2026_abc123xyz.mp4",
  "duration_seconds": 5,
  "resolution": "720p",
  "credits_consumed": 242
}

Scarica il video_url e hai il tuo MP4.

Esempio completo in Python

import requests
import time

API_KEY = "your_api_key_here"
BASE_URL = "https://arteza.ai/api/v1"

def generate_fast_video(prompt, duration=5, aspect_ratio="16:9"):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    
    # Invia il job di generazione
    response = requests.post(
        f"{BASE_URL}/bytedance/seedance-2.0/fast/text-to-video",
        headers=headers,
        json={
            "prompt": prompt,
            "duration": duration,
            "aspect_ratio": aspect_ratio
        }
    )
    job = response.json()
    job_id = job["job_id"]
    print(f"Job in coda: {job_id}, stimati {job['estimated_seconds']}s")
    
    # Polling fino al completamento
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Completato: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generazione fallita: {status.get('error')}")
        else:
            print(f"Stato: {status['status']}")

# Utilizzo
video_url = generate_fast_video(
    "Slow tracking shot of a golden retriever running through autumn leaves, golden hour, cinematic 35mm film look",
    duration=5,
    aspect_ratio="16:9"
)

Esempio completo in JavaScript

const API_KEY = 'your_api_key_here';
const BASE_URL = 'https://arteza.ai/api/v1';

async function generateFastVideo(prompt, duration = 5, aspectRatio = '16:9') {
  const headers = {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  };

  // Invia il job di generazione
  const submitRes = await fetch(
    `${BASE_URL}/bytedance/seedance-2.0/fast/text-to-video`,
    {
      method: 'POST',
      headers,
      body: JSON.stringify({ prompt, duration, aspect_ratio: aspectRatio })
    }
  );
  const job = await submitRes.json();
  console.log(`Job in coda: ${job.job_id}`);

  // Polling fino al completamento
  while (true) {
    await new Promise(r => setTimeout(r, 10000));
    const statusRes = await fetch(
      `${BASE_URL}/jobs/${job.job_id}`,
      { headers }
    );
    const status = await statusRes.json();

    if (status.status === 'completed') {
      return status.video_url;
    } else if (status.status === 'failed') {
      throw new Error(`Generazione fallita: ${status.error}`);
    }
  }
}

// Utilizzo
const videoUrl = await generateFastVideo(
  'Slow dolly in on a matcha latte in a ceramic cup, morning window light, cinematic 35mm',
  5,
  '9:16'
);

Pronto a sviluppare sull'API? Ottieni la tua chiave API →

Prezzi per chiamata API

Ogni chiamata API detrae crediti dal saldo in base alla durata:

I crediti non scadono. Acquistali in blocco tramite livelli di credito per un'economia per chiamata migliore: il piano Enterprise riduce il costo effettivo di circa il 17%.

Limiti di frequenza e throughput

La Seedance 2.0 Fast API consente l'invio di job in parallelo entro limiti ragionevoli. Gli account standard possono inviare 5-10 job in parallelo senza incontrare throttling. Gli account Enterprise possono richiedere una concorrenza maggiore.

I singoli job di generazione richiedono 30-150 secondi a seconda della durata. Con 5 job in parallelo, è possibile produrre un clip ogni circa 15-30 secondi di tempo reale.

Per la generazione batch in blocco (50 o più clip), invia ondate da 5-10, attendi il completamento e poi invia l'ondata successiva. Non sovraccaricare l'API con centinaia di richieste simultanee.

Gestione degli errori

Risposte di errore comuni:

400 Bad Request: Parametri non validi. Verifica l'intervallo di durata, i valori dell'aspect ratio e la lunghezza del prompt.

401 Unauthorized: Chiave API mancante o non valida.

402 Payment Required: Crediti insufficienti. Ricarica tramite il pannello di controllo.

429 Too Many Requests: Limite di frequenza superato. Riduci la frequenza e riprova.

500 Internal Server Error: Problema temporaneo del server. Riprova con backoff esponenziale.

Costruisci la tua integrazione in modo che gestisca i codici 429 e 500 correttamente con una logica di retry. Un semplice backoff esponenziale (1s, 2s, 4s, 8s) copre la maggior parte degli errori transitori.

Fast vs standard nel contesto API

La scelta tra gli endpoint Fast e standard è principalmente economica:

• Usa Fast per la generazione programmatica ad alto volume, le app sensibili ai costi e tutto ciò che non è un clip di punta.
• Usa standard per i contenuti di punta in cui il piccolo vantaggio qualitativo giustifica il costo maggiore del 20%.

La maggior parte delle app usa Fast come impostazione predefinita. L'endpoint standard è tipicamente riservato alle funzionalità "premium" o a richieste specifiche degli utenti.

URL degli endpoint:

• Fast text: bytedance/seedance-2.0/fast/text-to-video
• Fast image: bytedance/seedance-2.0/fast/image-to-video
• Standard text: bytedance/seedance-2.0/text-to-video
• Standard image: bytedance/seedance-2.0/image-to-video

Supporto webhook

Per i job di lunga durata, il polling è dispendioso. La Seedance 2.0 Fast API supporta le callback webhook: includi un webhook_url nel body della richiesta e riceverai un POST al completamento del job:

POST /api/v1/bytedance/seedance-2.0/fast/text-to-video
{
  "prompt": "...",
  "duration": 5,
  "aspect_ratio": "16:9",
  "webhook_url": "https://your-app.com/api/seedance-callback"
}

Il tuo endpoint webhook riceve lo stesso payload JSON che l'endpoint di stato restituirebbe al completamento. Implementa l'idempotenza: i webhook possono riprovare in caso di errore.

Domande frequenti, risposte rapide

Qual è il numero massimo di job che posso inviare contemporaneamente? Account standard: 5-10. Enterprise: negoziabile.

I crediti vengono scalati per i job falliti? No. I job falliti rimborsano automaticamente i crediti.

Posso annullare un job in corso? Sì, tramite POST /api/v1/jobs/{job_id}/cancel. Rimborsa i crediti se annullato prima del completamento.

Qual è il formato del file di output? MP4, video H.264, audio AAC, risoluzione 720p.

Per quanto tempo rimangono validi gli URL di output? Gli URL CDN di output sono validi per 7 giorni. Scaricali e archiviandoli nel tuo sistema per un utilizzo a lungo termine.

Esiste una modalità sandbox/test? Nessuna sandbox dedicata. Usa i tuoi crediti gratuiti 10 al momento della registrazione per fare test. Il piano Starter da $5 è anche un modo a basso rischio per sviluppare contro endpoint reali.

Inizia a costruire sulla Seedance 2.0 Fast API

L'API è volutamente semplice: due endpoint, prezzi deterministici, modello di job asincrono e un livello qualitativo che corrisponde al piano Seedance 2.0 di punta. Costruisci su di essa per strumenti social, marketing automation, piattaforme per creator, motori di contenuti e-commerce o app creative interne. L'economia unitaria rende finalmente la generazione video fattibile come funzionalità all'interno di altri prodotti.

Pronto a costruire? Ottieni la tua chiave API →

Continua a leggere: Guida completa a Seedance 2.0 Fast • Prezzi di Seedance 2.0 Fast • Creazione in batch con Seedance 2.0 Fast