Консоль и команды

Консоль на spicyapi.ai/console — это место, где вы управляете аккаунтом в веб-браузере: деньгами, API-ключами, логами, коллегами и настройками. Ваши собственные программы консолью не пользуются никогда. Они обращаются к API с API-ключом.

Вы здесь впервые? Сначала пройдите страницу Подготовка аккаунта: она по порядку проводит через регистрацию, пополнение баланса и создание ключа. Эта страница — справочник по всему остальному, что есть в консоли.

Как ориентироваться в консоли

Вверху каждой страницы: ваш баланс с кнопкой Пополнить, Модели, Документация, колокольчик уведомлений и Найти страницу (нажмите ⌘K в macOS или Ctrl + K в Windows и Linux, затем начните вводить название страницы консоли).

Слева — боковая панель. На самом её верху находится переключатель области: он определяет, какой аккаунт или какую команду вы сейчас просматриваете (см. Личная область и команды). Ниже страницы сгруппированы так:

На телефоне боковая панель открывается кнопкой меню.

Все страницы консоли коротко

Все адреса начинаются с https://spicyapi.ai. В адресах консоли нет префикса языка.

Что делает каждая страница

Обзор

Первая страница, которую вы видите после входа.

• Чек-лист Начало работы: Подтвердить почту, Пополнить баланс, Запустите первую задачу, а также ссылки для тех, кто собирается разрабатывать через API или создавать без кода. Когда всё сделано, уберите его кнопкой Скрыть начало работы.
• Доступный баланс, сумма, зарезервированная под ещё выполняющиеся задачи, и то, сколько вы потратили за последние 7 дней.
• Запросы за последние 7 дней и Ошибки за последние 7 дней со ссылками Посмотреть расход и Посмотреть логи.
• Недавно использованные модели и Последние задачи.
• Предупреждение, когда баланс подходит к концу или пуст. При пустом балансе новые задачи отклоняются, пока вы его не пополните; уже принятые задачи всё равно завершаются.

Биллинг

На странице «Биллинг» три вкладки: Обзор, Использование и Счета.

Биллинг → Обзор (/console/billing)

• Пополнить баланс можно картой, криптовалютой или, если такой вариант вам доступен, ручным переводом. Пошаговые инструкции, сроки зачисления и что делать, если платёж не появился, — в разделе Подготовка аккаунта → Пополните баланс.
• Заявки на пополнение: каждое пополнение с его статусом (Ожидает, Оплачена, Отменена, Возврат выполнен). Откройте ожидающую заявку на ручной перевод кнопкой Завершить оплату, чтобы увидеть инструкции по оплате, отправить идентификатор транзакции или нажать Отменить ожидающую заявку, если вы ещё не платили.
• Автопополнение: сохраните карту, и мы будем пополнять баланс, когда он подходит к концу. Точные правила, в том числе что происходит при неудачном списании, — в разделе Подготовка аккаунта → Автопополнение.
• Состав баланса: этот блок показывается, только если у вашего аккаунта есть бонусные средства или одобренная кредитная линия. Каждая партия бонусных средств указана со сроком действия.
• История баланса: каждое движение денег, сначала новые. Фильтруйте по типу и периоду или нажмите Выгрузить CSV. Типичные записи — Пополнение, Бонус, Удержано (сумма, отложенная при приёме задачи), Списание (окончательная цена успешной задачи), Удержание снято (неиспользованная часть резерва вернулась) и Возврат (весь резерв возвращён после ошибки или истечения срока). Как устроено списание, описано на странице Оплата.

Биллинг → Использование (/console/billing/usage)

Задачи и расходы по дням в виде графика — за последние 7, 30 или 90 дней или за свой период длиной до 92 дней (дни считаются по UTC). Под графиком — блок По моделям: задачи, ошибки, расходы и доля каждой модели, а ссылка Посмотреть задачи переносит к этим задачам в «Логах». Выгрузить CSV скачивает показанные дневные итоги. Эндпоинт использования в API сообщает данные только о том ключе, которым его вызвали; эта страница показывает всю область, выбранную в боковой панели.

Биллинг → Счета (/console/billing/invoices)

Здесь вы вводите реквизиты для счетов, выписываете счёт на оплату за уже оплаченное пополнение или выписку о расходах за закрытый месяц и создаёте ежемесячные Выписки по счёту (CSV). Чем эти документы отличаются друг от друга и как исправить документ — в разделе Подготовка аккаунта → Счета и чеки.

Ключи API

