Seedance 1.0 Lite API: Endpoint für schnelle Videogenerierung

Eine einzelne POST-Anfrage, eine Wartezeit von 30-60 Sekunden, und Sie erhalten ein 1080p MP4 zurück. Das ist die gesamte Seedance 1.0 Lite API. Für Entwickler, die automatisierte Video-Workflows erstellen, egal ob es um E-Commerce-Produktanimationen, Werbekreativ-Pipelines oder Content-Generierungssysteme geht, ist dies der Integrationsleitfaden.

Zusammenfassung

• Single POST Endpoint nimmt Bild + Motion Prompt entgegen und gibt ein 1080p MP4 zurück
• Asynchrones Job-Modell: Anfrage einreichen, auf Fertigstellung abfragen, Ergebnis herunterladen
• Kosten pro Aufruf: $0,14-$0,84 basierend auf Dauer (2-12 Sekunden)
• Typische End-to-End-Latenz: 30-60 Sekunden
• 50 kostenlose Credits bei Anmeldung, ausreichend um die Integration zu validieren, bevor man sich verpflichtet
• Derselbe Credit-Pool funktioniert über alle Arteza und Seedream Modelle

Warum Entwickler die API integrieren

Die UI-Version von Seedance 1.0 Lite ist großartig für manuelle Generierung. Die API erschließt die Workflows, die manuelle Nutzung nicht unterstützen kann:

• Automatisierte Kataloganimation - löse eine Generierung für jede neue SKU aus, die zu Ihrem E-Commerce-Backend hinzugefügt wird
• Werbekreativ-Pipelines - generiere Varianten nach einem Zeitplan und schiebe diese über deren APIs zu Werbeplattformen
• Content-Generierungssysteme - füttere CMS-Bilder in Arteza ein und erhalte animierte Versionen zurück
• Workflows mit benutzergenerierten Inhalten in Echtzeit - ermögliche deinen Benutzern, ein Bild hochzuladen und eine animierte Version zu erhalten
• Batch-Jobs - verarbeite über Nacht Hunderte von Quellbildern

Bei $0,14-$0,84 pro Aufruf und 30-60 Sekunden Durchsatz kannst du produktionsreife Video-Automation aufbauen, die vor 18 Monaten wirtschaftlich unmöglich gewesen wäre.

Zugang zur API erhalten

1. Melde dich an auf die Plattform - 50 kostenlose Credits kommen sofort an
2. Navigiere zu den API-Einstellungen in deinem Dashboard
3. Generiere einen API-Schlüssel - speichere ihn sicher (niemals in Git committen)
4. Optional: Kaufe ein Credit-Paket auf die Preisseite - $10, $25, $50 oder $100

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

Das Request-Modell

Die Kerninteraktion ist ein einzelner POST zum Seedance 1.0 Lite Generierungsendpunkt.

Erforderliche Parameter

Optionale Parameter

Response-Modell

Die API gibt eine Job-ID und einen Status zurück. Generierung ist asynchron, frage auf Fertigstellung ab oder verwende einen Webhook.

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

Bei Fertigstellung:

