Seedance 1.0 Pro API: Professioneller Video-Generierungs-Endpunkt

Wenn Sie Video in ein Produkt, einen Workflow oder eine Pipeline integrieren, wird die Web-UI letztendlich zum Engpass. Die Seedance 1.0 Pro API ist das gleiche Modell hinter der UI, verfügbar als sauberer REST-Endpunkt mit Bearer-Token-Authentifizierung, vorhersehbarem Pro-Sekunde-Pricing und einfachem Job-Polling. Diese Anleitung behandelt alles, was Sie für den produktiven Betrieb benötigen.

Was die API leistet

Alles, was die Seedance 1.0 Pro Web-UI bietet, ist programmatisch verfügbar:

• Bild-zu-Video-Erzeugung mit einer Quellbild-URL
• Motion-Prompt um die Animation zu steuern
• Dauer-Kontrolle von 2 bis 12 Sekunden
• End-Frame-Kontrolle für gerichtete Übergänge
• Kamera-Lock Toggle
• Job-Polling für Status und Ergebnis-URL
• MP4-Ausgabe in nativer 1080p

Verwenden Sie es für SaaS-Produkte, die eingebettete Videoerzeugung benötigen, interne Agentur-Pipelines, Batch-Produktions-Workflows oder Automatisierung wiederholter Video-Aufgaben.

Authentifizierung

Alle API-Aufrufe authentifizieren sich mit einem Bearer-Token. Generieren Sie einen aus Ihrem Arteza-Account-Dashboard auf arteza.ai.

Authorization: Bearer YOUR_API_KEY

Sicherheitsregeln:

• Commiten Sie API-Keys niemals in Source Control
• Rotieren Sie Keys regelmäßig
• Verwenden Sie Umgebungsvariablen oder einen Secrets Manager
• Beschränken Sie Keys auf bestimmte Herkunftsserver, wenn möglich

Die Kern-Endpunkte

Einen Erzeugungsjob einreichen

POST /v1/seedance-1-pro/generate

Request-Body:

{
  "source_image_url": "https://your-cdn.com/source.jpg",
  "prompt": "Slow camera push-in on the subject, warm golden hour light, shallow depth of field",
  "duration_seconds": 6,
  "camera_lock": false,
  "end_frame_url": null
}

Parameter:

Response:

{
  "job_id": "job_abc123xyz",
  "status": "queued",
  "created_at": "2026-04-10T12:00:00Z",
  "estimated_seconds": 90
}

Jobstatus prüfen

GET /v1/seedance-1-pro/status/{job_id}

Response (läuft):

{
  "job_id": "job_abc123xyz",
  "status": "processing",
  "progress": 0.45,
  "created_at": "2026-04-10T12:00:00Z"
}

Response (abgeschlossen):

{
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "resolution": "1920x1080",
  "credits_charged": 144
}

Mögliche Status-Werte: queued, processing, completed, failed

Ergebnis herunterladen

Sobald der Status completed ist, zeigt video_url auf eine 1080p MP4-Datei. Laden Sie sie sofort herunter und speichern Sie sie in Ihrer eigenen Infrastruktur, verlassen Sie sich nicht darauf, dass die URL unbegrenzt gültig ist.

Ein vollständiges Python-Beispiel

import os
import time
import requests

API_KEY = os.environ["SEEDANCE_API_KEY"]
BASE_URL = "https://api.arteza.ai/v1/seedance-1-pro"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

def generate_video(source_image_url, prompt, duration=6, camera_lock=False, end_frame=None):
    payload = {
        "source_image_url": source_image_url,
        "prompt": prompt,
        "duration_seconds": duration,
        "camera_lock": camera_lock,
    }
    if end_frame:
        payload["end_frame_url"] = end_frame
    
    response = requests.post(f"{BASE_URL}/generate", headers=HEADERS, json=payload)
    response.raise_for_status()
    return response.json()["job_id"]

def wait_for_completion(job_id, poll_interval=5, timeout=300):
    start = time.time()
    while time.time() - start < timeout:
        r = requests.get(f"{BASE_URL}/status/{job_id}", headers=HEADERS)
        r.raise_for_status()
        data = r.json()
        
        if data["status"] == "completed":
            return data["video_url"]
        if data["status"] == "failed":
            raise RuntimeError(f"Job failed: {data.get('error', 'unknown')}")
        
        time.sleep(poll_interval)
    
    raise TimeoutError(f"Job {job_id} did not complete within {timeout}s")