Здесь вы создаёте, редактируете и отзываете ключи, которыми пользуются ваши программы. В списке у каждого ключа видны его замаскированное значение, сколько им уже потрачено, лимиты, разрешённые модели, список разрешённых IP, срок действия и время последнего использования. Искать можно по названию или замаскированному ключу, а фильтровать — по статусу Активен, Истёк или Отозван.

• Создать ключ создаёт ключ в области, выбранной в боковой панели. Полный ключ показывается один раз.
• Редактировать меняет название, лимиты расходов (дневной, месячный, общий), разрешённые модели, список разрешённых IP и срок действия. При редактировании пустое поле лимита означает отсутствие лимита.
• Отозвать немедленно останавливает ключ, и это нельзя отменить. Уже принятые задачи продолжают выполняться и оплачиваются.

Каждое поле подробно описано в разделе Подготовка аккаунта → Создайте API-ключ. Какие коды ошибок даёт каждое ограничение, сказано на странице Аутентификация.

В команде: создавать ключи команды и управлять ими можно только с ролью Владелец, Администратор или Разработчик. Расход и лимиты ключа команды засчитываются команде, а его задачи оплачивает владелец команды.

Вебхуки

Вебхук — это сообщение, которое SpicyAPI отправляет на ваш собственный сервер, когда задача завершается, чтобы вам не приходилось постоянно спрашивать самим. Адрес вы указываете для каждой задачи в поле callBackUrl. Эта страница делает две вещи.

Ключ подписи вебхука. Каждый обратный вызов подписан, чтобы ваш сервер мог проверить, что он действительно пришёл от SpicyAPI. У вашего аккаунта один ключ подписи, общий для всех его API-ключей, и его значение показывается только один раз — в момент создания. У новых аккаунтов уже есть ключ, который никто не видел, поэтому на карточке может быть написано Настроен, хотя копировать вам нечего:

1. Нажмите Создать (если на карточке написано Не задан) или Сменить (если написано Настроен).
2. Скопируйте новый ключ в настройки своего сервера — обычно в переменную SPICY_WEBHOOK_SECRET.
3. Нажмите Готово, ключ сохранён.

Доставки вебхуков. Все попытки обратного вызова для вашего аккаунта, сначала новые, с фильтром Доставлено, Повторяется и Ошибка, числом попыток и временем следующей попытки. Повторить отправляет исходное подписанное сообщение ещё раз, поэтому убедитесь, что ваш сервер без вреда принимает одно и то же сообщение дважды. Доставку, сохранённое содержимое которой уже удалено по вашим настройкам хранения, повторить нельзя.

Интеграции

Готовые настройки, которые можно скопировать и вставить, для инструментов, работающих со SpicyAPI. Выберите инструмент, чтобы увидеть его настройки и кнопку Открыть документацию.

• Основы подключения: базовый URL для клиентов, совместимых с OpenAI, и быстрая ссылка Создать ключ. Называйте ключ по инструменту, который будет им пользоваться.
• Официальные инструменты: TypeScript SDK, CLI, MCP-сервер и Agent Skill.
• OpenAI‑совместимые клиенты: инструменты, в которых можно сменить базовый URL, для текстовых и видеомоделей. Генерации изображений на совместимых эндпоинтах нет.
• Кодовые агенты: редакторы и агенты, к которым подключается MCP-сервер; он просит вас подтверждать каждое списание.

В примерах стоит заполнитель MODEL_ID_FROM_CATALOG: замените его точным ID модели из актуального каталога (GET /api/v1/models, spicyapi models list или listModels()). См. Модели и эндпоинты.

Логи

Все задачи, сначала новые, включая завершившиеся ошибкой. В каждой строке видны задача, модель, статус, задержка и стоимость.

• Фильтры: статус, модель и период. Поле поиска принимает точный ID задачи или ID запроса — это самый быстрый способ найти задачу, о которой пришло сообщение об ошибке. На странице загружается до 500 строк; чтобы увидеть больше, сузьте фильтры.
• Экспорт CSV выгружает все задачи, подходящие под фильтры: по умолчанию за последние 30 дней, но не больше чем за 92 дня и не больше 10 000 строк.
• Открыть подробности у задачи показывает её состояние, стоимость, время начала и завершения, использованный ключ, ID задачи и ID запроса, код ошибки и Причину сбоя, параметры запроса, ответ и ссылки на скачивание (Получить ссылку; каждая ссылка истекает, и можно получить новую).

В блоке стоимости во время выполнения показан резерв, а после расчёта — фактически списанная сумма. Неуспешная задача тоже может быть платной при отказе по содержанию, прямо указанном на странице модели. Проверяйте расчёт, а не делайте вывод о возврате только по состоянию.

