Введение
Z-Image Turbo LoRA Текст в изображение создаёт одно изображение по текстовому промпту на Z-Image Turbo от Alibaba — модели на 6 миллиардов параметров, дистиллированной до восьми шагов сэмплинга, — и подгружает до трёх ваших файлов LoRA. Выберите любое из девяти соотношений сторон примерно в один мегапиксель и получите JPEG, PNG или WebP по единой цене. Платформа не добавляет фильтр контента ни к промпту, ни к весам, ни к изображению.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| текстовое описание | Z-Image Turbo LoRA Текст в изображение |
| картинка, которой нужен новый стиль | Z-Image Turbo LoRA Изображение в изображение |
Ключевые возможности и особенности
Восемь шагов, секунды на изображение
Z-Image Turbo дистиллирована до восьми шагов сэмплинга. В наших прогонах модель тратила примерно от трёх до десяти секунд на изображение, поэтому подбирать силу LoRA и промпты удобно короткими циклами.
Большая библиотека LoRA от сообщества
Z-Image Turbo — одна из самых популярных основ для дообучений сообщества: на Hugging Face опубликованы сотни LoRA — реализм, живопись, пиксель-арт, персонажи и концепции, которые отказываются принимать другие хосты. Передайте прямую ссылку на файл и масштаб; заранее ничего нам не загружается.
Без цензуры со своими весами
С подходящим загруженным LoRA наша самая сильная контентная проба вернулась как написано, а без него базовая модель не сдерживалась. Веса никогда не проверяются, а результат никогда не фильтруется.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Сначала триггерное слово LoRA, затем герой, обстановка и свет. Простые описательные предложения работают лучше списков ключевых слов. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | Девять вариантов от 21:9 до 9:21, все примерно в один мегапиксель и по одной цене. |
loras | Нет | До трёх записей {path, scale}, обученных под Z-Image Turbo; scale от 0 до 4, 1 — нейтрально. Нужна публичная прямая ссылка на файл .safetensors. По умолчанию: |
output_format | Нет | По умолчанию JPEG, при необходимости PNG или WebP. На цену не влияет. |
seed | Нет | Держит набор изображений сопоставимым, пока вы меняете scale одной LoRA за раз. |
Стоимость
$0.012 / изображение
Оплата за изображение по единой цене при любом соотношении сторон. Загрузка LoRA отдельно не тарифицируется.
Сценарии использования
Стилевые серии по единой цене
Каждое изображение стоит одинаково при любом соотношении сторон, поэтому стилевая LoRA плюс список промптов превращаются в цельный набор иллюстраций, постеров или превью с предсказуемым счётом. Зафиксируйте seed для каждой компоновки и меняйте только строку с героем.
Листы персонажа
Зафиксируйте LoRA на персонажа и seed и между промптами меняйте только наряд, место и свет. Лицо и телосложение остаются узнаваемыми во всём наборе, а листу персонажа нужно именно это.
Кадры без цензуры для вашей платформы
Подгрузите LoRA, которую ждёт ваша аудитория, и опишите изображение напрямую. Нет ни флага контента, ни повторной проверки результата, поэтому пользователи получают ровно то, что просили.
Руководство по промптам и практические советы
Сначала триггерное слово
Большинство LoRA для Z-Image Turbo обучены с триггером вроде «Realism» или «Pixel art style». Поставьте его в самое начало, а затем опишите сцену простыми предложениями: кто в кадре, во что одет, где находится и какое сейчас время суток.
Описывайте свет, а не прилагательные
Назовите источник света, его направление и цвет: дождь на окне, тёплая лампа на лице, неон позади. Конкретный свет срабатывает лучше слов вроде «кинематографично», и это самый быстрый способ добиться, чтобы реалистичная LoRA выглядела как фотография.
Меняйте по одному scale за раз
Складывая LoRA, зафиксируйте seed и сдвигайте один scale примерно на 0,2 за шаг. Две стилевые LoRA на полной силе обычно спорят; начните вторую примерно с 0,5 и поднимайте, пока её облик не проявится, не поглотив первую.
Черновик сразу в формате публикации
Выберите соотношение сторон до начала итераций. Композиция в 1:1 и в 21:9 строится по-разному, а раз все соотношения стоят одинаково, нет смысла делать черновик квадратным и кадрировать потом.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/z-image-turbo-lora/text-to-image",
"input": {
"aspect_ratio": "1:1",
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
