Введение
Z-Image Base LoRA Текст в изображение рисует одно изображение по текстовому промпту, подгружая до трёх ваших файлов LoRA. Он работает на Z-Image — базовой модели на 6 миллиардов параметров от команды Tongyi-MAI из Alibaba: недистиллированной версии, которую авторы называют отправной точкой для дообучения и обучения LoRA. Выберите любое из девяти соотношений сторон. Платформа не добавляет фильтр контента ни к промпту, ни к весам, ни к изображению.
Выберите режим по исходному материалу
| Что у вас есть | Режим |
|---|---|
| текстовое описание | Z-Image Base LoRA Текст в изображение |
| картинка, которой нужен новый стиль | Z-Image Base LoRA Изображение в изображение |
Ключевые возможности и особенности
Версия, на которой обучают LoRA
Z-Image выходит в быстрой дистиллированной версии Turbo и в этой полной версии Base. Издатель рекомендует Base для дообучения; LoRA, обученная на ней и загруженная здесь, в наших тестах меняла весь облик.
Три сразу
До трёх LoRA на запрос, у каждой свой scale от 0 до 4. Заранее ничего загружать к нам не нужно, а файлы не проверяются.
Фотографии по умолчанию
Без LoRA модель рисует фотографичные изображения с естественной кожей, светом и зерном и близко следует длинным описательным промптам.
Без фильтра контента
Фильтра нет ни для промптов, ни для весов, ни для результатов. Базовая модель без колебаний отрисовала каждый уровень, от Мягкого до Максимального, кроме Очень сильного: тот вышел размытым, а не заблокированным; для этого и нужны LoRA без фильтра.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Лучше всего работают полные предложения: герой, одежда, место, свет и объектив. Триггерную фразу LoRA ставьте первой. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | Девять форматов около одного мегапикселя, от 21:9 (1536 x 640) до 9:21; по умолчанию 1:1. Соотношение меняет форму кадра, а не цену. |
loras | Нет | До трёх записей {path, scale}, обученных на Z-Image Base; scale от 0 до 4, 1 — нейтрально. LoRA для Turbo несовместимы. По умолчанию: |
output_format | Нет | По умолчанию JPEG, при необходимости PNG или WebP. На цену формат не влияет. |
seed | Нет | Держит набор изображений сопоставимым, пока вы меняете по одной LoRA или одному предложению. Не гарантирует одинаковых пикселей при каждом запуске. |
Стоимость
$0.014 / изображение
Оплата за изображение. Соотношение сторон, формат вывода и загрузка LoRA на цену не влияют.
Сценарии использования
Фирменный стиль для целой серии
Подгрузите стилевую LoRA, держите её триггерную фразу в начале и прогоните список промптов. У всех изображений серии будет общий облик.
Ваши собственные LoRA
Если вы обучаете на Z-Image Base, проверяйте результат здесь в полном качестве, не держа собственный GPU.
Фотографичные кадры
Портреты, журнальные и кинематографичные кадры по предложениям, в девяти форматах от 21:9 до 9:21.
Руководство по промптам и практические советы
Пишите предложениями
Описывайте героя, одежду, место, свет и объектив полными предложениями. В наших тестах модель точно следовала таким деталям, как чашка кофе в обеих руках или чайки на пирсе.
Учитывайте триггерную фразу
Модель настолько строго следует промпту, что триггерная фраза LoRA сама по себе может изменить стиль. Сравнивайте прогоны с файлом LoRA и без него, а не только с фразой и без неё.
Берите LoRA для Base, а не для Turbo
LoRA, обученная на Z-Image Turbo, в нашем тесте разваливала картинку на этой версии, не выдавая ошибки. Ищите LoRA, обученные на Z-Image Base.
Закладывайте время
Base делает намного больше шагов сэмплинга, чем Turbo: в наших тестах запрос на текст в изображение занимал от 10 до 57 секунд времени модели, обычно около полуминуты.
Быстрый старт 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-base-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.