В подробностях задачи есть три действия:

Ни одно из этих действий не отменяет выполняющуюся задачу: принятые задачи отменить нельзя. Что удаление сохраняет и что стирает, описано на странице Хранение и удаление данных.

В команде: все участники видят задачи команды со статусом и стоимостью. Промпты, результаты и ссылки на скачивание видят только Владелец, Администратор и Разработчик. Три действия из таблицы доступны только аккаунту, который оплатил задачу.

Команда

Здесь вы создаёте команды, приглашаете людей, меняете роли, задаёте лимиты расходов команды, выходите из команды или передаёте её. Работаете в одиночку? Команда вам не нужна: ваши ключи, баланс и расход и так работают сами по себе. Всё о командах собрано ниже в разделе Команды.

Настройки

Одна страница, разделённая на группы.

Аккаунт

• Электронная почта с пометкой Подтверждена или Не подтверждена. Сменить адрес для входа можно кнопкой Изменить адрес для входа: мы отправим ссылку для подтверждения на новый адрес (она действует 20 минут) и предупредим старый. Понадобится ваш текущий пароль.
• Отображаемое имя, ID аккаунта (назовите его, когда обращаетесь в поддержку) и Дата регистрации.

Безопасность

• Пароль. При смене пароля выполняется выход на всех устройствах. У аккаунта, созданного через Google или GitHub, пароля нет, пока вы не нажмёте Отправить ссылку для настройки и не зададите его; пароль нужен, чтобы закрыть аккаунт или передать команду.
• Активные устройства. Нажмите Завершить сеанс у любого устройства, которое вы не узнаёте, или Выйти на всех устройствах (включая это), если думаете, что кто-то ещё получил доступ. Сразу после этого смените пароль.
• Двухфакторная аутентификация. Нажмите Настроить 2FA, введите текущий пароль, добавьте аккаунт в приложение-аутентификатор и введите шестизначный код из него. С этого момента при каждом входе будет запрашиваться код. Вы также получите десять одноразовых кодов восстановления: храните их не на телефоне, потому что без телефона только они позволят вернуться в аккаунт, а показать их повторно нельзя. Новые коды восстановления заменяют все прежние коды; Отключить 2FA снимает защиту. Оба действия сначала просят подтвердить, что это вы.
• Журнал безопасности: недавние входы, новые устройства и изменения учётных данных.

Настройки

• Язык ошибок API: язык поля msg в ответах с ошибкой и поля errorMessage у задачи (при проверке статуса и в вебхуках) для запросов, отправленных с вашими API-ключами. По умолчанию — английский. Собственный заголовок запроса Accept-Language важнее этой настройки, а коды, по которым стоит ветвить логику (code, errorCode), никогда не меняются. См. Ошибки и повторы.

Оплата и данные

• Быстрые ссылки на Платёжные данные и выписки (на вкладке «Биллинг → Счета») и Данные и конфиденциальность (страница «Защита данных»).

Опасная зона: Закрыть аккаунт

При закрытии аккаунта выполняется выход на всех устройствах, все API-ключи отзываются навсегда, а созданные медиафайлы и хранящееся содержимое задач удаляются. Платёжные записи, записи аудита и сверки сохраняются, как описано в Политике конфиденциальности. Заявки на пополнение, которые вы бросили и не оплатили, отменяются за вас. Закрытие откладывается, только пока:

• есть задачи в очереди или выполняющиеся, либо завершённые задачи ещё проходят окончательное списание (обычно в течение минуты);
• платёж за пополнение ещё обрабатывается (это проходит само, как только платёжный провайдер подтвердит или освободит платёж, обычно за несколько минут; если через час он всё ещё висит, обратитесь в поддержку);
• за аккаунтом есть долг (используемый одобренный кредит или отрицательный баланс), который закрывается пополнением;
• команду, которой вы владеете, ещё нужно передать другому участнику или освободить от остальных участников.

Консоль перечисляет всё, что ещё мешает. Закрытие подтверждается текущим паролем или, если вы зарегистрировались через Google или другого провайдера входа и пароля у вас нет, 6-значным кодом, который мы отправим на почту (действует 15 минут).

Уведомления