{
  "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 Anfragen verwenden Bearer-Token-Authentifizierung über den Authorization Header:

Authorization: Bearer YOUR_API_KEY

API-Schlüssel sind an dein Konto gebunden und belasten deinen Kreditsaldo. Rotiere Schlüssel über das Dashboard, falls du einen Leck vermutest.

Code-Beispiel: Python

Hier ist eine minimale Python-Integration, die einen Job einreicht, auf Fertigstellung abfragt 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"):
    # Reiche den Job ein
    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"]
    
    # Frage auf Fertigstellung ab
    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 ready: {video_url}")

Code-Beispiel: 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') {
  // Reiche den Job ein
  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}` },
    }
  );

  // Frage auf Fertigstellung ab
  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 ready:', url));

Webhook-Muster (empfohlen für Production)

Polling funktioniert, aber Webhooks sind sauberer im großen Maßstab. Übergebe eine webhook_url in deiner Generierungsanfrage und die API POSTet die Fertigstellungsnutzlast, wenn der Job beendet 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 erhält dieselbe Fertigstellungs-JSON wie der Polling-Endpunkt. Keine Polling-Schleife erforderlich.

Möchtest du das selbst machen? Seedance 1.0 Lite kostenlos testen →

Bereit, Seedance 1.0 Lite auszuprobieren? Kostenlos mit der Erstellung beginnen →

Rate Limits und Gleichzeitigkeit

Für höhere Gleichzeitigkeit oder Volumen wende dich an den Support. Die Plattform kann Batch-Workloads von über 10.000 Jobs pro Tag auf dedizierten Setups unterstützen.

Fehlerbehandlung

Standard HTTP-Statuscodes gelten:

Für Production-Integrationen immer implementieren:

• Exponentieller Backoff für 429 und 500 Fehler
• Credit-Saldo-Überprüfungen vor großen Batch-Läufen
• Webhook-Signaturvalidierung bei Verwendung von Webhooks
• Idempotency Keys um doppelte Gebühren bei Netzwerkfehlern zu vermeiden

Kostenmanagement in Production

Jeder Aufruf belastet Credits zum Standardsatz: 7 Credits pro Sekunde Video.

Tipps zur Kostenkontrolle in Production:

• Teste Prompts bei 2 Sekunden bevor du dich zu 12-Sekunden-Batch-Läufen verpflichtest
• Lege ein monatliches Credit-Budget fest und halte deinen Code an, wenn es erreicht ist
• Überwache das Feld credits_charged in jeder Response, um die Ausgaben pro Workflow nachzuverfolgen
• Verwende Webhooks um Zeit beim Polling zu sparen
• Cache erfolgreiche Ergebnisse wo möglich, damit identische Anfragen nicht neu generiert werden

Echte Integrationsmuster

E-Commerce-Kataloganimation

Löse einen Seedance 1.0 Lite Job aus, jedes Mal wenn eine neue SKU zu deinem Katalog hinzugefügt wird. Schreibe die resultierende MP4-URL in deine Produktdatenbank. Zeige sie auf PDPs automatisch an.

Werbekreativ-Pipeline

Täglicher Cron-Job generiert 10 neue Werbe-Varianten aus verschiedenen Quellbildern. Pusht MP4s direkt zur Meta Ads API als neue Creatives. Schließt die Schleife zwischen Content-Generierung und Ad-Delivery.

Benutzergenierte-Content-Apps

Lasse Benutzer ein Foto in deiner App hochladen. Dein Backend ruft Seedance 1.0 Lite mit einem vorlagisierten Prompt auf. Gebe die animierte Version innerhalb einer Minute an den Benutzer zurück. Berechne Benutzer genug um die ~$0,30 API-Kosten mit gesundem Gewinn zu decken.

CMS-Verbesserung

Verbinde dein CMS so, dass jedes neue Feature-Bild automatisch eine Seedance 1.0 Lite animierte Version generiert bekommt. Speichere beide Versionen, statisch als Fallback, animiert für Hero-Placements.

Batch-Katalog-Aktualisierung

Nächtlicher Job regeneriert animierte Versionen deiner Top 500 Produkte mit saisonalen Motion-Prompts. Frischer Creative ohne menschliche Eingriffe.

Upgrade auf Pro oder 2.0 über die API

Wenn ein spezifischer Job Premium-Qualität braucht, wechsle Endpunkte:

• /seedance-1-lite/generate - $0,14-$0,84, schnell, Volumen-Workhorse
• /seedance-1-pro/generate - $0,48-$2,88, Premium-Motion, End-Frame-Kontrolle
• /seedance-2.0/generate - $2,43-$9,10, Kino-Qualität + natives Audio

Derselbe API-Schlüssel, derselbe Credit-Pool, dieselbe Auth. Wechsle Modelle durch Aufrufen eines anderen Endpunkts. Siehe der Pro-Vergleichsleitfaden für wann du upgraden solltest.

Starte heute mit der Integration

Melde dich an, hole dir deinen API-Schlüssel aus dem Dashboard und mache deinen ersten Aufruf mit den 50 kostenlosen Credits. Das Python-Beispiel oben läuft end-to-end in etwa 45 Sekunden und gibt dir ein funktionierendes Integrationsmuster zum Aufbauen.

Holen Sie sich Ihren API-Schlüssel kostenlos → - 50 Credits bei Anmeldung, keine Karte erforderlich, Production-reife Integration in unter einer Stunde.