def download_video(url, output_path):
    response = requests.get(url, stream=True)
    response.raise_for_status()
    with open(output_path, "wb") as f:
        for chunk in response.iter_content(chunk_size=8192):
            f.write(chunk)

# Use it
job_id = generate_video(
    source_image_url="https://example.com/product.jpg",
    prompt="Slow camera orbit around the product, studio lighting, 6 seconds",
    duration=6,
    camera_lock=True
)

video_url = wait_for_completion(job_id)
download_video(video_url, "output.mp4")
print(f"Video saved to output.mp4")

Ein vollständiges Node.js-Beispiel

import fs from 'fs';
import fetch from 'node-fetch';

const API_KEY = process.env.SEEDANCE_API_KEY;
const BASE_URL = 'https://api.arteza.ai/v1/seedance-1-pro';
const HEADERS = {
  'Authorization': `Bearer ${API_KEY}`,
  'Content-Type': 'application/json'
};

async function generateVideo(opts) {
  const response = await fetch(`${BASE_URL}/generate`, {
    method: 'POST',
    headers: HEADERS,
    body: JSON.stringify(opts)
  });
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  const data = await response.json();
  return data.job_id;
}

async function waitForCompletion(jobId, { pollInterval = 5000, timeout = 300000 } = {}) {
  const start = Date.now();
  while (Date.now() - start < timeout) {
    const r = await fetch(`${BASE_URL}/status/${jobId}`, { headers: HEADERS });
    const data = await r.json();
    if (data.status === 'completed') return data.video_url;
    if (data.status === 'failed') throw new Error(`Job failed: ${data.error}`);
    await new Promise(res => setTimeout(res, pollInterval));
  }
  throw new Error('Timeout');
}

async function downloadVideo(url, path) {
  const response = await fetch(url);
  const buffer = await response.buffer();
  fs.writeFileSync(path, buffer);
}

// Use it
const jobId = await generateVideo({
  source_image_url: 'https://example.com/product.jpg',
  prompt: 'Slow camera orbit around the product, studio lighting, 6 seconds',
  duration_seconds: 6,
  camera_lock: true
});

const videoUrl = await waitForCompletion(jobId);
await downloadVideo(videoUrl, 'output.mp4');
console.log('Saved output.mp4');

Möchten Sie Broadcast-Quality wie diese? Seedance 1.0 Pro kostenlos testen →

Preisgestaltung und Abrechnung

Tarif: $0,24 pro Sekunde Ausgabevideo (24 Credits/Sekunde)

Credits werden nur bei erfolgreichen Erzeugungen abgezogen. Fehlgeschlagene Jobs verbrauchen keine Credits.

Credit-Pakete sind die gleichen wie in der Web-UI: $10 / $25 / $50 / $100. Siehe Preisseite.

Rate Limits und Concurrency

Standard-Konten haben Rate Limits, die für typische Integrations-Workloads geeignet sind. Für hochvolumige Produktionsumgebungen kontaktieren Sie den Support, um höhere Limits zu erhalten.

Allgemeine Richtlinien:

• 5-10 gleichzeitige Jobs ist zuverlässig für die meisten Konten
• Exponential Backoff bei HTTP 429 Responses
• Job-Ebenen-Wiederholungen bei transienten Fehlern (bis zu 3 Versuche)
• Webhook-Callbacks sind verfügbar, um übermäßiges Polling zu vermeiden

Webhooks (Optional)

Anstelle von Polling registrieren Sie eine Webhook-URL in Ihren Kontoeinstellungen oder pro Anfrage. Wenn ein Job abgeschlossen ist, sendet Arteza einen POST an Ihre URL:

{
  "event": "job.completed",
  "job_id": "job_abc123xyz",
  "status": "completed",
  "video_url": "https://arteza.ai/videos/abc123xyz.mp4",
  "duration_seconds": 6,
  "credits_charged": 144,
  "timestamp": "2026-04-10T12:02:15Z"
}

Webhooks sind mit einer HMAC-Signatur im X-Seedance-Signature Header signiert. Überprüfen Sie vor dem Vertrauen in die Payload.

Fehlerbehandlung

