Desenvolvedores · API v1

Uma API.
Todos os modelos.

Imagens, vídeo, áudio e 3D numa só API, com o mesmo saldo do estúdio. Crie uma chave em Configurações e instale a CLI com npm.

Obter uma chave de APIInício rápido
Instalar a CLI
$ npm i -g pufy-io
Modelos
721
Endpoints
9
Recarga mínima
€ 3
Exemplos

A mesma chamada, qualquer resultado

Troque o ID do modelo para alternar entre imagem, vídeo e voz. Os campos seguem o 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 exemploluma/uni-v1/text-to-image
Início rápido

Seu primeiro render em três passos

  1. 1Crie uma chave de APIEm Configurações > Chaves de API, dê um nome à chave e copie-a uma vez. Recarregue a partir de € 3 em Cobrança.export PUFY_API_KEY="YOUR_API_KEY"
  2. 2Instale a CLIA ferramenta de linha de comando pufy se instala com npm, pnpm ou bun.npm i -g pufy-io
  3. 3Faça seu primeiro renderEscolha um ID de modelo no catálogo e envie um prompt. Adicione --dry-run para ver o preço sem gastar nada.pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
CLI

Renderize pelo terminal

Execute qualquer modelo a partir de um shell, um job de CI ou um agente de código. Cada render tem o preço calculado antes de começar e é pago com o mesmo saldo.

Scripts e CICada campo de um modelo é uma flag; um arquivo local é enviado para você.
JSON no stdoutUm documento JSON por execução, progresso e erros no stderr, código de saída diferente de zero em caso de falha.
Agentes de códigoUm arquivo de skill ensina seu agente a verificar o preço primeiro e a limitá-lo.
Guia completo da CLI →
ComandoO que faz
pufy loginCole sua chave de API uma vez; ela é verificada e salva
pufy whoamiO nome da chave e o seu saldo
pufy models --type videoTodos os modelos de vídeo com o preço inicial
pufy run <model> -hOs campos de um modelo, ao vivo: tipo, padrão, valores permitidos
pufy run <model> -p "<prompt>" -o ./out/Renderiza e salva o resultado em uma pasta
pufy run <model> -p "..." --dry-runO preço exato, sem gastar nada
pufy run <model> -p "..." --max-price 0.50Não executa se o preço for maior
pufy run <model> -p "..." --json -o ./out/Um resultado em JSON, pronto para o próximo passo
pufy skill installEnsine seu agente de código a usar a CLI
Essencial da API

Pronta para produção

Autenticação

Um token Bearer no cabeçalho Authorization. Crie as chaves em Configurações.

Authorization: Bearer YOUR_API_KEY

Renders em segundo plano

Iniciar um render responde na hora com o status queued. Consulte o render até que ele seja concluído, falhe ou seja reembolsado.

{ "status": "queued" }

Preço primeiro

Peça o preço exato dos seus parâmetros sem iniciar nada. Todos os valores estão em centavos de euro.

POST /api/v1/api/catalog/quote

Repetições seguras

Envie um cabeçalho Idempotency-Key e uma requisição repetida nunca cobra duas vezes.

Idempotency-Key: render-042

Limites

Cada chave tem um limite por minuto e um teto diário opcional. Acima do limite, a API responde 429.

429 Too Many Requests

Erros e reembolsos

Erros em JSON com um código e uma mensagem. Um render que falha é reembolsado no seu saldo automaticamente.

{ "status": "refunded" }
Referência

Endpoints

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

Referência completa da API →
GET/api/catalog/meSua chave e seu saldo
GET/api/catalog/modelsTodos os modelos
GET/api/catalog/models/detail?id=MODEL_IDUm modelo e seus campos
POST/api/catalog/quotePreço para entradas exatas
POST/api/catalog/generationsIniciar uma geração
GET/api/catalog/generationsSuas gerações recentes
GET/api/catalog/generations/IDStatus de uma geração
GET/api/catalog/generations/ID/contentO arquivo de resultado
DELETE/api/catalog/generations/IDExcluir uma geração

Recarregue € 3 e comece no estúdio

Crie uma chave de API em Configurações e chame qualquer modelo. Instale a CLI com npm. Renders com falha são reembolsados.

Obter uma chave de APIVer preços