Введение
Z-Image Spicy Pro превращает бриф без цензуры или обычный в одно изображение заданных вами размеров с потолком 2560 пикселей по каждой стороне. Это отдельный уровень без цензуры: ни флага зрелости, ни декларации, ни сканера между запросом и моделью.
Z-Image Spicy Pro — крупноформатный уровень без цензуры линейки Z-Image: ширина и высота задаются независимо до 2560 пикселей, поле промпта без ограничения длины, необязательное расширение промпта, по умолчанию выключенное, и никакого фильтра контента.
Ключевые возможности и особенности
Отдельный уровень для изображений без цензуры
Z-Image Spicy Pro рассчитан на визуальные брифы без цензуры, а не на универсальный маршрут с ослабленными ограничениями. Чётко обозначьте предполагаемый контекст, объект и визуальное решение, а затем сверьте результат с брифом и действующими правилами.
Больше пространства для кадров под сдачу
Уровень Pro предназначен для работ, которым нужен более детальный финальный кадр, чем на раннем этапе поиска идеи. Оценивайте детали — материал, свет, композицию — в запланированном месте размещения, а не на увеличенном превью.
Сохраняйте выверенные формулировки
Когда формулировка брифа без цензуры важна, храните утверждённую версию вместе с результатом. Исследовательская переписка может изменить замысел запроса, поэтому сравнивайте каждую последующую вариацию с исходными ограничениями.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Потолка по символам нет. Конкретное описание направления света, ткани, палитры и объектива в этом размере работает хорошо; нагромождение прилагательных — нет. Не менее 1 символов |
width | Нет | Ширина результата в пикселях, от 256 до 2560, по умолчанию 1024. |
height | Нет | Высота результата в пикселях, от 256 до 2560, по умолчанию 1024. |
enable_prompt_expansion | Нет | Переписывает короткий prompt в длинный до генерации. По умолчанию выключен; для брифов без цензуры так и оставьте — пересказ описания без цензуры возвращается скромнее написанного. По умолчанию: |
seed | Нет | Передайте тот же seed с тем же prompt и теми же размерами, чтобы выборка между двумя прогонами осталась одинаковой: это делает их сопоставимыми, но одинаковую картинку не гарант… |
Стоимость
$0.019 / изображение
Сценарии использования
Начать с письменного брифа
Используйте этот эндпоинт для брифов без цензуры или обычных, которым нужен большой кадр: width и height принимают значения от 256 до 2560 и по умолчанию равны 1024, так что размер для сдачи задавайте явно. Оставьте enable_prompt_expansion выключенным, и формулировки дойдут так, как написаны.
Редакционные съёмки без цензуры в полный размер
High-key портреты, композиции от первого лица и модные редакционные съёмки в 1728x2560, чтобы кадр сразу шёл в вёрстку. Никакого этапа апскейла, который выдумывает детали кожи, которых никогда не было в рендере.
Промпты, которые отклоняют другие API изображений
При выключенном расширении формулировки проходят без изменений, а запрос выглядит так же, как для любой другой модели здесь: создать задачу, опросить, забрать файл из хранилища платформы. Ничто в материалах без цензуры не идёт другим путём в коде.
Макеты, близкие к печати
2560x1440 и 2048x2560 дают достаточно пикселей для макета, который будут проецировать или печатать в небольшом формате. Ниже этого потолка ничему не нужен апскейлер — а именно на нём большинство конвейеров без цензуры теряет фактуру.
Руководство по промптам и практические советы
Пишите полный бриф, расширение выключено
Описывайте свет, ткань, позу и обстановку конкретными словами. Пример Pro на этой странице использует чёрный атласный топ, шёлковые брюки и тёплую лампу в гостинице в размере 1728 × 2560. Бриф ниже — это записанный промпт для этого изображения; при адаптации обращайте внимание на атлас, кружевную отделку и руки.
Сравнивайте в размере для публикации
Сначала выберите итоговые размеры. Все допустимые размеры сейчас имеют одинаковую цену за изображение, поэтому черновик 1024 × 1024 не снижает стоимость вызова. Фиксируйте seed и размеры, меняя по одному элементу описания. Планируйте бюджет по числу вариантов. Seed 0 запрашивает новое случайное изображение.
Адаптируйте приложенный пример
Начните с записанного примера Pro: width: 1728, height: 2560, seed: 4217. Расширение промпта по умолчанию выключено. Меняйте комнату, свет или одежду по одному и сохраняйте выбранный промпт вместе с изображением.
Photograph of an adult woman in her thirties lying back across a hotel bed in an opaque black satin bralette with a thin scalloped lace trim along the edges and high-waisted black silk trousers, one arm above her head, looking at the camera with a slow smile. Low warm bedside lamp, city lights through the window, 50mm, soft film grain, editorial lingerie campaign.
В примере низкая тёплая прикроватная лампа сочетается с огнями города за окном. В итоговом размере сравните лицо, поднятую руку, края кружева и разделение чёрного атласа и шёлковых брюк.
Проверьте результат, прежде чем повторять
2560 пикселей по стороне — потолок; оба размера по умолчанию равны 1024, так что большой кадр нужно запрашивать явно. Крайние пары — очень длинная сторона против короткой — выходят за пределы того, что модель хорошо компонует, поэтому держите длинную сторону не больше примерно двух коротких, если пустое пространство не задумано. Выключенный 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-pro/text-to-image",
"input": {
"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.
