Entwickler · API v1

Eine API. Jedes Modell.

Bilder, Video, Audio und 3D hinter einer API, bezahlt vom selben Guthaben wie das Studio. Erstelle einen Schlüssel in den Einstellungen; die CLI folgt bald.

Bald verfügbarDie Ducklygen-CLI ist unterwegs. Diese Seite zeigt vorab, wie sie funktioniert; bis dahin nutze die API.

$npm i -g @ducklygen/cli
Modelle
672
Endpunkte
9
Mindestaufladung
3 €

Derselbe Aufruf, jede Ausgabe

Tausche die Modell-ID, um zwischen Bild, Video und Sprache zu wechseln. Die Felder richten sich nach dem Modell.

curl -X POST https://ducklygen.com/api/v1/api/catalog/generations \
  -H "Authorization: Bearer $DUCKLYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "modelId": "image-model-id",
  "inputs": {
    "prompt": "rubber duck floating on teal water, soft light"
  }
}'
Beispiel-Rendering

Der erste Render in drei Schritten

  1. 1

    API-Schlüssel erstellen

    Melde dich mit deiner E-Mail an, öffne Einstellungen, API-Schlüssel und erstelle einen Schlüssel. Lade ab 3 € unter Abrechnung auf.

    export DUCKLYGEN_API_KEY="dk_live_..."
  2. 2

    Die CLI kommt bald

    Das Kommandozeilen-Tool ist noch nicht veröffentlicht. Bis dahin läuft alles im Studio.

    npm i -g @ducklygen/cli
  3. 3

    Ersten Render starten

    Wähle eine Modell-ID aus dem Katalog und sende einen Prompt. Mit --dry-run siehst du den Preis, ohne etwas auszugeben.

    ducklygen run <model> -p "duck on teal waves" -o ./out/
Bald verfügbarDucklygen CLI

Rendern im Terminal

Starte jedes Modell aus einer Shell, einem CI-Job oder einem Coding-Agenten. Jeder Render wird vor dem Start bepreist und aus demselben Guthaben bezahlt.

Skripte und CIJedes Feld eines Modells ist ein Flag; eine lokale Datei wird für dich hochgeladen.
JSON auf stdoutEin JSON-Dokument pro Lauf, Fortschritt und Fehler auf stderr, ein Exit-Code ungleich null bei Fehlern.
Coding-AgentenEine Skill-Datei bringt deinem Agenten bei, erst den Preis zu prüfen und ihn zu begrenzen.

Das Paket @ducklygen/cli ist noch nicht veröffentlicht. Die Befehle unten zeigen, wie es funktionieren wird.

Vollständige CLI-Anleitung →
Befehl
ducklygen loginFüge deinen API-Schlüssel einmal ein; er wird geprüft und gespeichert
ducklygen whoamiDer Name des Schlüssels und dein Guthaben
ducklygen models --type videoAlle Videomodelle mit ihrem Startpreis
ducklygen run <model> -hDie Felder eines Modells, live abgerufen: Typ, Standardwert, erlaubte Werte
ducklygen run <model> -p "<prompt>" -o ./out/Rendern und das Ergebnis in einem Ordner speichern
ducklygen run <model> -p "..." --dry-runDer genaue Preis, ohne etwas auszugeben
ducklygen run <model> -p "..." --max-price 0.50Nicht starten, wenn der Preis höher ist
ducklygen run <model> -p "..." --json -o ./out/Ein JSON-Ergebnis, bereit für den nächsten Schritt
ducklygen skill installBring deinem Coding-Agenten die CLI bei

Gebaut für die Produktion

Authentifizierung

Ein Bearer-Token im Authorization-Header. Erstelle Schlüssel in den Einstellungen und widerrufe jeden davon jederzeit.

Authorization: Bearer dk_live_...

Renders im Hintergrund

Der Start eines Renders antwortet sofort mit dem Status queued. Frag den Render ab, bis er erfolgreich ist, fehlschlägt oder erstattet wurde.

{ "status": "queued" }

Erst der Preis

Frag den genauen Preis deiner Eingaben ab, ohne etwas zu starten. Alle Beträge sind in Euro-Cent.

POST /v1/quote

Sichere Wiederholungen

Sende einen Idempotency-Key-Header, und eine wiederholte Anfrage wird nie doppelt berechnet.

Idempotency-Key: render-042

Limits

Jeder Schlüssel hat ein Limit pro Minute und ein optionales Tageslimit. Darüber antwortet die API mit 429.

429 Too Many Requests

Fehler und Erstattungen

JSON-Fehler mit Code und Meldung. Ein fehlgeschlagener Render wird automatisch deinem Guthaben erstattet.

{ "status": "refunded" }

Endpunkte

Basis-URLhttps://ducklygen.com/api/v1/api/catalogVollständige API-Referenz →

GET/meDein Schlüssel und Guthaben
GET/modelsAlle Modelle
GET/models/detail?id=MODEL_IDEin Modell und seine Felder
POST/quotePreis für genaue Eingaben
POST/generationsRendering starten
GET/generationsDeine letzten Renderings
GET/generations/IDStatus eines Renderings
GET/generations/ID/contentDie Ergebnisdatei
DELETE/generations/IDRendering löschen

Lade 3 € auf und leg heute los

Erstelle in den Einstellungen einen API-Schlüssel und rufe jedes Modell auf. Die CLI folgt bald. Fehlgeschlagene Renders werden erstattet.