Zum Inhalt springen
DER.run
Studio öffnen

API

API für KI-Bild- und Videogenerierung

Die Modelle und Tools aus dem Studio sind per HTTPS mit einem API-Schlüssel nutzbar: Modellkatalog lesen, Generierungen senden, ihren Status abfragen und die Ergebnisse herunterladen. Oder bind DER (der.run) per MCP in deinen KI-Agenten ein.

API-Schlüssel holenKI-Agenten verbinden
  • AuthentifizierungBearer-API-Schlüssel
  • Modelle und Tools55 im Katalog
  • StatusabfrageAlle 5–30 s
  • Preise1 Credit = 0,01 $

Zwei Zugänge

REST für Code, MCP für Agenten

REST-API

https://api.der.run/v1

Für deinen eigenen Code. Generierung senden, Status abfragen, Ergebnis herunterladen.

  • GET/v1/capabilitiesAlle Modelle mit Parametern, Upload-Slots, Preismodus und Abfrageintervall
  • POST/v1/quotesPreis einer Generierung vor dem Senden abfragen
  • POST/v1/uploadsUpload starten, dann die Datei per PUT an die zurückgegebene Adresse senden
  • POST/v1/uploads/{id}/completeUpload abschließen und die Asset-ID für die Eingaben erhalten
  • POST/v1/jobsGenerierung senden · Idempotency-Key erforderlich
  • GET/v1/jobsDeine Generierungen, neueste zuerst, bis zu 100 pro Seite
  • GET/v1/jobs/{id}Status einer Generierung
  • GET/v1/jobs/{id}/assets/{index}Ausgabe über einen privaten Link herunterladen, der etwa eine Stunde gilt

MCP-Server & DER-Skill

https://api.der.run/mcp

Für KI-Agenten wie Claude Code, Cursor und Codex. Adresse hinzufügen, mit deinem DER-Konto anmelden und dann einfach in eigenen Worten fragen.

  • der_list_modelsModelle, Preise und Limits
  • der_quotePreis eines Auftrags vorab abfragen (kostenlos)
  • der_create_jobAuftrag für Video, Bild, AIdol, Face Swap oder Musik starten
  • der_get_jobStatus und Ergebnis-Links
  • der_get_resultsDownload-Links
  • + 13 weitere Tools im MCP-Server
KI-Agenten einrichten

Authentifizierung

Ein Schlüssel, dein ganzes Konto

Sende deinen API-Schlüssel als Bearer-Token. Ein Schlüssel handelt als dein Konto: dieselben Credits, dieselbe Stufe. Schlüssel gelten bis zu 366 Tage – erstellen und widerrufen kannst du sie unter „API-Schlüssel“. Bis zu 10 Schlüssel gleichzeitig.

HTTP-Header
# bei jeder Anfrage
Authorization: Bearer der_user_…

Schnellstart

Deine erste Generierung in drei Schritten

  1. API-Schlüssel erstellen

    Im Studio unter „API-Schlüssel“. Der Schlüssel wird nur einmal angezeigt – bewahre ihn sicher auf.

    API-Schlüssel öffnen

  2. Katalog lesen

    GET /v1/capabilities listet alle Modelle mit Parametern, Upload-Slots, Preismodus und Abfrageintervall.

    Terminal
    curl "https://api.der.run/v1/capabilities" \
  -H "Authorization: Bearer $DER_API_KEY"

  3. Senden und abfragen

    Lade zuerst dein Foto hoch, sende dann POST /v1/jobs mit einem Idempotency-Key und frag GET /v1/jobs/{id} ab, bis die Generierung fertig ist. Sendest du denselben Idempotency-Key noch einmal, bekommst du dieselbe Generierung zurück.

    Terminal
    curl -X POST "https://api.der.run/v1/jobs" \
  -H "Authorization: Bearer $DER_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "der-v2",
    "params": {
      "prompt": "…"
    },
    "inputs": {
      "image": "<asset id>"
    }
  }'

curl "https://api.der.run/v1/jobs/{id}" \
  -H "Authorization: Bearer $DER_API_KEY"

Gut zu wissen

Bevor du live gehst

  • Ergebnisse sind privat

    Über REST lädst du Ausgaben mit deinem Schlüssel herunter: GET /v1/jobs/{id}/assets/{index} leitet dich zu einem privaten Link weiter, der etwa eine Stunde gilt. Öffentliche Links gibt es nicht, und die MCP-Tools geben dieselbe Art von Link aus. Ergebnisse und Uploads werden 7 Tage aufbewahrt und dann automatisch gelöscht.

  • Listen kommen seitenweise

    GET /v1/jobs liefert bis zu 100 Generierungen, neueste zuerst. Übergib next_before als before, um ältere zu bekommen, und filtere nach Modell, Ausgabe oder Status.

  • Preise

    Manche Modelle haben einen festen Preis im Katalog, die übrigen werden beim Senden berechnet. POST /v1/quotes nennt dir den Preis vorab.

  • Stufen

    Manche Modelle brauchen ein Pro- oder Max-Konto. Eine Anfrage dafür von einer niedrigeren Stufe bekommt einen 403.

  • Dieselben Credits

    Die API verbraucht dieselben Credits wie das Studio. Bei fehlgeschlagenen Generierungen gibt es die Credits automatisch zurück.

  • Im Takt des Modells abfragen

    Jedes Modell hat im Katalog sein eigenes poll_seconds. Zu viele Anfragen bekommen einen 429 mit einem Retry-After-Header.

Für KI-Agenten

DER in Claude Code, Cursor oder Codex nutzen

Ein Befehl zum Verbinden. Dieselben Modelle, dieselben Credits – und die Ergebnisse erscheinen auch im Studio.

Zur Anleitung für KI-Agenten