Vývojáři · API v1

Jedno API.
Každý model.

Obrázky, video, zvuk a 3D za jedním API, placené ze stejného zůstatku jako studio. Klíč vytvoříte v Nastavení a CLI nainstalujete přes npm.

Získat klíč APIRychlý start
Instalace CLI
$ npm i -g pufy-io
Modely
721
Endpointy
9
Minimální dobití
3 €
Příklady

Stejné volání, jakýkoli výstup

Změňte ID modelu a přepnete se mezi obrázkem, videem a řečí. Pole se řídí modelem.

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
Ukázkový renderluma/uni-v1/text-to-image
Rychlý start

První render ve třech krocích

  1. 1Vytvořte API klíčV Nastavení > Klíče API pojmenujte klíč a jednou ho zkopírujte. Zůstatek dobijte od 3 € v Platbách.export PUFY_API_KEY="YOUR_API_KEY"
  2. 2Nainstalujte CLINástroj příkazové řádky pufy se instaluje přes npm, pnpm nebo bun.npm i -g pufy-io
  3. 3Vytvořte první renderVyberte ID modelu z katalogu a pošlete prompt. Přidejte --dry-run a uvidíte cenu, aniž byste cokoli utratili.pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
CLI

Renderování z terminálu

Spouštějte libovolný model ze shellu, úlohy CI nebo programátorského agenta. Každý render se ocení před spuštěním a čerpá ze stejného zůstatku.

Skripty a CIKaždé pole modelu je přepínač; místní soubor se nahraje za vás.
JSON na stdoutJeden dokument JSON na spuštění, průběh a chyby na stderr, při selhání nenulový návratový kód.
Programátorští agentiSoubor dovednosti naučí vašeho agenta nejdřív zkontrolovat cenu a omezit ji.
Úplný průvodce CLI →
PříkazCo dělá
pufy loginJednou vložte svůj API klíč; ověří se a uloží
pufy whoamiNázev klíče a váš zůstatek
pufy models --type videoKaždý video model s výchozí cenou
pufy run <model> -hPole modelu načtená živě: typ, výchozí hodnota, povolené hodnoty
pufy run <model> -p "<prompt>" -o ./out/Vyrenderovat a uložit výsledek do složky
pufy run <model> -p "..." --dry-runPřesná cena, aniž byste cokoli utratili
pufy run <model> -p "..." --max-price 0.50Odmítnout spuštění, pokud je cena vyšší
pufy run <model> -p "..." --json -o ./out/Jeden výsledek v JSON, připravený pro další krok
pufy skill installNaučte svého programátorského agenta používat CLI
Základy API

Připraveno pro produkci

Ověření

Token Bearer v hlavičce Authorization. Klíče vytvoříte v Nastavení.

Authorization: Bearer YOUR_API_KEY

Rendery na pozadí

Spuštění renderu odpoví okamžitě se stavem queued. Dotazujte se na render, dokud se nezdaří, neuspěje nebo nebude vrácen.

{ "status": "queued" }

Cena předem

Zjistěte přesnou cenu svých vstupů, aniž byste cokoli spouštěli. Každá částka je v eurocentech.

POST /api/v1/api/catalog/quote

Bezpečné opakování

Pošlete hlavičku Idempotency-Key a opakovaný požadavek nikdy neúčtuje dvakrát.

Idempotency-Key: render-042

Limity

Každý klíč má limit za minutu a volitelný denní strop. Po překročení limitu API odpoví 429.

429 Too Many Requests

Chyby a vrácení peněz

Chyby v JSON s kódem a zprávou. Nezdařený render se automaticky vrátí na váš zůstatek.

{ "status": "refunded" }
Reference

Endpointy

Základní URL https://pufy.io/api/v1

Úplná reference API →
GET/api/catalog/meVáš klíč a zůstatek
GET/api/catalog/modelsVšechny modely
GET/api/catalog/models/detail?id=MODEL_IDJeden model a jeho pole
POST/api/catalog/quoteCena pro přesné vstupy
POST/api/catalog/generationsSpustit render
GET/api/catalog/generationsVaše poslední rendery
GET/api/catalog/generations/IDStav jednoho renderu
GET/api/catalog/generations/ID/contentVýsledný soubor
DELETE/api/catalog/generations/IDSmazat render

Dobijte 3 € a začněte ve studiu

Vytvořte v Nastavení klíč API a volejte libovolný model. CLI nainstalujete přes npm. Nezdařené rendery se vracejí.

Získat klíč APIZobrazit ceník