Разработчикам · 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
Пример рендераluma/uni-v1/text-to-image
Быстрый старт

Первый рендер за три шага

  1. 1Создайте API-ключВ Настройки > API-ключи назовите ключ и скопируйте его один раз. Пополните баланс от 3 € в разделе Оплата.export PUFY_API_KEY="YOUR_API_KEY"
  2. 2Установите CLIКонсольная утилита pufy ставится через npm, pnpm или bun.npm i -g pufy-io
  3. 3Сделайте первый рендерВыберите ID модели в каталоге и отправьте промпт. Добавьте --dry-run, чтобы узнать цену, ничего не потратив.pufy run luma/uni-v1/text-to-image -p "violet neon fox" -o ./out/
CLI

Рендер из терминала

Запускайте любую модель из shell, CI или кодинг-агента. Цена каждого рендера известна до старта и списывается с того же баланса.

Скрипты и CIКаждое поле модели доступно как флаг; локальный файл загружается автоматически.
JSON в stdoutОдин JSON-документ на запуск, прогресс и ошибки в stderr, ненулевой код выхода при сбое.
Кодинг-агентыФайл навыка учит агента сначала проверять цену и ограничивать её.
Полное руководство по CLI →
КомандаЧто делает
pufy loginВставьте API-ключ один раз: он проверяется и сохраняется
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

Готов к продакшену

Аутентификация

Bearer-токен в заголовке Authorization. Ключи создаются в настройках.

Authorization: Bearer YOUR_API_KEY

Фоновые рендеры

Запуск рендера сразу отвечает статусом queued. Опрашивайте рендер, пока он не завершится успехом, ошибкой или возвратом.

{ "status": "queued" }

Сначала цена

Узнайте точную цену для своих параметров, ничего не запуская. Все суммы указаны в евроцентах.

POST /api/v1/api/catalog/quote

Безопасные повторы

Передайте заголовок Idempotency-Key, и повторный запрос никогда не спишет деньги дважды.

Idempotency-Key: render-042

Лимиты

У каждого ключа есть лимит в минуту и необязательный дневной потолок. Сверх лимита 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_IDОдна модель и её поля
POST/api/catalog/quoteЦена для конкретных входных данных
POST/api/catalog/generationsЗапустить генерацию
GET/api/catalog/generationsВаши последние генерации
GET/api/catalog/generations/IDСтатус одной генерации
GET/api/catalog/generations/ID/contentФайл результата
DELETE/api/catalog/generations/IDУдалить генерацию

Пополните на 3 € и начните в студии

Создайте API-ключ в настройках и вызывайте любую модель. Установите CLI через npm. Неудачные рендеры возвращаются.

Получить API-ключСмотреть цены