Обновления, которые важны для интеграции

Четыре новых места, где удобно выбрать модель. Все они построены на запусках на этой платформе. Рейтинги, обзоры и арена находятся в шапке сайта в разделе Оценки моделей, а библиотека промптов — в разделе Студия.

• Рейтинги оценивают каждую модель по двум независимым шкалам. Spicy Index (0–100) пока предварительный: он оценивает только возможности, а качество результата добавится, когда будут готовы наши тесты качества и наберётся достаточно голосов на арене. Freedom Score (0–100) показывает, насколько далеко модель подтверждённо проходит по нашей лестнице тестов контента. Шкалы никогда не смешиваются, а цена, скорость и надёжность приводятся рядом как сырые измерения. Есть рейтинги видео, изображений, LLM, моделей без цензуры, по соотношению цены и качества и по скорости; на 26 сентября ранжированы 53 модели по итогам 1 672 тестовых запусков, оценки пересчитываются ежедневно.
• Обзоры: пока восемь — MiniMax H3, MiniMax H3 Spicy, Seedance 2.5, Seedance 2.5 Spicy, Wan 3.0, Seedream 5.0 Pro, Z-Image Spicy и Grok 4.7. В каждом — реальные результаты, отчёт о тестах, стоимость пригодного результата и чёткая рекомендация.
• Слепая арена: два анонимных результата — изображение или видео — по одному промпту. Выберите тот, который оставили бы, и увидите, какие модели их сделали. Голоса вошедших пользователей формируют рейтинги Брэдли — Терри с 95-процентными интервалами, обновляемые каждый час; модели с пересекающимися интервалами делят место. Места появятся, когда наберётся достаточно голосов; до тех пор модели перечислены по разработчикам.
• Библиотека промптов: 176 промптов для видео- и графических моделей, каждый с результатом, который он действительно дал. Фильтруйте по модели, задаче, сцене или движению камеры, затем скопируйте промпт или откройте его в песочнице со всеми заполненными настройками.

Методика открыта и ведётся по версиям. Мы продаём доступ ко всем моделям, которые оцениваем, поэтому на той же странице объясняется, как это не влияет на оценки.

Четыре изменения в поведении задач. Два из них могут потребовать правок на вашей стороне: если вы рассчитываете, что одинаковые запросы дают одинаковый результат, передавайте seed; если ветвитесь по кодам ошибок, добавьте обработку 40310.

Неудачный запуск сначала повторяется по другому маршруту. Многие модели здесь доступны по нескольким маршрутам. С 23 сентября, если запуск падает после того, как мы его приняли, а другой маршрут обслуживает ту же модель с теми же настройками, мы запускаем задачу там и только потом сообщаем об ошибке — пока у задачи остаётся время. Оплата списывается один раз, за полученный результат. Ошибки, которые повторились бы где угодно, например отказ из-за авторских прав, не повторяются.

Отказы объясняют причину и способ исправить. Когда модель блокирует результат из-за возможного нарушения авторских прав или лица реального человека, errorMessage теперь говорит, что именно произошло и что попробовать:

• Видео чаще всего блокируется из-за сгенерированной звуковой дорожки: задайте generate_audio: false, уберите референсное аудио и не называйте в промпте реальные песни и исполнителей.
• Изображение обычно блокируется из-за известного персонажа, логотипа или произведения в промпте или в референсном изображении.
• Некоторые модели не принимают лица реальных людей в референсных изображениях. Сообщение говорит об этом и предлагает другую модель или нарисованного персонажа.

errorCode остаётся content_rejected, деньги возвращаются, а сообщение, как и любая другая ошибка, выводится на языке ошибок API вашего аккаунта.

Случайный seed, если seed не указан. С 24 сентября в моделях, которые принимают seed, запрос без него получает случайный seed, и он возвращается в input задачи. Два одинаковых запроса больше не дают одинаковый результат. Чтобы запуски оставались сопоставимыми, отправьте полученный seed обратно; фиксированный seed не гарантирует полностью одинаковый результат. Некоторые модели меняют seed, но не возвращают его. Seed, который вы передаёте сами, всегда используется как есть.

