Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
image_url | Да | Картинка, с которой всё начинается. |
loras | Нет | Загрузите свои LoRA, чтобы закрепить стиль или персонажа. По умолчанию: [] |
output_format | Нет | Формат файла результата. jpeg · png · webp · По умолчанию: jpeg |
prompt | Да | Describe the image you want back, not just the change. |
resolution | Нет | Размер результата. Больше — чётче и дороже. 1k · 1.5k · По умолчанию: 1k |
seed | Нет | Одно и то же число даёт повторяемый результат. ≥ 0 · ≤ 2147483647 |
strength | Нет | Насколько результат может отойти от исходника. ≥ 0 · ≤ 1 · По умолчанию: 0.8 |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| Стандарт | 1,8 | 0,018 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 2 кредита за изображение (0,02 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Z-Image Turbo LoRA в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model alibaba/z-image-turbo-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": "alibaba/z-image-turbo-lora/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "1k",
"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 Z-Image Turbo LoRA
Сколько стоит API Z-Image Turbo LoRA?
Z-Image Turbo LoRA стоит от 2 кредита (0,02 $) за изображение — на самой дешёвой задаче «Редактировать картинку». Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Z-Image Turbo LoRA в API?
Укажите alibaba/z-image-turbo-lora/text-to-image — Создать картинку; alibaba/z-image-turbo-lora/edit — Редактировать картинку в поле model запроса POST /jobs/createTask.
Какие LoRA здесь работают?
Файлы, обученные под Z-Image Turbo. На Hugging Face их сотни; передайте прямую ссылку на скачивание файла .safetensors. LoRA, сделанные для FLUX, SDXL или Qwen-Image, не подойдут.
Что делает сила в режиме «изображение в изображение»?
Задаёт, насколько далеко результат может уйти от исходника. Значение по умолчанию 0,8 сохраняет композицию и позу, меняя стиль; на 0,6 изменения едва заметны; при значениях около 1 исходник служит лишь приблизительным ориентиром.
Можно ли сложить несколько LoRA?
Да, до трёх на запрос, у каждой свой scale. Дополнительные LoRA начинайте примерно с 0,5: две стилевые LoRA на полной силе обычно конкурируют.
Какие ограничения у API Z-Image Turbo LoRA?
Разрешения: 1K · 1.5K; Длина промпта (символов): 5,000; Максимальный размер загрузки: 10 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Z-Image Turbo LoRA без кода?
Да. Playground запускает Z-Image Turbo LoRA на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Z-Image
Z-Image Base LoRA запускает полную, более медленную базовую модель для LoRA, обученных на ней.


