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 und installiere die CLI mit npm.

API-Schlüssel holenSchnellstart
CLI installieren
$ npm i -g pufy-io
Modelle
721
Endpunkte
9
Mindestaufladung
3 €
Beispiele

Derselbe Aufruf, jede Ausgabe

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

1# 1. Generate an image2curl -X POST https://pufy.io/api/v1/api/catalog/generations \3  -H "Authorization: Bearer $PUFY_API_KEY" \4  -H 'Content-Type: application/json' \5  -H "Idempotency-Key: $(uuidgen)" \6  -d '{7  "modelId": "luma/uni-v1/text-to-image",8  "inputs": {9    "prompt": "Neon city street after rain, cinematic night",10    "size": "16:9"11  }12}'13 14# 2. Poll with the generation id from step 1 until its status is succeeded15curl https://pufy.io/api/v1/api/catalog/generations/$ID \16  -H "Authorization: Bearer $PUFY_API_KEY"17 18# 3. Download the file19curl https://pufy.io/api/v1/api/catalog/generations/$ID/content \20  -H "Authorization: Bearer $PUFY_API_KEY" \21  -o result.jpeg
Beispiel-Renderingluma/uni-v1/text-to-image
Schnellstart

Der erste Render in drei Schritten

  1. 1Erstelle einen API-SchlüsselBenenne unter Einstellungen > API-Schlüssel einen Schlüssel und kopiere ihn einmal. Lade ab 3 € unter Abrechnung auf.export PUFY_API_KEY="YOUR_API_KEY"
  2. 2Installiere die CLIDas Kommandozeilen-Tool pufy lässt sich mit npm, pnpm oder bun installieren.npm i -g pufy-io
  3. 3Ersten Render startenWähle eine Modell-ID aus dem Katalog und sende einen Prompt. Mit --dry-run siehst du den Preis, ohne etwas auszugeben.pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
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.
Vollständige CLI-Anleitung →
BefehlWas er tut
pufy loginFüge deinen API-Schlüssel einmal ein; er wird geprüft und gespeichert
pufy whoamiDer Name des Schlüssels und dein Guthaben
pufy models --type videoAlle Videomodelle mit ihrem Startpreis
pufy run <model> -hDie Felder eines Modells, live abgerufen: Typ, Standardwert, erlaubte Werte
pufy run <model> -p "<prompt>" -o ./out/Rendern und das Ergebnis in einem Ordner speichern
pufy run <model> -p "..." --dry-runDer genaue Preis, ohne etwas auszugeben
pufy run <model> -p "..." --max-price 0.50Nicht starten, wenn der Preis höher ist
pufy run <model> -p "..." --json -o ./out/Ein JSON-Ergebnis, bereit für den nächsten Schritt
pufy skill installBring deinem Coding-Agenten die CLI bei
API-Grundlagen

Gebaut für die Produktion

Authentifizierung

Ein Bearer-Token im Authorization-Header. Schlüssel erstellst du in den Einstellungen.

Authorization: Bearer YOUR_API_KEY

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 /api/v1/api/catalog/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" }
Referenz

Endpunkte

Basis-URL https://pufy.io/api/v1

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

Lade 3 € auf und starte im Studio

Erstelle in den Einstellungen einen API-Schlüssel und rufe jedes Modell auf. Installiere die CLI mit npm. Fehlgeschlagene Renders werden erstattet.

API-Schlüssel holenPreise ansehen