• Оповещение о низком балансе. Включите его и выберите порог ($5, $10, $25, $50 или $100). Когда доступный баланс опустится ниже порога, вы получите одно оповещение в колокольчике, а если у аккаунта есть адрес почты — ещё и письмо. Повторное оповещение придёт, только если баланс сначала поднимется до порога или выше, а потом снова опустится ниже. Баланс проверяется примерно раз в 10 минут.
• Обновления отслеживаемых моделей. Отслеживать модель можно на её странице на spicyapi.ai; кнопка Управлять открывает список отслеживаемых моделей и новостей продукта.
• Доставка. Оповещения в приложении включены всегда. Письма Обновления продукта и Акции и объявления можно включать и выключать. Уведомления о безопасности, оплате и критичных для сервиса событиях отправляются всегда.

Защита данных

• Хранение: три отдельных срока — для Готовых результатов, Текста промптов и Загруженных файлов. Их можно только сократить относительно максимумов платформы (14 дней для результатов, 30 дней для текста промптов, 24 часа для загрузок). Сокращение срока может удалить содержимое задач, которые вы уже выполнили, при ближайшей очистке, а она проходит в течение минуты. Перед подтверждением консоль подсчитывает, чего это коснётся, а удалённое содержимое восстановить нельзя. Сначала скачайте всё, что хотите сохранить.
• Хранение содержимого задач: более старая карточка с двумя настройками. Хранить содержимое задач показывает в днях, сколько хранится содержимое задач; сам срок задаётся тремя настройками выше. Удалять вскоре после завершения удаляет содержимое завершённой задачи примерно через час после того, как её результаты сохранены, а вебхук доставлен.
• Куда уходят ваши данные: краткое изложение того, что уже обещано в Политике конфиденциальности, в том числе что ваши входные и выходные данные не используются для обучения моделей.
• Скачать ваши данные: файл JSON с вашим профилем, ролями в командах, сведениями об API-ключах (но никогда не самими ключами), хранящимися данными задач и платёжными записями. Медиафайлы в него не входят, поэтому результаты скачивайте отдельно.

Полные правила, включая настройку для отдельного запроса и то, что сохраняется при удалении, — на странице Хранение и удаление данных.

Поддержка

Откройте закрытый диалог, который видите только вы и поддержка SpicyAPI. Нажмите Новое обращение, укажите тему, выберите категорию (Аккаунт, Биллинг, Интеграция API, Задача или результат, Конфиденциальность, Для бизнеса или Другой вопрос) и опишите, что произошло. Ответы появляются в самом диалоге (статус Ожидает поддержки, Ожидает вашего ответа, Решено или Закрыто) и в колокольчике уведомлений.

Чтобы мы помогли быстрее, укажите ID задачи, request_id из ответа с ошибкой или ID заявки на пополнение и примерное время, когда это произошло (UTC). Никогда не вставляйте API-ключ, пароль или данные карты. Можно также написать на support@spicyapi.ai.

Команды

Личная область и команды

У каждого аккаунта есть личная область (Личное). Кроме вас в ней никого нет, и если вы работаете один, больше ничего не нужно: ваши личные ключи, баланс и расход работают без всякой команды.

Команда позволяет коллегам пользоваться общими API-ключами, видеть одну и ту же историю задач и работать в рамках общих лимитов расходов. У каждой команды свои участники, свои ключи и свои лимиты.

Переключатель области вверху боковой панели определяет, что показывает консоль:

• Личное: только ваша собственная область.
• Название команды: только ключи, задачи, расход и активность этой команды.
• Все области: всё, к чему у вас есть доступ, вместе.
• Новая команда: быстрый переход к созданию команды.

Он также определяет, куда попадёт новый API-ключ: ключ, созданный, пока выбрана команда, принадлежит этой команде.

Кто платит за команду

Каждая задача, отправленная с API-ключом команды, оплачивается с баланса владельца команды. Это самое важное правило команд.

• Участники никогда не пополняют баланс команды и никогда не видят баланс владельца, его пополнения, платёжные данные и счета.
• Если вы участник и ключ команды начал возвращать 40201, пополнить баланс должен владелец.
• Ваши личные ключи, баланс и расход никогда не становятся общими с командой, в которую вы вступаете, и выход из команды их не затрагивает.
• Владелец, администратор или разработчик может создавать ключи команды, которые тратят баланс владельца. Владельцам: задайте лимиты расходов команды и отдельные лимиты для каждого ключа.

Создание команды

1. Откройте страницу Команда и нажмите Создать команду (или Новая команда в переключателе области).
2. Введите название команды (до 120 символов) и нажмите Создать.

Вы становитесь владельцем команды. Один аккаунт может владеть не более чем 10 рабочими пространствами, и ваша личная область считается одним из них, поэтому создать можно до девяти команд. Число чужих команд, в которые вы вступаете, не ограничено.

Приглашение людей

Приглашать может только Владелец или Администратор.

