Sviluppatori · API v1

Un'unica API.
Ogni modello.

Immagini, video, audio e 3D dietro una sola API, pagati con lo stesso saldo dello studio. Crea una chiave in Impostazioni e installa la CLI con npm.

Ottieni una chiave APIGuida rapida
Installa la CLI
$ npm i -g pufy-io
Modelli
721
Endpoint
9
Ricarica minima
3 €
Esempi

Stessa chiamata, qualsiasi output

Cambia l'ID del modello per passare tra immagine, video e voce. I campi seguono il modello.

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
Render di esempioluma/uni-v1/text-to-image
Guida rapida

Il primo render in tre passi

  1. 1Crea una chiave APIIn Impostazioni > Chiavi API dai un nome a una chiave e copiala una volta sola. Ricarica da 3 € in Pagamenti.export PUFY_API_KEY="YOUR_API_KEY"
  2. 2Installa la CLILo strumento a riga di comando pufy si installa con npm, pnpm o bun.npm i -g pufy-io
  3. 3Fai il tuo primo renderScegli un ID modello dal catalogo e invia un prompt. Aggiungi --dry-run per vedere il prezzo senza spendere nulla.pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
CLI

Genera dal terminale

Esegui qualsiasi modello da una shell, un job di CI o un agente di programmazione. Ogni render ha il prezzo calcolato prima di partire e attinge allo stesso saldo.

Script e CIOgni campo di un modello è un flag; un file locale viene caricato per te.
JSON su stdoutUn documento JSON per esecuzione, avanzamento ed errori su stderr, codice di uscita diverso da zero in caso di errore.
Agenti di programmazioneUn file skill insegna al tuo agente a controllare prima il prezzo e a fissare un tetto.
Guida completa alla CLI →
ComandoCosa fa
pufy loginIncolla la tua chiave API una volta sola; viene verificata e salvata
pufy whoamiIl nome della chiave e il tuo saldo
pufy models --type videoTutti i modelli video con il prezzo di partenza
pufy run <model> -hI campi di un modello, letti in tempo reale: tipo, valore predefinito, valori ammessi
pufy run <model> -p "<prompt>" -o ./out/Genera e salva il risultato in una cartella
pufy run <model> -p "..." --dry-runIl prezzo esatto, senza spendere nulla
pufy run <model> -p "..." --max-price 0.50Rifiuta di eseguire se il prezzo è più alto
pufy run <model> -p "..." --json -o ./out/Un risultato JSON, pronto per il passo successivo
pufy skill installInsegna al tuo agente di programmazione a usare la CLI
Le basi dell'API

Pensata per la produzione

Autenticazione

Un token Bearer nell'intestazione Authorization. Crea le chiavi in Impostazioni.

Authorization: Bearer YOUR_API_KEY

Render in background

Avviare un render risponde subito con stato queued. Controlla il render finché non è riuscito, fallito o rimborsato.

{ "status": "queued" }

Prima il prezzo

Chiedi il prezzo esatto dei tuoi input senza avviare nulla. Ogni importo è in centesimi di euro.

POST /api/v1/api/catalog/quote

Nuovi tentativi sicuri

Invia un header Idempotency-Key e una richiesta ripetuta non addebita mai due volte.

Idempotency-Key: render-042

Limiti

Ogni chiave ha un limite al minuto e un tetto giornaliero facoltativo. Oltre il limite l'API risponde 429.

429 Too Many Requests

Errori e rimborsi

Errori JSON con un codice e un messaggio. Un render non riuscito viene rimborsato automaticamente sul tuo saldo.

{ "status": "refunded" }
Riferimento

Endpoint

URL di base https://pufy.io/api/v1

Riferimento API completo →
GET/api/catalog/meLa tua chiave e il saldo
GET/api/catalog/modelsTutti i modelli
GET/api/catalog/models/detail?id=MODEL_IDUn modello e i suoi campi
POST/api/catalog/quotePrezzo per input esatti
POST/api/catalog/generationsAvvia un render
GET/api/catalog/generationsI tuoi render recenti
GET/api/catalog/generations/IDStato di un render
GET/api/catalog/generations/ID/contentIl file del risultato
DELETE/api/catalog/generations/IDElimina un render

Ricarica 3 € e inizia nello studio

Crea una chiave API in Impostazioni e chiama qualsiasi modello. Installa la CLI con npm. I render falliti vengono rimborsati.

Ottieni una chiave APIVedi i prezzi