API-Referenz

Was die API ist

Mit der MyDreamVid-API kann deine eigene Software Videos und Bilder mit den Seedance- und Seedream-Modellen generieren, ohne dass sich jemand durchs Studio klickt. Dein Programm sendet einen Prompt (und optional Referenzdateien), wir führen dieselben Sicherheitsprüfungen und dieselben Preise wie im Web-Studio aus, und dein Programm holt die fertige Datei ab. Credits werden vom selben Kontoguthaben abgebucht.

Für wen sie ist

• Teams, die in großen Mengen generieren: Produktkataloge, Anzeigenvarianten, Social-Clips, lokalisierte Versionen eines Videos.
• Entwickler, die Video- oder Bildgenerierung in ihre eigene App, ihr Tool, ihren Bot oder ihre interne Pipeline einbauen.
• Agenturen und Studios, die ihr eigenes Frontend wollen, während wir Modelle, Warteschlangen und Abrechnung übernehmen.

Wenn du ein paar Videos pro Woche von Hand machst, brauchst du die API nicht. Das Studio kann alles, was die API kann, zu denselben Preisen.

Authentifizierung

Jede Anfrage trägt einen Bearer-Key. Keys werden im Studio erstellt und nur einmal angezeigt.

• Header: Authorization: Bearer mdv_live_…
• Die Berechtigung write kann Tasks erstellen und abbrechen sowie Dateien hochladen; read kann nur auflisten und abrufen.
• Keys sind nach einer Creator- ($25) oder Studio-Aufladung ($50) verfügbar. Credits verfallen nie.
• Die API ist für Aufrufe von deinem Server gedacht. Liefere Keys nicht in Browser- oder Mobile-Code aus.

Kenne den Preis zuerst

Jeder Task kostet Credits (1 Credit = $0.01). Hole vor dem Erstellen einen Kostenvoranschlag ein: Er ist gratis, braucht keinen Idempotency-Key und liefert genau das, was der Task reservieren wird. Dieselbe Zahl kommt beim Erstellen des Tasks als credits_reserved zurück, und credits_charged auf dem fertigen Task ist, was du tatsächlich bezahlt hast (jede ungenutzte Reservierung wird zurückgegeben).

GET /v1/credits zeigt jederzeit dein verfügbares und reserviertes Guthaben. Über die API erstellte Tasks erscheinen auch im Studio unter Meine Kreationen und im Credits-Verlauf.

Endpunkte

• GET /v1/models — Modelle mit Dauern, Auflösungen, Formaten, Credit-Preisen pro Sekunde und Referenzlimits.
• POST /v1/videos/quote — Exakte Credit-Kosten für einen Task. Gratis, keine Reservierung.
• POST /v1/videos — Task erstellen. Body: kind (t2v | i2v | r2v), model, prompt, duration_s, resolution, ratio, optional generate_audio, references. Erfordert Idempotency-Key.
• GET /v1/videos/{id} — Task-Status; ein erfolgreicher Task trägt eine video_url.
• GET /v1/videos — Deine Tasks, neueste zuerst, cursor-paginiert (limit, cursor).
• POST /v1/videos/{id}/cancel — Einen wartenden oder eingereihten Task abbrechen.
• POST /v1/files/presign — Upload-Slot für ein Referenzbild, -video oder eine Referenz-Audiodatei.
• POST /v1/files/{media_id}/confirm — Upload abschließen: Die Datei wird geprüft und sicherheitsgecheckt, danach als Referenz nutzbar.
• GET /v1/credits — Verfügbare und reservierte Credits.

Limits

• 60 Anfragen pro Minute pro Key.
• 2 laufende Tasks (waiting, queued oder running) pro Konto über die API.
• Die Lanes pro Modell werden von allen geteilt; ist eine Lane voll, wartet dein Task der Reihe nach und wird automatisch gesendet.
• Bis zu 5 aktive Keys pro Konto.
• Dateien: Bilder bis 10 MB, Video bis 50 MB, Audio bis 20 MB. Referenzvideos müssen mindestens 2 Sekunden lang sein; Video und Audio dürfen höchstens 5 Minuten lang sein.