Seedance 1.0 Lite API: Schneller Endpunkt zur Videogenerierung

Ein einzelner POST-Request, 30-60 Sekunden Wartezeit, und du erhältst ein 1080p MP4 zurück. Das ist die gesamte Seedance 1.0 Lite API. Für Entwickler, die automatisierte Video-Workflows aufbauen, sei es für E-Commerce-Produktanimationen, Ad-Creative-Pipelines oder Content-Generierungssysteme, ist dies der Integrationsleitfaden.

Warum Entwickler die API integrieren

Die UI-Version von Seedance 1.0 Lite ist ideal für die manuelle Generierung. Die API ermöglicht Workflows, die manuell nicht umsetzbar sind:

• Automatisierte Kataloganimation - eine Generierung für jede neu hinzugefügte SKU in deinem E-Commerce-Backend auslösen
• Ad-Creative-Pipelines - Varianten nach einem Zeitplan generieren und über deren APIs an Werbeplattformen übertragen
• Content-Generierungssysteme - CMS-Bilder in Arteza einspeisen und animierte Versionen zurückerhalten
• Echtzeit-Workflows für nutzergenerierte Inhalte - eigenen Nutzern ermöglichen, ein Bild hochzuladen und eine animierte Version zu erhalten
• Batch-Jobs - hunderte von Quellbildern über Nacht verarbeiten

Zu $0,20-$1,00 pro Aufruf und 30-60 Sekunden Durchlaufzeit kannst du produktionsreife Videoautomatisierung aufbauen, die vor 18 Monaten wirtschaftlich noch undenkbar gewesen wäre.

API-Zugang erhalten

1. Registrieren auf die Plattform - 10 kostenlose Credits werden sofort gutgeschrieben
2. Zu den API-Einstellungen im Dashboard navigieren
3. API-Schlüssel generieren - sicher speichern (niemals ins Git committen)
4. Optional: Einen Monatsplan bei die Preisseite wählen - 5, 25, 50 oder 120 Dollar

Deine 10 kostenlosen Credits funktionieren auch für API-Aufrufe. Du kannst die vollständige Integration validieren, bevor du etwas bezahlst.

Das Request-Modell

Die zentrale Interaktion ist ein einzelner POST an den Seedance 1.0 Lite Generierungsendpunkt.

Erforderliche Parameter

Optionale Parameter

Antwortmodell

Die API gibt eine Job-ID und einen Status zurück. Die Generierung ist asynchron, pollen auf Abschluss oder einen Webhook verwenden.

{
  "job_id": "sd1lite_abc123xyz",
  "status": "processing",
  "credits_charged": 42,
  "estimated_time_seconds": 45,
  "created_at": "2026-04-10T12:00:00Z"
}

Nach Abschluss:

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

Authentifizierung

Alle Requests verwenden Bearer-Token-Authentifizierung über den Authorization-Header:

Authorization: Bearer YOUR_API_KEY

API-Schlüssel sind mit deinem Konto verknüpft und werden gegen dein Credit-Guthaben belastet. Schlüssel über das Dashboard rotieren, wenn du einen Verdacht auf einen Leak hast.

Codebeispiel: Python

Hier ist eine minimale Python-Integration, die einen Job einreicht, auf Abschluss pollt und das Ergebnis herunterlädt.

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"):
    # Job einreichen
    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"]
    
    # Auf Abschluss pollen
    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"Generierung fehlgeschlagen: {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 bereit: {video_url}")

