Desarrolladores · API v1

Una API.
Todos los modelos.

Imágenes, vídeo, audio y 3D tras una sola API, con el mismo saldo que el estudio. Crea una clave en Ajustes e instala la CLI con npm.

Obtener una clave APIInicio rápido
Instalar la CLI
$ npm i -g pufy-io
Modelos
721
Endpoints
9
Recarga mínima
3 €
Ejemplos

La misma llamada, cualquier resultado

Cambia el ID del modelo para pasar de imagen a video o voz. Los campos dependen del modelo.

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 de ejemploluma/uni-v1/text-to-image
Inicio rápido

Tu primer render en tres pasos

  1. 1Crea una clave APIEn Ajustes > Claves API, nombra una clave y cópiala una vez. Recarga desde 3 € en Facturación.export PUFY_API_KEY="YOUR_API_KEY"
  2. 2Instala la CLILa herramienta de línea de comandos pufy se instala con npm, pnpm o bun.npm i -g pufy-io
  3. 3Haz tu primer renderElige un ID de modelo del catálogo y envía un prompt. Añade --dry-run para ver el precio sin gastar nada.pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
CLI

Renderiza desde la terminal

Ejecuta cualquier modelo desde una shell, un job de CI o un agente de código. Cada render se cotiza antes de empezar y se cobra del mismo saldo.

Scripts y CICada campo de un modelo es un flag; un archivo local se sube por ti.
JSON en stdoutUn documento JSON por ejecución, progreso y errores en stderr, código de salida distinto de cero si falla.
Agentes de códigoUn archivo de skill enseña a tu agente a consultar primero el precio y a limitarlo.
Guía completa de la CLI →
ComandoQué hace
pufy loginPega tu clave de API una vez; se verifica y se guarda
pufy whoamiEl nombre de la clave y tu saldo
pufy models --type videoTodos los modelos de video con su precio inicial
pufy run <model> -hLos campos de un modelo, en vivo: tipo, valor por defecto, valores permitidos
pufy run <model> -p "<prompt>" -o ./out/Renderiza y guarda el resultado en una carpeta
pufy run <model> -p "..." --dry-runEl precio exacto, sin gastar nada
pufy run <model> -p "..." --max-price 0.50No ejecuta si el precio es mayor
pufy run <model> -p "..." --json -o ./out/Un resultado JSON, listo para el siguiente paso
pufy skill installEnseña a tu agente de código a usar la CLI
Lo esencial de la API

Lista para producción

Autenticación

Un token Bearer en la cabecera Authorization. Crea las claves en Ajustes.

Authorization: Bearer YOUR_API_KEY

Renders en segundo plano

Iniciar un render responde al instante con el estado queued. Consulta el render hasta que termine con éxito, falle o se reembolse.

{ "status": "queued" }

Primero el precio

Pide el precio exacto de tus parámetros sin iniciar nada. Todos los importes están en céntimos de euro.

POST /api/v1/api/catalog/quote

Reintentos seguros

Envía un encabezado Idempotency-Key y una petición repetida nunca cobra dos veces.

Idempotency-Key: render-042

Límites

Cada clave tiene un límite por minuto y un tope diario opcional. Al superarlo, la API responde 429.

429 Too Many Requests

Errores y reembolsos

Errores JSON con un código y un mensaje. Un render fallido se reembolsa a tu saldo automáticamente.

{ "status": "refunded" }
Referencia

Endpoints

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

Referencia completa de la API →
GET/api/catalog/meTu clave y tu saldo
GET/api/catalog/modelsTodos los modelos
GET/api/catalog/models/detail?id=MODEL_IDUn modelo y sus campos
POST/api/catalog/quotePrecio para entradas exactas
POST/api/catalog/generationsIniciar una generación
GET/api/catalog/generationsTus generaciones recientes
GET/api/catalog/generations/IDEstado de una generación
GET/api/catalog/generations/ID/contentEl archivo resultante
DELETE/api/catalog/generations/IDEliminar una generación

Recarga 3 € y empieza en el estudio

Crea una clave API en Ajustes y llama a cualquier modelo. Instala la CLI con npm. Los renders fallidos se reembolsan.

Obtener una clave APIVer precios