Die ClipMixAI Developer-API ist ab sofort verfügbar

Heute öffnen wir die Motoren, die die ClipMixAI-Web-App antreiben, für alle, die darauf aufbauen möchten. Die neue Developer-API unter api.clipmixai.com/api/v1 stellt vier Dienste bereit – Videoübersetzung, Memory-Video, Faceswap & Avatare sowie KI-Musik – über eine einzige Bearer-Token-REST-Schnittstelle. Dieselben Modelle, dieselbe Qualität, dieselben Credits. Kein Abonnement erforderlich. Kein Minimum.

Wer den Artikel überspringen möchte: /api bietet die Marketing-Übersicht, /api/docs enthält die Referenzdokumentation, und unter /dashboard/api-keys können Sie Ihren ersten Schlüssel erstellen.

Warum wir das gebaut haben

Im vergangenen Jahr haben wir beobachtet, wie zahlende Nutzer immer wieder dasselbe getan haben: das Dashboard öffnen, 30 Fotos hochladen, auf „Erstellen" klicken, auf den Song warten, das Ergebnis manuell in ein separates Bearbeitungstool schieben. Wir hatten Gründer, die Creator-Inhalte in 10 Sprachen übersetzten, Agenturen, die 100 Markenwerbespots pro Woche produzierten, und Indie-Game-Studios, die Platzhaltermusik für Prototypen generierten. Jeder von ihnen stellte irgendwann dieselbe Frage: „Gibt es eine API?"

Jetzt gibt es eine. Die vier Dienste, die all diese Workflows angetrieben haben, sind jetzt direkt aus Ihrem Code abrufbar – ohne das Dashboard als Zwischenschritt, ohne dass Sie die Eigenheiten jedes Anbieters kennen müssen, und mit demselben Credit-Preismodell, das Sie bereits aus der Web-App kennen. Wenn ein Workflow, der früher eine Stunde gedauert hat, nun im Hintergrund per CRON-Job läuft, ist das der Gewinn.

Schnellstart

Erstellen Sie einen Schlüssel im Dashboard, dann:

curl -X POST https://api.clipmixai.com/api/v1/music \
  -H "Authorization: Bearer sk_live_..." \
  -H "Idempotency-Key: my-fresh-key-1" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt":   "Uplifting synthwave with female vocals",
    "lyrics":   "[verse]\nRunning through neon lights...",
    "duration_seconds": 60
  }'

Sie erhalten sofort eine job-id mit status: "processing". Sie können GET /v1/music/{id} abfragen, bis der Status auf completed wechselt – oder besser: Verknüpfen Sie beim Erstellen Ihres Schlüssels einen Webhook damit, und wir senden das fertige Ergebnis per POST an Ihren Endpunkt, signiert mit HMAC-SHA256, damit Sie prüfen können, dass es von uns stammt.

Drei Dinge, die Entwickler sich gewünscht haben – und die wir nun liefern

1. Sandbox-Keys

Jeder API-Schlüssel hat einen Modus: sk_live_ belastet Credits und ruft echte Anbieter auf; sk_test_ verursacht keine Kosten, ruft keinen Anbieter auf und gibt einen synthetischen completed-Job mit test: true im Body zurück. Verwenden Sie Sandbox-Keys in CI, um Ihre Integration zu testen, ohne Credits zu verbrauchen, und wechseln Sie zu Live-Keys, wenn Sie tatsächlich Output erzeugen möchten.

Sandbox-Keys sind für alle kostenlos – auch für Free-Tier-Konten. Die einzige Voraussetzung für die Nutzung eines Live-Keys ist ein vorangegangener Credit-Kauf, der die API hinter demselben Zahlungssignal wie die Web-App absichert.

2. Idempotency-Key bei jedem POST

Netzwerk-Wiederholungsversuche sind das Ärgernis jeder abrechnungssensiblen API. Wir haben die Lösung von Stripe übernommen: Übergeben Sie Idempotency-Key: <your-string> bei jedem Create-Aufruf, und der Server speichert die Antwort für 24 Stunden. Eine Wiederholung mit demselben Schlüssel und demselben Body gibt die ursprüngliche Antwort zurück – keine doppelte Abrechnung. Eine Wiederholung mit demselben Schlüssel, aber einem anderen Body gibt 422 idempotency_key_reuse zurück, damit Sie den Fehler finden, anstatt still einen falschen Job zu erzeugen.

Beide offiziellen SDKs bieten dafür ein einzelnes Schlüsselwortargument:

# Python
c.music.create(prompt=..., lyrics=..., idempotency_key="order-42")

// JS
await c.music.create({ prompt, lyrics, idempotencyKey: "order-42" });

