Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
aspect_ratio | Нет | Форма кадра: широкая, квадратная или вертикальная. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 |
image_urls | Да | Фото для правки или объединения. В промпте укажите, что берётся из каждого. |
loras | Нет | Загрузите свои LoRA, чтобы закрепить стиль или персонажа. По умолчанию: [] |
output_format | Нет | Формат файла результата. jpeg · png · webp · По умолчанию: jpeg |
prompt | Да | Say what to change and what to keep. With several images, refer to them as image 1, image 2 and so on. |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| Стандарт | 1,8 | 0,018 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 2 кредита за изображение (0,02 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API P-Image LoRA в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model pruna-ai/p-image-lora/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "pruna-ai/p-image-lora/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API P-Image LoRA
Сколько стоит API P-Image LoRA?
P-Image LoRA стоит от 2 кредита (0,02 $) за изображение — на самой дешёвой задаче «Редактировать картинку». Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у P-Image LoRA в API?
Укажите pruna-ai/p-image-lora/text-to-image — Создать картинку; pruna-ai/p-image-lora/edit — Редактировать картинку в поле model запроса POST /jobs/createTask.
Какие LoRA здесь работают?
Для генерации по тексту — LoRA, созданные в тренере P-Image от Pruna, а в наших тестах ещё и LoRA от сообщества, обученные под Z-Image Turbo и сохранённые в обычной раскладке diffusers. Для редактирования — LoRA, обученные под Qwen-Image-Edit. LoRA для FLUX, модели SDXL или другого эндпоинта вызывает ошибку запроса вместо загрузки.
Можно ли загрузить больше одной LoRA?
Нет. Модели принимают один файл весов на запрос. Если нужны сразу два облика, заранее объедините LoRA в один файл.
Моя LoRA лежит в закрытом репозитории Hugging Face. Что делать?
Загрузите файл .safetensors туда, где он отдаётся без входа в аккаунт, и используйте эту прямую ссылку. Токены доступа к сторонним аккаунтам мы не принимаем.
Какие ограничения у API P-Image LoRA?
Соотношения сторон: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3; Референсные изображения: 5; Длина промпта (символов): 5,000; Максимальный размер загрузки: 10 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать P-Image LoRA без кода?
Да. Playground запускает P-Image LoRA на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.


