Коротко: составьте короткий список эндпоинтов по задаче и по той метке содержимого, которую живой каталог присваивает каждому, затем испытайте собственные брифы по несколько раз и считайте полезные результаты, а не завершённые задачи. Эндпоинт с меткой «смягчающий» возвращает успешную, оплаченную задачу с приглушённым изображением, поэтому зелёный статус ничего не доказывает. И SpicyAPI не сканирует ни запросы, ни результаты, поэтому проверки, которые держат ваш продукт в рамках закона и ваших собственных правил, вы строите сами. Метки и цены ниже — на начало октября 2026 года; источник истины — живой каталог API генерации изображений без цензуры.
Что метки содержимого значат для интеграции
Каждый эндпоинт изображений в каталоге несёт одну из четырёх меток. Из 59 активных эндпоинтов изображений в каталоге 40 помечены как «без цензуры», 3 — как смягчающие, 12 — как фильтрующие, и 4 не имеют метки (удаление фона, увеличение разрешения и подобные утилиты).
| Метка | Что делает API с брифом, выходящим за пределы модели | Что вы должны обработать сами |
|---|---|---|
| Без цензуры | Модель заявляет, что у неё нет фильтра содержимого, и SpicyAPI передаёт запрос, не добавляя сканирования. | Ваши собственные проверки до и после вызова. |
| Смягчающая | Задача завершается успешно и оплачивается, но изображение возвращается приглушённым. | Проверьте результат; код статуса об этом не сообщит. |
| Фильтрующая | Модель отказывает. Задача заканчивается состоянием failed с errorCode: "content_rejected". | Покажите нейтральное сообщение и не повторяйте запрос без изменений. Отказ обычно не оплачивается; на некоторых страницах моделей указано, что оплачивается, поэтому прочитайте страницу. |
| Без метки | Не измерено. | Не предполагайте ничего ни в одну из сторон. |
Метка принадлежит эндпоинту, а не семейству: у Wan 2.7 Pro задача «текст в изображение» смягчающая, а его эндпоинт редактирования работает без цензуры, поэтому бенчмарк, смешивающий их, сравнивает два разных обещания. Метка также носит чисто информационный характер: она говорит, чего ожидать, а не что гарантировано.
Поскольку платформенного сканирования нет, безусловные правила политики содержимого и использования становятся задачей вашего продукта: ничего сексуализированного с участием несовершеннолетнего, никакого интимного изображения узнаваемого реального человека без задокументированного согласия (включая подмену лица), никакой выдачи себя за другого. Поставьте перед вызовом проверку возраста, записи согласия для любых входных данных с реальным человеком и способ для пользователей сообщать о контенте. Более длинная версия — в статье «Building on a less restrictive model» (пока только на английском).
Короткий список по задаче, затем по метке и цене
Напишите одно предложение про первый рабочий процесс, например «отредактировать лицензированную фотографию одежды, изменив только фон». Оно покажет, какая задача вам нужна; задачи — это отдельные записи каталога с отдельными полями. Цены — это наименьшая цена «от» на каждой странице; разрешение, референсы и опции меняют итоговую сумму.
| Эндпоинт | Задачи | Метка | От | Для чего страница его называет |
|---|---|---|---|---|
| Qwen Image 3.0 | текст в изображение, редактирование | Без цензуры | $0.03 | Редактирование от одного до трёх референсных изображений, включая перенабор текста, уже присутствующего в кадре |
| Seedream 5.0 Pro | текст в изображение, редактирование | Без цензуры | $0.036 | Сборка кадра из референсных изображений (до десяти), каждому из которых задана своя роль |
| Z-Image Spicy | текст в изображение | Без цензуры | $0.0124 | Текст в изображение в точных размерах в пикселях, расширение промпта выключено, пока вы его не включите |
| Prefect Pony XL | текст в изображение | Без цензуры | $0.015 | Стоп-кадры аниме и иллюстрации по промптам в стиле тегов |
| Wan 2.7 Pro | текст в изображение, редактирование | Смягчающая (текст в изображение) | $0.075 | Одно изображение на большом холсте, 2k по умолчанию, до 4k; фильтрация различается по эндпоинтам |
| Krea 2 Medium | текст в изображение | Смягчающая | $0.03 | Одно изображение по длинному промпту в пяти распространённых соотношениях сторон, PNG по умолчанию; нет seed, чтобы перенаправить неудачный результат |
| Nano Banana 2 | текст в изображение, редактирование | Фильтрующая | $0.036 | Редактирование с использованием до четырнадцати референсных изображений, от 0.5K до 4K |
Это короткий список, а не рейтинг. Для продукта со взрослой аудиторией начинайте со строк без цензуры, которые совпадают с вашей задачей. Смягчающая строка работает, только если ваши брифы остаются далеко в пределах её границ; фильтрующая строка подходит для безопасной половины смешанного продукта. Prefect Pony XL ожидает теги через запятую и семь фиксированных размеров, поэтому передавайте ему промпты в стиле тегов, а не предложения-брифы, написанные для фотореалистичной модели.
Каждая страница модели ссылается на отчёт о тестировании, например Z-Image Spicy и Seedream 5.0 Pro, с реальными результатами — от намекающих до откровенных взрослых сцен — и медианным временем (около 18 s у Z-Image Spicy, около 70 s у Seedream 5.0 Pro). Прочитайте их сначала, а затем измерьте ожидание от создания задачи до доступного для скачивания результата, замеряя со своих собственных серверов.
Испытывайте свои брифы, а не безобидную замену
Пишите брифы с той интенсивностью, которую ваш продукт действительно будет предлагать, с вымышленными взрослыми персонажами или со входными данными, которые вам разрешено использовать. Набор безобидных замен может пройти смягчающий эндпоинт, потому что смягчение проявляется только тогда, когда бриф выходит за пределы модели. Держите брифы в приватном тестовом репозитории, а не в тикетах или публичных документах. Выполните каждую фикстуру три раза: этого достаточно, чтобы вскрыть нестабильность, и это достаточно дёшево, чтобы повторить после изменения.
| ID | Фикстура | Что она вам скажет |
|---|---|---|
| 01 | Ваш самый частый бриф в обычной интенсивности | Базовую долю полезных результатов |
| 02 | Тот же бриф в самой высокой интенсивности, которую вы разрешите | Отказывает ли эндпоинт, смягчает или выдаёт результат на верхней границе вашего диапазона |
| 03 | Три безобидные перефразировки фикстуры 01 | Меняет ли формулировка исход результата |
| 04 | Разрешённое исходное изображение с одной названной правкой (фон, цвет одежды, освещение) | Доходит ли правка и сохраняются ли защищённые части |
| 05 | Та же правка с двумя референсными изображениями, каждому из которых задана роль | Помогают ли дополнительные референсы или размывают результат и что они добавляют к цене |
| 06 | Формат кадра, который вы будете публиковать (например, 9:16) | Держится ли композиция в вашем реальном размере |
| 07 | Бриф, который обязано остановить ваше собственное приложение | Что ваша предварительная проверка блокирует его и задача не создаётся |
| 08 | Запрос, оборванный сразу после отправки | Что ваш клиент подхватывает существующую задачу, а не платит дважды |
Договоритесь о письменном правиле приёмки до запуска: субъект и композиция соответствуют брифу, защищённые области правки не изменены, интенсивность не мягче запрошенной, и нет изъяна в анатомии или надписях, который заметил бы клиент. Записывайте по два числа на кандидата: долю полезных результатов (результаты, прошедшие правило, делённые на завершившиеся задачи) и стоимость одного полезного результата (общие расходы, делённые на то же число), — именно это делает сравнимым дешёвый, но смягчающий эндпоинт с более дорогим, но надёжным. Для более полной шкалы оценки используйте руководство по бенчмарку API изображений.
Сначала попробуйте фикстуру в Playground
- Откройте страницу одного эндпоинта из короткого списка, например Z-Image Spicy: текст в изображение, и войдите в аккаунт с пополненным балансом. Форма находится на странице.
- Вставьте фикстуру 01 в поле Prompt и задайте размер кадра (здесь Width и Height; другие эндпоинты используют поле соотношения сторон или размера).
- Прочитайте цену под формой, нажмите Run и повторите запуск ещё два раза, чтобы увидеть разброс.
- Выполните фикстуры 02 и 03 так же, затем оцените каждый результат по своему правилу приёмки, прежде чем писать какой-либо код.
Кинокадры проходят через проектор и образуют одно готовое изображение.
Затем автоматизируйте тот же тест
Когда фикстура ведёт себя в Playground как ожидается, запустите её из файла. Расчёт бесплатен: он проверяет ровно то тело, которое вы отправили бы, ничего не создаёт и не удерживает средства.
spicyapi tasks quote --model alibaba/z-image-spicy/text-to-image --input-file fixture-01.jsonСоздайте задачу из того же файла командой tasks create; повторы, опрос и результаты описаны в документации по задачам и документации CLI.
Или поручите это агенту. С сервером MCP ассистент получает расчёт через spicyapi_task_quote, а npx skills add spicyapi-ai/spicy-skill устанавливает Agent Skill, который заставляет его читать живое описание схемы перед каждым вызовом.
Пять фактов меняют то, как вы строите тестовый стенд:
- Расчёт — самый дешёвый тест. Проведите через него каждую фикстуру до первого платного запуска и перепроверяйте метку каждого эндпоинта в CI, потому что метки могут меняться.
- Каждый эндпоинт принимает только свои имена полей; неизвестные поля отклоняются. Даже размер вывода записывается тремя способами: Z-Image принимает
aspect_ratio, Prefect Pony XL — единственное полеsize, Z-Image Spicy —widthиheight. Соберите по адаптеру на каждый эндпоинт из его живой схемы, а не один общий запрос. - Референсные изображения могут поднять цену. Каждое изображение после первого добавляется к расчёту Seedream 5.0 Pro, поэтому запрашивайте расчёт ровно для того тела, которое отправите, с настоящим числом референсных изображений.
succeededне значит пригодный результат. Это значит лишь, что модель вернула что-то; проверяйте каждый результат по своему правилу приёмки — именно там ловятся смягчённые изображения. Отказы обычно не оплачиваются.- Создание, ушедшее по таймауту, может всё же существовать. Отправьте его повторно с тем же ключом идемпотентности, чтобы не платить дважды; это и есть фикстура 08.
Ссылки на скачивание и созданные файлы истекают, поэтому копируйте одобренные изображения в своё хранилище вместе со ссылкой на задачу рядом с ними (статья о хранении медиа). Про опрос против вебхуков смотрите руководство «Polling versus webhooks» (пока только на английском).
Как принять решение
Исключите эндпоинты, которые не публикуют задачу, нужную вашему первому рабочему процессу. Исключите те, что не проходят фикстуры 07 и 08. Остальные сравните по доле полезных результатов и стоимости одного полезного результата на одних и тех же брифах. Предпочитайте эндпоинт без цензуры с лучшей долей для вашего диапазона интенсивности; смягчающий или фильтрующий эндпоинт оставляйте только там, где его пределы подходят брифу, и говорите об этом в текстах продукта, а не обещайте «что угодно». Резервный вариант должен пройти те же фикстуры.
Частые вопросы
Эндпоинт без цензуры — это автоматически лучший выбор для моего API?
Нет. Это значит, что фильтр не заявлен, а не то, что он последует вашему брифу или обойдётся дешевле за пригодное изображение.
Как понять, что смягчающий эндпоинт приглушил моё изображение?
Сравните фикстуру 02 с фикстурой 01: смягчающий эндпоинт сохраняет субъект, но теряет запрошенную интенсивность. Ничто в ответе на задачу об этом не сообщает.
Сколько стоит отказ?
Обычно ничего: неудачные задачи полностью освобождают удержание. На некоторых страницах моделей сказано, что определённые отказы оплачиваются, поэтому проверьте стоимость задачи, прежде чем считать, что это было бесплатно.
Можно ли тестировать на реальных фотографиях клиентов?
Не сразу. Используйте разрешённые или синтетические входные данные. Любые входные данные с реальным человеком требуют задокументированного согласия на конкретную правку и на распространение, а всё, что затрагивает несовершеннолетнего, запрещено всегда.
Значит ли завершённая задача, что я могу показать изображение пользователям?
Нет. Завершённая задача значит лишь, что модель вернула что-то. Проверьте результат по своему правилу приёмки — оно же ловит и смягчённый результат — и скопируйте одобренные изображения в своё хранилище до выдачи.
Как часто мне следует повторять проверки?
Перед запуском и после любого изменения модели, метки, цены или схемы.
