Seedance 2.0 Fast API: Günstiger Endpunkt zur Videogenerierung

Eine HTTP-Anfrage, ein kinoreifer KI-Videoclip, 1,94 Dollar. Das sind die Einheitskosten beim Aufbau auf der Seedance 2.0 Fast API. Dedizierte Endpunkte für Text-zu-Video und Bild-zu-Video, deterministisches Pricing, dieselbe Qualitäts-Engine wie Seedance 2.0 Standard und ein Kostenvorteil von ~20 %, der bei großem Volumen wirklich zählt.

Hier ist die vollständige Entwicklerdokumentation.

Kurzfassung

• Endpunkte: bytedance/seedance-2.0/fast/text-to-video und fast/image-to-video
• Kosten: 0,2419 Dollar pro Sekunde, oder 10-55 Credits pro Clip ($1,00-$5,50)
• Antwort: Asynchrone Job-ID, Status abfragen, MP4 herunterladen
• Authentifizierung: API-Schlüssel aus deinem Arteza-Dashboard
• Geschwindigkeit: 30-150 Sekunden pro Generierung

Wofür die Fast API gedacht ist

Wenn du eine App, ein Tool oder einen Dienst entwickelst, der Videos für Nutzer generiert, etwa einen Social-Media-Scheduler, eine Marketing-Automationsplattform, eine E-Commerce-Content-Engine oder ein internes Kreativtool, ist die Seedance 2.0 Fast API der günstigste kinoreife Endpunkt, auf dem du 2026 aufbauen kannst.

Dieselbe visuelle Qualität wie Seedance 2.0 Standard. Niedrigere Kosten pro Sekunde. Höherer Compute-Durchsatz. Entwickelt für die Integration in Workflows, die Videos in großem Umfang produzieren.

Die typische Zielgruppe sind Entwickler oder Teams, die Video programmgesteuert auf Basis von Nutzereingaben generieren müssen, nicht einzelne Creator, die einen Clip nach dem anderen über die Benutzeroberfläche erstellen.

Die zwei Endpunkte

Text-zu-Video-Endpunkt:

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

Generiert ein Video aus einem Text-Prompt. Kein Quellbild erforderlich.

Bild-zu-Video-Endpunkt:

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

Generiert ein Video, das von einem hochgeladenen Quellbild mit einem Bewegungs-Prompt ausgeht.

Beide Endpunkte akzeptieren ähnliche Request-Bodies und geben dasselbe Antwortformat zurück. Die Wahl hängt davon ab, ob du ein Quellbild zum Animieren hast.

Authentifizierung

Jede Anfrage benötigt einen API-Schlüssel im Authorization-Header. Erzeuge einen Schlüssel in deinem Arteza-Dashboard.

Authorization: Bearer YOUR_API_KEY

Schlüssel sind an dein Konto gebunden und ziehen vom Guthaben ab. Rotiere sie bei Bedarf über das Dashboard.

Request-Format: Text zu 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"
}

Parameter:

• prompt (erforderlich, string): Der Text-Prompt, der das gewünschte Video beschreibt.
• duration (erforderlich, integer): Cliplänge in Sekunden. Bereich: 4-15.
• aspect_ratio (erforderlich, string): Eines von "16:9", "9:16", "1:1".

Request-Format: Bild zu 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"
}

Parameter:

• image_url (erforderlich, string): Öffentlich zugängliche URL des Quellbilds. Unterstützte Formate: JPG, PNG, WebP.
• prompt (erforderlich, string): Bewegungs-Prompt, der beschreibt, wie das Bild animiert werden soll.
• duration (erforderlich, integer): Cliplänge in Sekunden. Bereich: 4-15.
• aspect_ratio (erforderlich, string): Sollte für beste Ergebnisse dem Seitenverhältnis des Quellbilds entsprechen.

Antwortformat

Beide Endpunkte geben eine asynchrone Job-ID zurück:

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

Den Status-Endpunkt abfragen, bis der Job abgeschlossen ist:

GET /api/v1/jobs/sdf_2026_abc123xyz

Eine abgeschlossene Antwort:

{
  "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
}

Die video_url herunterladen und du hast deine MP4-Datei.

Vollständiges Python-Beispiel

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"
    }
    
    # Generierungsjob einreichen
    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 Warteschlange: {job_id}, geschätzte Zeit {job['estimated_seconds']}s")
    
    # Auf Abschluss warten
    while True:
        time.sleep(10)
        status = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers=headers
        ).json()
        
        if status["status"] == "completed":
            print(f"Abgeschlossen: {status['video_url']}")
            return status["video_url"]
        elif status["status"] == "failed":
            raise Exception(f"Generierung fehlgeschlagen: {status.get('error')}")
        else:
            print(f"Status: {status['status']}")

# Verwendung
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"
)