Die API gibt Standard-HTTP-Statuscodes zurück:

Error Response Bodies enthalten ein error Feld mit einer benutzerfreundlichen Nachricht und ein code Feld zur programmgesteuerten Behandlung.

{
  "error": "Source image URL could not be fetched",
  "code": "source_image_unreachable"
}

Anforderungen an Eingabebilder

• Formate: PNG, JPEG, WebP
• Größe: bis zu 10 MB pro Bild
• Auflösung: mindestens 512x512, höher ist besser (1080p+ empfohlen)
• URL-Zugriff: muss öffentlich erreichbar sein von den Arteza-Servern (kein localhost, keine authentifizierte Zugriffe)

Für private Bilder laden Sie diese in eine signierte S3-URL, CloudFront oder ähnlich hoch und übergeben Sie die signierte URL in der Anfrage.

Best Practices

1. Speichern Sie Ausgaben in Ihrer eigenen Infrastruktur. Verlassen Sie sich nicht langfristig auf Arteza URLs.
2. Protokollieren Sie alles. Job IDs, Prompts, Timings, Statusübergänge, Fehler.
3. Wiederholen Sie transiente Fehler. Netzwerk-Macken und 5xx Responses sollten mit exponentiellem Backoff wiederholt werden.
4. Validieren Sie Eingaben früh. Überprüfen Sie Bild-URLs und Parameterbereiche vor dem Einreichen.
5. Überwachen Sie Guthaben. Warnen Sie, wenn Sie unter eine Schwelle fallen.
6. Verwenden Sie Webhooks für Produktion. Polling ist für kleine Workloads gut, aber ineffizient in großem Maßstab.
7. Cache identische Erzeugungen. Wenn ein Benutzer zweimal das gleiche Bild + Prompt einreicht, geben Sie die gecachte URL zurück.

Test und Staging

Beginnen Sie jede Integration mit dem $10 Credit-Tier (1.050 Credits). Das ist genug für dutzende von Test-Generierungen. Erstellen und testen Sie Ihre Integration end-to-end, bevor Sie sich zu höheren Volume-Tiers verpflichten.

Use Cases

• SaaS-Plattformen - ermöglichen Sie Ihren Benutzern, Video aus ihren eigenen Assets zu erzeugen
• E-Commerce - erzeugen Sie Produkt-Bewegungsvideos aus Katalog-Bildern
• Immobilien - automatisieren Sie Video-Produktion für Inserate aus Fotos
• Marketing-Automatisierung - personalisiertes Video in großem Maßstab
• Content-Plattformen - bereichern Sie Artikel, Inserate oder Social Posts mit generiertem Video
• White-Label-Video-Tools - erstellen Sie Ihr eigenes AI-Video-Produkt auf dem Arteza-Backend

Weiterführende Lektüre

• Batch-Processing-Workflows
• Seedance 1.0 Pro, Vollständiger Leitfaden
• Seedance 1.0 Pro für Agenturen
• Seedance 2.0 API-Leitfaden

Häufig gestellte Fragen

Kann ich die API für kommerzielle Anwendungen nutzen? Ja, der gesamte Output ist freigegeben für kommerzielle Nutzung.

Was passiert, wenn die Erzeugung fehlschlägt? Bei fehlgeschlagenen Erzeugungen werden keine Credits abgezogen.

Wie lange werden erzeugte Videos gehostet? Videos sind nach der Erzeugung für ein Zeitfenster zum Herunterladen verfügbar. Laden Sie umgehend herunter und speichern Sie.

Unterstützen Sie SDK-Bibliotheken? Community SDKs für Python und Node sind verfügbar. Siehe die Developer Docs auf arteza.ai.

Kann ich einen laufenden Job abbrechen? Ja, senden Sie DELETE /v1/seedance-1-pro/jobs/{job_id}. Credits werden nicht bei abgebrochenen Jobs abgezogen.

Wie erhalte ich Support? Mailen Sie den Support über Ihr Account-Dashboard für API-spezifische Probleme.

---

Die Seedance 1.0 Pro API ist der produktionsreife Weg zur Integration von 1080p AI-Videoerzeugung in Ihr Produkt oder Ihre Pipeline.

Hol dir deinen API-Schlüssel und starte mit dem Aufbau → mit 50 kostenlose Credits beim Signup enthalten.