Seedance 2.0 Fast API: Budget-Videoerstellung Endpoint

Eine HTTP-Anfrage, ein Kino-Video-Clip mit KI, 1,94 Dollar. Das ist die Einheitenökonomie beim Aufbau auf der Seedance 2.0 Fast API. Dedizierte Endpunkte für Text-zu-Video und Bild-zu-Video, deterministische Preisgestaltung, dieselbe Qualitätsengine wie Seedance 2.0 Standard, und ein ~20% Kostenvorteil, der zählt, wenn du im großen Maßstab arbeitest.

Hier ist die vollständige Entwicklerhandbuch.

Wofür die Fast API ist

Wenn du eine App, ein Tool oder einen Service aufbaust, der Videos für Nutzer generiert - Social Scheduler, Marketing-Automatisierungsplattform, E-Commerce-Content-Engine, internes Kreativ-Tool - ist die Seedance 2.0 Fast API der günstigste Cinema-Grade-Endpunkt, auf dem du 2026 aufbauen kannst.

Dieselbe visuelle Qualität wie Seedance 2.0 Standard. Niedrigere Kosten pro Sekunde. Höherer Rechenleistungsdurchsatz. Gebaut für die Integration in Workflows, die Videos in Masse produzieren.

Der typische Zielnutzer ist ein Entwickler oder Team, das Videos programmgesteuert basierend auf Nutzereingaben generieren muss - nicht ein einzelner Creator, der über die Benutzeroberfläche einen Clip nach dem anderen generiert.

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 einer Textaufforderung. Kein Quellbild erforderlich.

Bild-zu-Video Endpunkt:

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

Generiert ein Video ausgehend von einem hochgeladenen Quellbild mit einer Bewegungsaufforderung.

Beide Endpunkte akzeptieren ähnliche Request Bodies und geben dasselbe Antwortformat zurück. Wähle je nachdem, ob du ein Quellbild zum Animieren hast.

Authentifizierung

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

Authorization: Bearer YOUR_API_KEY

Schlüssel sind an dein Konto gebunden und werden von deinem Kreditguthaben abgezogen. 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): Die Textaufforderung, die das gewünschte Video beschreibt.
• duration (erforderlich, Integer): Clip-Länge in Sekunden. Bereich: 4-15.
• aspect_ratio (erforderlich, String): Eine 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): Bewegungsaufforderung, die beschreibt, wie das Bild animiert werden soll.
• duration (erforderlich, Integer): Clip-Länge in Sekunden. Bereich: 4-15.
• aspect_ratio (erforderlich, String): Sollte dem Seitenverhältnis des Quellbilds entsprechen für beste Ergebnisse.

Antwortformat

Beide Endpunkte geben eine Async Job ID zurück:

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

Frage den Status-Endpunkt ab, 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
}

Lade die video_url herunter und du hast dein MP4.

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

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

  // 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'
);

Bereit, auf der API zu bauen? Holen Sie sich Ihren API-Schlüssel →

Preisgestaltung pro API-Aufruf

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

Credits verfallen nicht. Kaufe in Großmengen über die Credit-Stufen für bessere Pro-Aufruf-Ökonomie - der Enterprise-Plan senkt die effektiven Kosten um ~17%.

Ratenbegrenzungen 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 Drosseln zu treffen. Enterprise-Tier-Konten können höhere Parallelität anfordern.

Einzelne Generierungsjobs dauern 30-150 Sekunden je nach Dauer. Mit 5 gleichzeitigen Jobs kannst du effektiv etwa alle 15-30 Sekunden Wanduhrenzeit einen Clip produzieren.

Für Massen-Batch-Generierung (50+ Clips) reiche in Wellen von 5-10 ein, warte auf Fertigstellung, dann reiche die nächste Welle ein. Überflute die API nicht mit hunderten gleichzeitiger Anfragen.

Fehlerbehandlung

Häufige Fehlerantworten:

400 Bad Request: Ungültige Parameter. Überprüfe den Dauernbereich, Seitenverhältnisswerte, Aufforderungslänge.

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

402 Payment Required: Unzureichende Credits. Läde über das Dashboard auf.

429 Too Many Requests: Ratenbegrenzung überschritten. Warte und versuche erneut.

500 Internal Server Error: Temporäres Serverproblem. Versuche mit exponentiellem Backoff erneut.

Baue deine Integration auf, um 429 und 500 anmutig mit Wiederholungslogik zu behandeln. Ein einfacher exponentieller Backoff (1s, 2s, 4s, 8s) deckt die meisten transienten Fehler ab.

Fast vs. Standard im API-Kontext

Die Wahl zwischen Fast- und Standard-API-Endpunkten ist hauptsächlich wirtschaftlich:

• Verwende Fast für Massen-programmgesteuerte Generierung, kostensensitive Apps und alles, das kein Hero-Clip ist.
• Verwende Standard für Flaggschiff-Inhalte, bei denen der kleine Qualitätsvorteil die 20% Kostenprämie rechtfertigt.

Die meisten Apps verwenden standardmäßig Fast. Der Standard-Endpunkt ist normalerweise 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

Für lange laufende Jobs ist Abfragen verschwenderisch. Die Seedance 2.0 Fast API unterstützt Webhook-Callbacks. Füge eine webhook_url in deinen Request Body ein 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 erhält dieselbe JSON-Payload, die der Status-Endpunkt bei Fertigstellung zurückgeben würde. Implementiere Idempotenz - Webhooks können bei Fehlschlag wiederholt werden.

Häufige Fragen, schnelle Antworten

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

Werden Credits bei fehlgeschlagenen Jobs abgezogen? Nein. Fehlgeschlagene Jobs erstatten die Credits automatisch.

Kann ich einen laufenden Job stornieren? Ja, über POST /api/v1/jobs/{job_id}/cancel. Erstattet Credits, wenn vor Fertigstellung storniert.

Welches Dateiformat hat die Ausgabe? MP4, H.264 Video, AAC Audio, 720p Auflösung.

Wie lange bleiben Ausgabe-URLs gültig? Ausgabe CDN-URLs sind 7 Tage gültig. Lade sie herunter und speichere sie in deinem eigenen System für langfristige Nutzung.

Gibt es einen Sandbox-/Testmodus? Kein dedizierter Sandbox. Verwende deine kostenlosen 50 Anmelde-Credits zum Testen. Der $10 Starter-Plan ist auch eine risikoarme Möglichkeit, gegen echte Endpunkte zu bauen.

Fang an, auf der Seedance 2.0 Fast API zu bauen

Die API ist bewusst einfach: zwei Endpunkte, deterministische Preisgestaltung, Async-Job-Modell, und eine Qualitätsobergrenze, die dem Flaggschiff-Seedance 2.0-Tier entspricht. Baue darauf für soziale Tools, Marketing-Automatisierung, Creator-Plattformen, E-Commerce-Content-Engines oder interne Kreativ-Apps. Die Einheitenökonomie macht Videogenerierung endlich als Feature in anderen Produkten umsetzbar.

Bereit zu bauen? Holen Sie sich Ihren API-Schlüssel →

Weiterlesen: Seedance 2.0 Fast vollständige Anleitung • Seedance 2.0 Fast Preisgestaltung • Seedance 2.0 Fast Batch-Erstellung