Seedance 2.0 Fast API: Endpoint di generazione video con budget

Una richiesta HTTP, una clip video di qualità cinematografica con IA, 1,94 dollari. Questa è l'economia delle unità della costruzione sulla Seedance 2.0 Fast API. Endpoint dedicati per text-to-video e image-to-video, prezzi deterministici, stesso motore di qualità della Seedance 2.0 standard, e un vantaggio di costo di circa il 20% che conta quando stai operando su larga scala.

Ecco la guida completa per sviluppatori.

A Cosa Serve La Fast API

Se stai costruendo un'app, uno strumento o un servizio che genera video per gli utenti - social scheduler, piattaforma di automazione marketing, motore di contenuti per e-commerce, strumento creativo interno - la Seedance 2.0 Fast API è l'endpoint di qualità cinematografica più economico su cui puoi costruire nel 2026.

Stessa qualità visiva della Seedance 2.0 standard. Costo inferiore al secondo. Throughput computazionale superiore. Costruito per l'integrazione in flussi di lavoro che producono video in volume.

L'utente target tipico è uno sviluppatore o un team che ha bisogno di generare video programmaticamente in base all'input dell'utente - non un singolo creator che genera una clip alla volta attraverso l'interfaccia utente.

I Due Endpoint

Endpoint text-to-video:

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

Genera un video da un prompt di testo. 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 corpi di richiesta simili e restituiscono lo stesso formato di risposta. Scegli in base al fatto che tu abbia un'immagine sorgente da animare.

Autenticazione

Ogni richiesta richiede una chiave API nell'intestazione Authorization. Genera una chiave dal tuo Pannello di controllo Arteza.

Authorization: Bearer YOUR_API_KEY

Le chiavi sono legate al tuo account e traggono dal tuo saldo di crediti. Ruotale secondo le necessità attraverso il dashboard.

Formato 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 di testo che descrive il video desiderato.
• duration (obbligatorio, intero): Lunghezza della clip in secondi. Intervallo: 4-15.
• aspect_ratio (obbligatorio, stringa): Uno di "16:9", "9:16", "1:1".

Formato 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 accessibile pubblicamente dell'immagine sorgente. Formati supportati: JPG, PNG, WebP.
• prompt (obbligatorio, stringa): Prompt di movimento che descrive come animare l'immagine.
• duration (obbligatorio, intero): Lunghezza della clip in secondi. Intervallo: 4-15.
• aspect_ratio (obbligatorio, stringa): Dovrebbe corrispondere all'aspect ratio dell'immagine sorgente per risultati migliori.

Formato Risposta

Entrambi gli endpoint restituiscono un ID processo asincrono:

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

Esegui il poll dello stato endpoint fino al completamento del processo:

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 avrai il tuo MP4.

Esempio Python Completo

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"
    }
    
    # Submit generation job
    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 queued: {job_id}, estimated {job['estimated_seconds']}s")
    
    # Poll for completion
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Complete: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generation failed: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# Usage
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 JavaScript Completo

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'
  };

  // Submit generation job
  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 queued: ${job.job_id}`);

  // Poll for completion
  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(`Generation failed: ${status.error}`);
    }
  }
}

// Usage
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 costruire sulla API? Ottieni la tua chiave API →

Prezzi Per Chiamata API

Ogni chiamata API deduce crediti dal tuo saldo in base alla durata:

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

Limiti di Velocità e Throughput

La Seedance 2.0 Fast API consente l'invio di processi concorrenti entro limiti ragionevoli. I tipici account possono inviare 5-10 processi in parallelo senza colpire le limitazioni. Gli account di tier Enterprise possono richiedere una concorrenza più elevata.

I singoli processi di generazione impiegano 30-150 secondi a seconda della durata. Con 5 processi concorrenti, puoi effettivamente produrre una clip ogni 15-30 secondi di tempo di parete.

Per la generazione batch in massa (50+ clip), invia in onde di 5-10, aspetta il completamento, quindi invia l'onda successiva. Non inondare l'API con centinaia di richieste simultanee.

Gestione degli Errori

Risposte di errore comuni:

400 Bad Request: Parametri non validi. Controlla intervallo durata, valori aspect ratio, lunghezza prompt.

401 Unauthorized: Chiave API mancante o non valida.

402 Payment Required: Crediti insufficienti. Ricarica tramite il dashboard.

429 Too Many Requests: Limite di velocità superato. Riprova con backoff.

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

Costruisci la tua integrazione per gestire 429 e 500 con grazia utilizzando la logica di retry. Un semplice backoff esponenziale (1s, 2s, 4s, 8s) copre la maggior parte dei guasti transitori.

Fast vs Standard Nel Contesto API

La scelta tra endpoint Fast e standard è principalmente economica:

• Usa Fast per la generazione programmatica ad alto volume, app sensibili ai costi, e tutto ciò che non è una clip hero.
• Usa standard per contenuti flagship dove il piccolo vantaggio di qualità giustifica il premium di costo del 20%.

La maggior parte delle app usa Fast per impostazione predefinita. L'endpoint standard è tipicamente riservato per funzionalità "premium tier" o richieste utente specifiche.

URL 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 processi di lunga durata, il polling è uno spreco. La Seedance 2.0 Fast API supporta i callback webhook: includi un webhook_url nel corpo della tua richiesta e riceverai un POST quando il processo si completa:

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 restituirebbe l'endpoint di stato al completamento. Implementa l'idempotenza: i webhook possono riprovare in caso di errore.

Domande Comuni, Risposte Veloci

Qual è il numero massimo di processi concorrenti che posso inviare? Account tipici: 5-10. Enterprise: negoziabile.

I crediti vengono detratti dai processi non riusciti? No. I processi non riusciti rimborsano automaticamente i crediti.

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

Quale formato di file è l'output? MP4, video H.264, audio AAC, risoluzione 720p.

Quanto tempo rimangono validi gli URL di output? Gli URL CDN di output sono validi per 7 giorni. Scaricali e memorizzali nel tuo sistema per l'uso a lungo termine.

C'è una modalità sandbox/test? Nessuna sandbox dedicata. Usa i tuoi 50 crediti di iscrizione gratuiti per testare. Il tier Starter di $10 è anche un modo a basso rischio per costruire contro endpoint reali.

Inizia a Costruire sulla Seedance 2.0 Fast API

L'API è deliberatamente semplice: due endpoint, prezzi deterministici, modello di processo asincrono, e un tetto di qualità che corrisponde al tier flagship Seedance 2.0. Costruisci su di essa per strumenti social, automazione marketing, piattaforme creator, motori di contenuti per e-commerce, o app creative interne. L'economia delle unità finalmente rende fattibile la generazione di video come funzionalità all'interno di altri prodotti.

Pronto a costruire? Ottieni la tua chiave API →

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