Vollständiges JavaScript-Beispiel

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

  // Generierungsjob einreichen
  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 Warteschlange: ${job.job_id}`);

  // Auf Abschluss warten
  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(`Generierung fehlgeschlagen: ${status.error}`);
    }
  }
}

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

Bereit, auf der API aufzubauen? Hol dir deinen API-Schlüssel →

Kosten pro API-Aufruf

Jeder API-Aufruf zieht Credits vom Guthaben ab, basierend auf der Dauer:

Credits verfallen nicht. Kaufe größere Mengen über das Kreditstufen für bessere Kosten pro Aufruf. Der Enterprise-Tarif senkt die effektiven Kosten um ~17 %.

Ratenlimits und Durchsatz

Die Seedance 2.0 Fast API erlaubt gleichzeitige Job-Einreichungen innerhalb vernünftiger Grenzen. Typische Konten können 5-10 Jobs parallel einreichen, ohne Drosselung auszulösen. Enterprise-Konten können höhere Parallelität anfordern.

Einzelne Generierungsjobs dauern je nach Dauer 30-150 Sekunden. Mit 5 gleichzeitigen Jobs lässt sich effektiv alle ~15-30 Sekunden Echtzeit ein Clip produzieren.

Bei der Batch-Generierung großer Mengen (50+ Clips): in Wellen von 5-10 einreichen, auf den Abschluss warten und dann die nächste Welle einreichen. Die API nicht mit Hunderten gleichzeitiger Anfragen überfluten.

Fehlerbehandlung

Häufige Fehlerantworten:

400 Bad Request: Ungültige Parameter. Dauerbereich, Seitenverhältniswerte und Prompt-Länge prüfen.

401 Unauthorized: Fehlender oder ungültiger API-Schlüssel.

402 Payment Required: Nicht genug Credits. Über das Dashboard aufladen.

429 Too Many Requests: Ratenlimit überschritten. Zurückziehen und erneut versuchen.

500 Internal Server Error: Vorübergehendes Serverproblem. Mit exponentiellem Backoff erneut versuchen.

Die Integration sollte 429 und 500 mit Retry-Logik verarbeiten. Ein einfacher exponentieller Backoff (1 s, 2 s, 4 s, 8 s) deckt die meisten vorübergehenden Fehler ab.

Fast vs. Standard im API-Kontext

Die Wahl zwischen Fast- und Standard-API-Endpunkten ist hauptsächlich eine wirtschaftliche Entscheidung:

• Fast verwenden für hochvolumige programmgesteuerte Generierung, kostensensitive Apps und alles, was kein Hero-Clip ist.
• Standard verwenden für Flaggschiff-Inhalte, bei denen der kleine Qualitätsvorsprung den Kostenaufschlag von 20 % rechtfertigt.

Die meisten Apps nutzen standardmäßig Fast. Der Standard-Endpunkt ist typischerweise für "Premium-Tier"-Funktionen oder spezifische Nutzeranfragen reserviert.

Endpunkt-URLs:

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

Webhook-Unterstützung

Bei lang laufenden Jobs ist Polling verschwenderisch. Die Seedance 2.0 Fast API unterstützt Webhook-Callbacks. Eine webhook_url im Request-Body angeben und du erhältst einen POST, wenn der Job abgeschlossen ist:

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"
}

Dein Webhook-Endpunkt empfängt denselben JSON-Payload, den der Status-Endpunkt bei Abschluss zurückgeben würde. Idempotenz implementieren: Webhooks können bei Fehlern erneut versuchen.

Häufige Fragen, kurze Antworten

Wie viele gleichzeitige Jobs kann ich einreichen? Typische Konten: 5-10. Enterprise: verhandelbar.

Werden bei fehlgeschlagenen Jobs Credits abgezogen? Nein. Bei fehlgeschlagenen Jobs werden die Credits automatisch erstattet.

Kann ich einen laufenden Job abbrechen? Ja, über POST /api/v1/jobs/{job_id}/cancel. Credits werden erstattet, wenn der Job vor dem Abschluss abgebrochen wird.

In welchem Dateiformat wird das Ergebnis ausgegeben? MP4, H.264-Video, AAC-Audio, 720p-Auflösung.

Wie lange sind die Ausgabe-URLs gültig? Ausgabe-CDN-URLs sind 7 Tage gültig. Für die Langzeitnutzung herunterladen und im eigenen System speichern.

Gibt es einen Sandbox-/Testmodus? Kein dedizierter Sandbox. Die 10 kostenlosen Anmeldegutschriften zum Testen nutzen. Der Starter-Plan für 5 Dollar ist ebenfalls eine risikoarme Möglichkeit, gegen echte Endpunkte zu entwickeln.

Mit dem Aufbau auf der Seedance 2.0 Fast API beginnen

Die API ist bewusst einfach gehalten: zwei Endpunkte, deterministisches Pricing, asynchrones Job-Modell und eine Qualitätsobergrenze, die dem Flaggschiff-Tier Seedance 2.0 entspricht. Nutze sie für Social-Media-Tools, Marketing-Automatisierung, Creator-Plattformen, E-Commerce-Content-Engines oder interne Kreativ-Apps. Die Einheitskosten machen Videogenerierung endlich als Feature in anderen Produkten realisierbar.

Bereit loszulegen? Hol dir deinen API-Schlüssel →

Weiterlesen: Vollständiger Leitfaden zu Seedance 2.0 Fast • Preise für Seedance 2.0 Fast • Seedance 2.0 Fast Massenerstellung