Справочник API

Все эндпоинты PopNow API на одной странице со ссылками на полный контракт OpenAPI.

Полный машиночитаемый контракт — openapi.yaml (OpenAPI 3.1). Импортируйте его в Postman, Insomnia или генератор кода либо отдайте ИИ-агенту. Эта страница — карта для людей.

Базовый URL: https://api.popnow.ai/api/v1 (маршруты, совместимые с OpenAI: https://api.popnow.ai/v1)
Аутентификация: Authorization: Bearer sk-popnow-… в каждом запросе
Обёртка: { "code", "msg", "data", "request_id" }; code: 200 — успех
Суммы: целые кредиты (credits, maxCredits …), каждая также строкой в долларах США; 1 кредит = 0,01 $

Задачи

Метод и путь	Что делает	Страница
`POST /jobs/createTask`	Создать задачу генерации (необязательный `?wait=`, до 60 с)	Задачи
`GET /jobs/recordInfo?taskId=`	Прочитать состояние и результат задачи	Задачи
`GET /jobs`	Список задач этого ключа	Задачи
`POST /jobs/quote`	Узнать цену запроса, не запуская его	Оплата
`POST /jobs/retry`	Новая задача из упавшей или просроченной	Задачи
`POST /jobs/purge`	Удалить содержимое завершённой задачи	Задачи

Модели

Метод и путь	Что делает	Страница
`GET /models`	Все доступные модели с ценами (`?includeSchema=1` — со схемами входных данных)	Модели
`GET /models/{model}`	Одна модель со схемой входных данных	Модели

Файлы и ассеты

Метод и путь	Что делает	Страница
`POST /common/upload-url`	Тикет для прямой загрузки	Медиа
`POST /files/{fileId}/commit`	Завершить загрузку и получить URI `popnow://`	Медиа
`POST /files/import`	Импортировать файл LoRA по ссылке	Ассеты
`POST /common/download-url`	Новая подписанная ссылка на результат задачи	Медиа
`GET /assets`, `POST /assets`	Список ассетов или сохранение	Ассеты
`GET`, `PATCH`, `DELETE /assets/{assetId}`	Прочитать, переименовать или удалить ассет	Ассеты
`GET /assets/entities`	Ваши персонажи	Ассеты
`GET /assets/usage`	Тариф хранения и использование	Ассеты

Аккаунт

Метод и путь	Что делает	Страница
`GET /chat/credit`	Баланс: доступно, в резерве, всего	Оплата
`GET /usage`	Расход этого ключа по дням и моделям	Оплата

Совместимость с OpenAI Videos (`/v1`)

Метод и путь	Что делает	Страница
`POST /v1/videos`	Создать видеозадачу	OpenAI Videos
`GET /v1/videos/{id}`	Прочитать её	OpenAI Videos
`GET /v1/videos/{id}/content`	Перенаправить на файл	OpenAI Videos
`GET /v1/models`	Список моделей в формате OpenAI	OpenAI Videos

Общие заголовки

Заголовок	Направление	Значение
`Idempotency-Key`	Запрос	Делает повторы записи безопасными в течение 24 часов (Идемпотентность)
`Accept-Language`	Запрос	Язык сообщений об ошибках (Ошибки)
`X-PopNow-Retention`	Запрос	Сократить срок хранения содержимого задачи, в секундах
`X-Request-Id`	Ответ	То же, что `request_id`; сообщите в поддержку
`X-RateLimit-Limit`, `X-RateLimit-Remaining`, `Retry-After`	Ответ	Лимиты запросов (Лимиты запросов)