Pengembang · API v1

Satu API.
Semua model.

Gambar, video, audio, dan 3D di balik satu API, dibayar dari saldo yang sama dengan studio. Buat kunci di Pengaturan dan pasang CLI dengan npm.

Dapatkan kunci APIMulai cepat
Pasang CLI
$ npm i -g pufy-io
Model
721
Endpoint
9
Isi saldo minimum
€3
Contoh

Panggilan yang sama, output apa pun

Ganti ID model untuk beralih antara gambar, video, dan suara. Kolomnya mengikuti model.

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
Contoh renderluma/uni-v1/text-to-image
Mulai cepat

Render pertama dalam tiga langkah

  1. 1Buat kunci APIDi Pengaturan > Kunci API, beri nama kunci dan salin sekali. Isi saldo mulai €3 di Penagihan.export PUFY_API_KEY="YOUR_API_KEY"
  2. 2Pasang CLIAlat baris perintah pufy dipasang lewat npm, pnpm, atau bun.npm i -g pufy-io
  3. 3Buat render pertamaPilih ID model dari katalog dan kirim prompt. Tambahkan --dry-run untuk melihat harga tanpa mengeluarkan apa pun.pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
CLI

Render dari terminal

Jalankan model apa pun dari shell, job CI, atau agen coding. Setiap render diberi harga sebelum dimulai dan dibayar dari saldo yang sama.

Skrip dan CISetiap kolom model adalah flag; file lokal diunggah untuk Anda.
JSON di stdoutSatu dokumen JSON per eksekusi, progres dan error di stderr, kode keluar bukan nol jika gagal.
Agen codingFile skill mengajari agen Anda untuk memeriksa harga terlebih dahulu dan membatasinya.
Panduan lengkap CLI →
PerintahFungsinya
pufy loginTempel kunci API Anda sekali; kunci diperiksa lalu disimpan
pufy whoamiNama kunci dan saldo Anda
pufy models --type videoSemua model video beserta harga awalnya
pufy run <model> -hKolom sebuah model, diambil langsung: tipe, default, nilai yang diizinkan
pufy run <model> -p "<prompt>" -o ./out/Render dan simpan hasilnya di folder
pufy run <model> -p "..." --dry-runHarga pastinya, tanpa mengeluarkan apa pun
pufy run <model> -p "..." --max-price 0.50Menolak berjalan jika harganya lebih tinggi
pufy run <model> -p "..." --json -o ./out/Satu hasil JSON, siap untuk langkah berikutnya
pufy skill installAjari agen coding Anda memakai CLI
Dasar API

Siap untuk produksi

Autentikasi

Token Bearer di header Authorization. Buat kunci di Pengaturan.

Authorization: Bearer YOUR_API_KEY

Render di latar belakang

Memulai render langsung menjawab dengan status queued. Polling render sampai berhasil, gagal, atau dikembalikan dananya.

{ "status": "queued" }

Harga dulu

Minta harga pasti untuk input Anda tanpa memulai apa pun. Semua jumlah dalam sen euro.

POST /api/v1/api/catalog/quote

Coba ulang dengan aman

Kirim header Idempotency-Key dan permintaan yang diulang tidak akan pernah ditagih dua kali.

Idempotency-Key: render-042

Batas

Setiap kunci punya batas per menit dan batas harian opsional. Melewati batas, API menjawab 429.

429 Too Many Requests

Error dan pengembalian dana

Error JSON dengan kode dan pesan. Render yang gagal otomatis dikembalikan ke saldo Anda.

{ "status": "refunded" }
Referensi

Endpoint

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

Referensi API lengkap →
GET/api/catalog/meKunci dan saldo Anda
GET/api/catalog/modelsSemua model
GET/api/catalog/models/detail?id=MODEL_IDSatu model dan kolomnya
POST/api/catalog/quoteHarga untuk input tertentu
POST/api/catalog/generationsMulai render
GET/api/catalog/generationsRender terbaru Anda
GET/api/catalog/generations/IDStatus satu render
GET/api/catalog/generations/ID/contentFile hasil
DELETE/api/catalog/generations/IDHapus render

Isi saldo €3 dan mulai di studio

Buat kunci API di Pengaturan dan panggil model apa pun. Pasang CLI dengan npm. Render yang gagal dikembalikan.

Dapatkan kunci APILihat harga