Введение
Z-Image Spicy превращает бриф без цензуры или обычный в одно изображение заданных вами размеров. Это отдельный уровень без цензуры, а не универсальная модель с ослабленными настройками: между запросом и моделью нет ни флага зрелости, ни декларации, ни сканера.
Z-Image Spicy — уровень без цензуры линейки Z-Image: точные ширина и высота в пикселях до 1536, поле промпта без ограничения длины, необязательное расширение промпта, по умолчанию выключенное, и ни одного фильтра контента на всём пути.
Ключевые возможности и особенности
Отдельный уровень для изображений без цензуры
Z-Image Spicy рассчитан на визуальные брифы без цензуры, а не на универсальный маршрут с ослабленными ограничениями. Чётко обозначьте предполагаемый контекст, объект и визуальное решение, а затем сверьте результат с брифом и действующими правилами.
Выверенные формулировки — часть арт-дирекции
Храните утверждённый бриф вместе с выбранным результатом. Тогда следующая вариация сможет изменить одно визуальное решение, не меняя незаметно замысел или границы запроса.
Проверяйте композицию там, где она будет использоваться
Оценивайте объект, позу, сцену и свет в том месте, где будет использовано изображение. Правдоподобного превью недостаточно, если выбранный кадр при сдаче теряет нужное визуальное соотношение.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Потолка по символам нет. Тратьте объём на направление света, материал одежды, плёночную фактуру и палитру; формулировки при выключенном расширении проходят как написаны. Не менее 1 символов |
width | Нет | Ширина результата в пикселях, от 256 до 1536, задаётся независимо от высоты. Держите длинную сторону примерно в пределах двух коротких, если пустота не задумана специально. |
height | Нет | Высота результата в пикселях, от 256 до 1536, задаётся независимо от ширины. Генерация сразу в высоту места избавляет от обрезки, которая уводит героя оттуда, где его ждёт вёрстка. |
enable_prompt_expansion | Нет | Переписывает короткий prompt в длинный до генерации. По умолчанию: |
seed | Нет | Передайте тот же seed с тем же prompt и теми же размерами, чтобы выборка между двумя прогонами осталась одинаковой: это делает их сопоставимыми, но одинаковую картинку не гарант… |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.01235 / изображение |
| $0.0133 / изображение |
Сценарии использования
Начать с письменного брифа
Используйте этот эндпоинт для брифов без цензуры или обычных, которым нужен точный размер в пикселях. Задайте width и height от 256 до 1536, оставьте enable_prompt_expansion выключенным, чтобы формулировки дошли в том виде, в каком вы их написали, и зафиксируйте seed, когда образ получился.
Промпты, которые отклоняют другие API изображений
Формулировки, которые отклоняют эндпоинты с фильтрами, проходят без изменений, а при выключенном расширении их никто не перефразирует по пути. Тот же жизненный цикл задачи, что и у любой другой модели здесь: создать, опросить, забрать из хранилища платформы.
Материалы точно под размер размещения
Арт для карточки 832x1216, шапка 1536x512, квадратное превью 512x512 — всё с одного эндпоинта, всё нативно, а не обрезано, так что объект остаётся там, где его ждёт макет.
Портретные и модные серии
Жёсткий свет сквозь жалюзи, смятый лён, кружево и шёлк в выбранном вами размере. Когда образ получился, зафиксируйте seed и проведите того же человека через несколько интерьеров и нарядов, чтобы собрать серию, которая читается как одна съёмка.
Руководство по промптам и практические советы
Напишите полный бриф, расширение выключено
Лимита символов нет, поэтому опишите полностью одежду, направление света, плёночный вид и палитру. Опубликованный кадр получен по промпту: «Photograph of an adult woman lying on her side across rumpled white linen in a black lace bodysuit, morning sun through venetian blinds casting hard stripes across her skin and the sheets, one arm stretched above her head, eyes closed, calm and warm, medium format film look, soft grain, honey and cream palette.»
Задавайте кадр в пикселях
Задавайте ширину и высоту под размещение, а не выбирайте соотношение сторон: 1024x1536 для вертикального портрета, 1536x640 для шапки, 512x512 для превью. Обе стороны принимают любые значения от 256 до 1536.
Адаптируйте приложенный пример
Начните с опубликованного примера с height: 1536 и width: 1024. Замените объект и творческое направление, сохранив контракт входных данных этого режима.
Photograph of an adult woman lying on her side across rumpled white linen in a black lace bodysuit, morning sun through venetian blinds casting hard stripes across her skin and the sheets, one arm stretched above her head, eyes closed, calm and warm, medium format film look, soft grain, honey and cream palette.
Промпт, по которому получен референсный кадр этого эндпоинта, в 1024x1536 и с выключенным расширением, чтобы формулировки дошли до модели нетронутыми. Показанное изображение сделано на уровне Turbo той же линейки как референс стиля.
Проверьте результат, прежде чем повторять
1536 пикселей — потолок по каждой стороне, так что это не уровень для материалов печатного размера: генерируйте здесь и увеличивайте в другом месте, если нужен большой кадр. Крайние сочетания сторон выходят за пределы того, что модель хорошо компонует; держите длинную сторону не больше примерно двух коротких, если пустое пространство не задумано. Выключенный enable_prompt_expansion — более надёжный путь для брифов без цензуры: включённый может обобщить точные формулировки, которые вы выбрали. На этом эндпоинте нет ни негативного промпта, ни входного изображения.
Быстрый старт 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-spicy/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"enable_prompt_expansion": false
}
}'
# 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.