40310 для аккаунтов с неподтверждённой почтой. Ключи таких аккаунтов раньше получали общий 403. С 25 сентября они получают бизнес-код 40310 с сообщением: откройте ссылку подтверждения или запросите новую в консоли. Ключ начинает работать сразу после подтверждения адреса.

Вышли пять официальных SDK, а вместе с ними CLI, MCP-сервер, Agent Skill и прокси, позволяющий не держать ключ в клиенте. Все они реализуют одни и те же четыре шага: оценить стоимость, создать задачу с ключом идемпотентности, дождаться, забрать результат.

• В дерево зависимостей почти ничего не попадает. Python и Go обходятся стандартной библиотекой, PHP тоже не требует библиотек, а Java приносит ровно одну — Jackson.
• Весь асинхронный сценарий, а не только HTTP-вызов: бюджет ожидания при создании задачи, трёхшаговая загрузка собственных изображений и видео, проверка подписи вебхуков.
• @spicyapi/cli показывает каталог, называет цену до списания и скачивает готовые результаты прямо из терминала. @spicyapi/mcp даёт те же возможности Claude Code, Codex, Cursor и любому MCP-клиенту, спрашивая вас перед каждым платным шагом. Agent Skill ставится командой npx skills add Spicy-API/spicy-skill и обучает ассистента-программиста правильному порядку действий.
• @spicyapi/proxy оставляет ключ на вашем сервере. Ключ, вшитый в браузерное, мобильное или десктопное приложение, — это публичный ключ; данный пакет и есть серверный промежуточный узел, который хранит его вместо приложения.

Все пять — открытый код под лицензией MIT. Руководства: docs.spicyapi.ai

Два способа больше не писать цикл опроса. Оба доступны.

Бюджет ожидания при создании задачи. Добавьте ?wait=<секунды> к createTask — мы держим соединение открытым, пока задача не придёт в конечное состояние, и отвечаем полной записью задачи, в том же виде, что и recordInfo.

• Бюджет исчерпан: приходит обычный 202, точно такой же, как без этого параметра, и дальше вы опрашиваете сами.
• Соединение оборвалось: для задачи ничего не меняется. Она продолжает выполняться и списывается как обычно.
• Потолок — 60 секунд. Большие значения урезаются, а не отклоняются; некорректное значение игнорируется, а не отклоняется: опечатка в параметре оптимизации не должна ронять генерацию, которая иначе прошла бы успешно.

Имеет смысл на эндпоинтах, которые заканчиваются за секунды, то есть на большинстве задач по изображениям и редактированию. Видеомодели обычно работают минутами — там бюджет просто истечёт, и опрашивать всё равно придётся.

Вебхук-эндпоинты на уровне аккаунта. Зарегистрируйте URL один раз вместе со списком нужных событий, и каждая подходящая задача будет доставлена туда: передавать адрес обратного вызова в каждой задаче больше не нужно. На аккаунте помещается до 16 эндпоинтов, у каждого свой секрет подписи. Ответ 410 Gone от вашего сервера сразу отключает эндпоинт, вместо того чтобы продолжать стучаться по адресу, который владелец закрыл. Пока эндпоинты доступны только через API — в панели управления для них ещё нет экрана.

Подробности: задачи · вебхуки

403 примера покрывают 117 из 120 вызываемых эндпоинтов. Каждый — это задача, действительно выполненная на нашей платформе, а не концепт-картинка и не кадр, взятый из карточки модели. К каждому прилагаются три вещи:

• Готовый файл, отдаваемый с нашего собственного CDN и в исходном соотношении сторон.
• Полный объект входных данных, который его породил: промпт, размер, длительность, все параметры — можно скопировать прямо в свой вызов.
• Пояснение на всех десяти языках интерфейса: почему выбраны именно такие входные данные, под какое соотношение сторон писалась композиция, какой параметр здесь главный и что менять в первую очередь.

На странице модели они выстроены так, что их можно охватить одним взглядом; через API они приходят в поле examples ответа GET /console/v1/catalog/models/{slug}.

Раньше выбор модели сводился к чтению таблицы параметров и попыткам представить результат. Теперь видно, что эндпоинт выдаёт на самом деле, и можно начать с входных данных, про которые известно, что на нём они работают.

Открыть каталог