Codebeispiel: 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') {
  // Job einreichen
  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}` },
    }
  );

  // Auf Abschluss pollen
  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 bereit:', url));

Webhook-Muster (für Produktion empfohlen)

Polling funktioniert, aber Webhooks sind bei größerem Umfang eleganter. Übergib eine webhook_url in deinem Generierungsrequest, und die API sendet per POST die Abschluss-Payload, wenn der Job fertig ist.

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

Dein Webhook-Handler empfängt dasselbe Abschluss-JSON wie der Polling-Endpunkt. Kein Polling-Loop erforderlich.

Willst du das selbst erstellen? Seedance 1.0 Lite kostenlos testen →

Bereit, Seedance 1.0 Lite auszuprobieren? Kostenlos loslegen →

Rate-Limits und Parallelität

Für höhere Parallelität oder größeres Volumen den Support kontaktieren. Die Plattform kann auf dedizierten Setups Batch-Workloads von über 10.000 Jobs pro Tag verarbeiten.

Fehlerbehandlung

Standard-HTTP-Statuscodes gelten:

Für Produktionsintegrationen immer folgendes implementieren:

• Exponentielles Backoff bei 429- und 500-Fehlern
• Credit-Guthaben prüfen vor großen Batch-Läufen
• Webhook-Signaturvalidierung bei Verwendung von Webhooks
• Idempotenz-Schlüssel um doppelte Abbuchungen bei Netzwerkfehlern zu verhindern

Kostenmanagement in der Produktion

Jeder Aufruf belastet Credits nach Dauer: 2 Credits für einen 2-3-Sekunden-Clip, ansteigend auf 7 Credits bei 12 Sekunden.

Tipps zur Kostenkontrolle in der Produktion:

• Prompts bei 2 Sekunden testen, bevor du dich auf 12-Sekunden-Batch-Läufe festlegst
• Monatliches Credit-Budget festlegen und den Code stoppen lassen, wenn es erreicht ist
• Das Feld credits_charged in jeder Antwort überwachen, um die Ausgaben pro Workflow zu verfolgen
• Webhooks verwenden, um keine Zeit mit Polling zu verschwenden
• Erfolgreiche Ergebnisse cachen, wenn möglich, damit identische Requests nicht neu generiert werden

Konkrete Integrationsmuster

E-Commerce-Kataloganimation

Einen Seedance 1.0 Lite Job auslösen, jedes Mal wenn eine neue SKU zum Katalog hinzugefügt wird. Die resultierende MP4-URL in die Produktdatenbank schreiben. Automatisch auf Produktdetailseiten anzeigen.

Ad-Creative-Pipeline

Ein täglicher Cron-Job generiert 10 neue Ad-Varianten aus verschiedenen Quellbildern. Überträgt MP4s direkt über die Meta Ads API als neue Creatives. Schließt die Schleife zwischen Content-Generierung und Ad-Auslieferung.

Apps für nutzergenerierte Inhalte

Nutzern erlauben, ein Foto in deiner App hochzuladen. Dein Backend ruft Seedance 1.0 Lite mit einem vorlagenbasierten Prompt auf. Die animierte Version wird dem Nutzer in unter einer Minute zurückgegeben. Nutzer so belasten, dass die API-Kosten von ca. 0,20 Dollar mit gesunder Marge gedeckt sind.

CMS-Erweiterung

Eine Verbindung ins CMS einrichten, sodass für jedes neue Featured Image automatisch eine animierte Seedance 1.0 Lite Version generiert wird. Beide Versionen speichern, die statische als Fallback, die animierte für Hero-Platzierungen.

Batch-Katalog-Aktualisierung

Ein nächtlicher Job regeneriert animierte Versionen der 500 meistverkauften Produkte mit saisonalen Motion-Prompts. Frische Creatives ohne manuellen Eingriff.

Upgrade auf Pro oder 2.0 über die API

Wenn ein bestimmter Job Premium-Qualität benötigt, Endpunkt wechseln:

• /seedance-1-lite/generate - $0,20-$1,00, schnell, das Arbeitstier für großes Volumen
• /seedance-1-pro/generate - $0,20-$1,00, Premium-Bewegung, Endframe-Kontrolle
• /seedance-2.0/generate - 1,20-4,40 Dollar, Kinoqualität und nativer Ton

Gleicher API-Schlüssel, gleicher Credit-Pool, gleiche Authentifizierung. Modell wechseln, indem ein anderer Endpunkt aufgerufen wird. Unter der Pro-Vergleichsleitfaden nachlesen, wann ein Upgrade sinnvoll ist.

Jetzt mit der Integration beginnen

Registrieren, API-Schlüssel aus dem Dashboard holen und den ersten Aufruf mit den 10 kostenlosen Credits machen. Das Python-Beispiel oben läuft in etwa 45 Sekunden komplett durch und liefert ein funktionierendes Integrationsmuster zum Weiterentwickeln.

API-Schlüssel kostenlos holen → - 10 Credits bei der Anmeldung, keine Kreditkarte erforderlich, produktionsreife Integration in unter einer Stunde.