Правила приглашений:

• Принять приглашение может только аккаунт, адрес почты которого совпадает с приглашённым адресом. Аккаунт с другим адресом получит Please sign in with the invited email address to accept this invite.
• Приватные аккаунты не могут вступать в команды, потому что у них нет адреса электронной почты.
• На один адрес в одной команде может быть только одно ожидающее приглашение. Того, кто уже состоит в команде, пригласить повторно нельзя.
• В команде может быть до 100 участников, включая владельца.
• Отозвать отменяет ожидающее приглашение в любой момент; позже того же человека можно пригласить снова.
• Истёкшее приглашение принять нельзя. Отправьте новое.

Роли и права

В консоли роли показываются под этими названиями. В API и в выгрузках используются имена в нижнем регистре, указанные в скобках.

Кроме того:

• Никто не может изменить собственную роль. Роль владельца меняется только через передачу владения.
• Повторить, уничтожить результаты или удалить задачу из истории может только аккаунт, который её оплатил, какая бы роль у участника ни была.
• Участник с ролью, которой нельзя читать содержимое, видит сообщение Ваша роль позволяет видеть статус задач и расход, но не читать промпты и результаты.
• Личный баланс владельца, его пополнения, платёжные данные и счета не видит никто, кроме самого владельца. Активность команды показывает только движения денег, вызванные задачами команды.

Лимиты расходов команды

У каждой команды (и у вашей личной области) есть дневной и месячный лимит в долларах США — в разделе Команда → ваша команда → Лимиты расходов. Владельцы, администраторы и менеджеры бюджета могут изменить их кнопкой Изменить, а затем Сохранить лимиты.

• Лимиты действуют на все задачи, отправленные с ключами этой области, вместе.
• Учитываются и уже списанные деньги, и деньги, зарезервированные под ещё выполняющиеся задачи.
• Дневной лимит обнуляется в 00:00 UTC, месячный — 1-го числа каждого месяца в 00:00 UTC.
• По умолчанию стоит Без лимита. Введите 0, чтобы лимита не было. Если оставить поле пустым, сохранится его текущее значение.
• Задача, которая превысила бы лимит, отклоняется с кодом 40202 и сообщением Workspace daily budget has been reached или Workspace monthly budget has been reached. Ничего не создаётся и ничего не резервируется.

Лимиты команды действуют в дополнение к собственным дневному, месячному и общему лимитам каждого ключа и к балансу владельца. Задачу останавливает то, что закончится первым. Все лимиты расходов описаны на странице Оплата.

Смена ролей и удаление участников

Откройте команду. В блоке Участники выберите участнику новую роль и подтвердите кнопкой Изменить роль; изменение вступает в силу сразу. Удалить немедленно исключает участника из команды: он теряет доступ к команде, её ключам и её активности. Владельца удалить нельзя.

Удаление участника не отзывает ключи, которые он создал или которыми пользовался. Ключи команды принадлежат команде, поэтому отзовите на странице Ключи API все ключи, которые ещё остались у этого человека.

Выход из команды

Выйти может любой участник, кроме владельца: откройте команду, нажмите Выйти из команды и подтвердите. Доступ пропадает сразу, а вернуться можно только по новому приглашению.

Ничего не удаляется. Ключи, задачи и расход команды остаются у команды, и их по-прежнему оплачивает её владелец. Если у вас остался один из её ключей, попросите администратора отозвать его. Вашу личную область выход не затрагивает.

Владелец не может просто выйти, потому что тогда ключи команды продолжали бы тратить деньги владельца, а управлять ими было бы некому. Сначала передайте владение. Если вы единственный участник, пригласите кого-нибудь и передайте команду ему.

Передача владения

Передать команду может только владелец и только тому, кто уже в ней состоит.

1. Откройте команду и перейдите в Опасная зона → Передать владение.
2. Выберите Нового владельца и введите Текущий пароль. (Аккаунту, созданному через Google или GitHub, сначала нужно задать пароль в Настройках.)
3. Проверьте всё и нажмите Передать команду.

С этого момента:

• каждую задачу, отправленную с ключами команды, оплачивает баланс нового владельца, а все ключи команды переходят на аккаунт нового владельца;
• вы становитесь администратором;
• задачи, принятые до передачи, оплачиваются по-прежнему и не отменяются.

Удаление команды

Удалить команду нельзя. Неиспользуемая команда ничего не стоит и никогда не появляется в счетах. Удалите её участников и оставьте её без дела — или переименуйте и используйте снова, вместо того чтобы создавать новую.

Ограничения команд коротко