開発者向け · API v1

ひとつの API。
すべてのモデル。

画像、動画、音声、3D をひとつの API で。支払いはスタジオと同じ残高です。キーは設定で作成できます。CLI は npm でインストールできます。

APIキーを取得クイックスタート

CLIをインストール

$ npm i -g pufy-io

モデル: 721
エンドポイント: 9
最低チャージ額: €3

例

同じ呼び出しで、どんな出力も

モデル ID を変えるだけで、画像・動画・音声を切り替えられます。フィールドはモデルに合わせて変わります。

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

クイックスタート

3 ステップで最初の生成

1APIキーを作成設定 > APIキーでキーに名前を付け、一度だけコピーします。請求から €3 以上でチャージしてください。export PUFY_API_KEY="YOUR_API_KEY"
2CLIをインストールコマンドラインツール pufy は npm、pnpm、bun でインストールできます。npm i -g pufy-io
3最初の生成を実行カタログからモデル ID を選び、プロンプトを送信します。--dry-run を付ければ、何も消費せずに価格を確認できます。pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/

CLI

ターミナルから生成

シェル、CI ジョブ、コーディングエージェントから任意のモデルを実行。すべての生成は開始前に価格が決まり、同じ残高から支払われます。

スクリプトと CIモデルのすべてのフィールドがフラグになります。ローカルファイルは自動でアップロードされます。

stdout に JSON実行ごとに JSON ドキュメントをひとつ出力。進捗とエラーは stderr へ、失敗時は 0 以外の終了コード。

コーディングエージェントスキルファイルが、まず価格を確認して上限を設けるようエージェントに教えます。

CLI ガイド全文 →

コマンド機能

pufy loginAPI キーを一度貼り付けるだけ。検証して保存します

pufy whoamiキーの名前と残高

pufy models --type videoすべての動画モデルと開始価格

pufy run <model> -hモデルのフィールドをリアルタイムで取得: 型、デフォルト、許可される値

pufy run <model> -p "<prompt>" -o ./out/生成して結果をフォルダーに保存

pufy run <model> -p "..." --dry-run正確な価格を、何も消費せずに

pufy run <model> -p "..." --max-price 0.50価格が上限を超えたら実行しない

pufy run <model> -p "..." --json -o ./out/次のステップにそのまま使える JSON の結果

pufy skill installコーディングエージェントに CLI の使い方を教える

API の基本

本番運用のための設計

認証

Authorization ヘッダーの Bearer トークン。キーは設定で作成します。

Authorization: Bearer YOUR_API_KEY

バックグラウンド生成

生成を開始すると、すぐに queued ステータスが返ります。成功、失敗、返金のいずれかになるまでポーリングしてください。

{ "status": "queued" }

まず価格を確認

何も開始せずに、入力内容の正確な価格を取得できます。金額はすべてユーロセント単位です。

POST /api/v1/api/catalog/quote

安全な再試行

Idempotency-Key ヘッダーを送れば、再試行したリクエストで二重に請求されることはありません。

Idempotency-Key: render-042

制限

キーごとに 1 分あたりの上限と、任意の 1 日の上限があります。上限を超えると API は 429 を返します。

429 Too Many Requests

エラーと返金

エラーはコードとメッセージ付きの JSON。失敗した生成は自動的に残高へ返金されます。

{ "status": "refunded" }

リファレンス

エンドポイント

ベース URL https://pufy.io/api/v1

API リファレンス全文 →

GET/api/catalog/meキーと残高

GET/api/catalog/modelsすべてのモデル

GET/api/catalog/models/detail?id=MODEL_ID1 つのモデルとそのフィールド

POST/api/catalog/quote指定した入力の価格

POST/api/catalog/generations生成を開始

GET/api/catalog/generations最近の生成

GET/api/catalog/generations/ID1 件の生成のステータス

GET/api/catalog/generations/ID/content結果ファイル

DELETE/api/catalog/generations/ID生成を削除

€3 をチャージしてスタジオで始めよう

設定でAPIキーを作成すれば、どのモデルも呼び出せます。CLI は npm でインストールできます。失敗した生成は返金されます。

APIキーを取得料金を見る

ひとつの API。 すべてのモデル。