3. Webhooks mit Test-Auslöse-Schaltfläche

Konfigurieren Sie eine Callback-URL für Ihren Schlüssel, und wir senden job.completed- / job.failed-Ereignisse per POST, sobald Jobs abgeschlossen sind. Jede Lieferung enthält eine HMAC-Signatur in X-ClipMix-Signature: sha256=<hex> – verifizieren Sie diese mit einer Hilfsfunktion aus einem der SDKs. Fehlgeschlagene Lieferungen werden mit exponentiellem Backoff wiederholt (0s → 30s → 5m → 1h, insgesamt vier Versuche).

Das Dashboard verfügt über eine Test auslösen-Schaltfläche, die ein synthetisches webhook.test-Ereignis sendet, damit Sie Signatur und Parsing Ihres Endpunkts überprüfen können, ohne auf einen echten Job warten zu müssen. Dasselbe Panel zeigt pro Schlüssel ein Lieferungsprotokoll mit 100 Einträgen – wenn etwas schiefläuft, müssen Sie nicht raten, wo der Fehler aufgetreten ist.

Drei Anwendungsfälle, die wir bereits sehen

Massenhafte Videoübersetzung für Creator

Laden Sie ein Video hoch und erhalten Sie 10 synchronisierte Versionen in 10 Sprachen – mit optionalem Voice-Cloning, das den Tonfall des Sprechers bewahrt. Ein YouTube-Creator übersetzt seinen wöchentlichen Podcast vollautomatisch in 9 Sprachen: Der API-Aufruf wird durch seinen bestehenden Veröffentlichungs-Hook ausgelöst, und der Webhook legt die synchronisierte Datei direkt ins CMS.

Personalisierte Markenvideos für jeden Kunden

Die Foto-zu-Video-Memory-Ausgabe ermöglicht es einem Online-Shop, das Produktfoto eines Kunden zu nehmen und eine kurze, cinematische Werbeanzeige zu generieren, die auf dieses Angebot zugeschnitten ist. Der family-videos-Endpunkt stellt die vier Modi (Moment, Story, Album, Chronicle) bereit, die wir für unsere Consumer-Oberfläche entwickelt haben; Agenturen nutzen sie als Motor in White-Label-Tools.

Spielaudio-Prototyping

Indie-Studios rufen den /v1/music-Endpunkt direkt aus ihrer internen Asset-Pipeline auf. Ein Game-Designer tippt eine Stimmung und einen kurzen Platzhaltertext, und zehn Minuten später liegt ein 60-sekündiger Track im Audio-Ordner des Projekts. Sie iterieren Platzhaltermusik in Sekunden, anstatt für jede Variation auf einen Sound-Designer warten zu müssen.

Versionierung und unsere Zusagen

v1 ist stabil. Wir werden keine Breaking Changes innerhalb von /api/v1/ einführen – neue Felder und Endpunkte werden nur additiv hinzugefügt, und die bestehende Schnittstelle bleibt unverändert. Was wir tatsächlich brechen müssen (selten), wird unter /api/v2/ mit einer angekündigten Übergangsphase ausgeliefert. Das Changelog ist die maßgebliche Informationsquelle.

Der Betriebsstatus ist live unter /api/status einsehbar – ein dienstweiser Gesundheitsstatus, der aus den letzten 5 Minuten des echten Datenverkehrs abgeleitet wird. Er aktualisiert sich alle 60 Sekunden und entspricht der Ansicht, die unser Bereitschaftsteam sieht.

Preise

Dasselbe Guthaben wie die Web-App. $1 = 100 Credits, mit den bestehenden Mengenrabatten beim Aufladen. Ein 60-sekündiger Song kostet 60 Credits ($0,60). Ein 30-sekündiger Talking-Head-Avatar kostet 450 Credits im Balanced-Tier. Die Übersetzung eines 1-minütigen Videos im Premium-Tier kostet ~190 Credits. Sandbox-Keys sind kostenlos.

Gestaffelte API-Pläne (Pro / Business / Enterprise) mit Mengenrabatten und priorisierten Worker-Instanzen sind in Planung. Wer schon heute davon profitieren möchte, kann seine E-Mail-Adresse unter /contact?topic=api-tiers hinterlassen – wir melden uns, sobald sie verfügbar sind.

Jetzt ausprobieren

• /api – fünfminütige Kurzübersicht
• /api/docs – Referenz (Auth, Idempotenz, Webhooks, Sandbox, Fehler, SDKs)
• /api/status – Live-Servicestatus
• /api/changelog – Was neu ist, was kommt
• /dashboard/api-keys – Ersten Schlüssel erstellen

Fehlerberichte und Funktionswünsche: GitHub Issues. Alles andere: support@clipmixai.com.