Подготовка аккаунта

Создайте аккаунт и подтвердите почту

Откройте spicyapi.ai/register. Зарегистрироваться можно тремя способами:

Отметьте согласие с Условиями использования и Политикой конфиденциальности и нажмите Создать аккаунт.

Что вы должны увидеть: для аккаунта с почтой — страницу с заголовком Проверьте почту. Откройте письмо и перейдите по ссылке. Страница Электронная почта подтверждена подтвердит это, а кнопка Перейти в консоль откроет консоль.

Что сейчас произошло: аккаунт создан, но вызывать API он сможет только после подтверждения почты. До тех пор в консоли висит баннер Электронная почта не подтверждена — API-запросы заблокированы.

• Ссылка срабатывает один раз и перестаёт действовать через 24 часа. Если срок истёк, всё равно откройте ссылку и воспользуйтесь кнопкой Отправить новую ссылку подтверждения либо нажмите Подтвердить на баннере в консоли.
• Письмо не пришло за несколько минут? Проверьте папку «Спам», затем нажмите Отправить ещё раз.

Пополните баланс

Откройте в консоли раздел Биллинг: spicyapi.ai/console/billing. В блоке Пополнить баланс:

1. Выберите сумму. Выберите одну из готовых сумм (например, $10, $25, $50 или $100) или Своя сумма и введите свою. Консоль показывает минимальную и максимальную сумму одного платежа. Онлайн-платежи принимают не больше двух знаков после запятой.
2. Проверьте бонус. К некоторым суммам прилагается промобонус — до оплаты он показан как +$… бонус. Бонус зачисляется отдельной записью рядом с оплаченной суммой.
3. Выберите способ оплаты и следуйте инструкциям на нужной вкладке ниже.

Другие сообщения, которые вы можете увидеть:

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

Необязательно: включите автопополнение

Автопополнение само списывает деньги с сохранённой карты, когда баланс подходит к концу, чтобы долгие задания не останавливались на полпути с ошибкой 40201. Оно работает только с картой.

1. В разделе Биллинг найдите блок Автопополнение и нажмите Надёжно сохранить способ оплаты.
2. Введите данные карты на открывшейся защищённой странице. Данные карты остаются у платёжного провайдера.
3. Вернувшись в Биллинг, вы увидите Проверяем способ оплаты, а затем Способ оплаты сохранён. Если появится Эта карта здесь не подойдёт, ничего не сохранено; попробуйте другую карту.
4. Заполните три поля:
   • Пополнять, когда баланс ниже — баланс, при котором происходит списание.
   • Сумма одного пополнения — сколько добавляет каждое списание. Сумма должна укладываться в тот же диапазон, что и обычное пополнение.
   • Месячный лимит — максимум, который автопополнение может списать за один календарный месяц. Он не может быть меньше суммы одного пополнения.
5. Отметьте согласие на списания и нажмите Включить автопополнение.

Что вы должны увидеть: Автопополнение включено с этими лимитами. На карточке показаны правило, например «Пополняет на $50, как только баланс опускается ниже $10», и строка Использовано в этом месяце.

Правила — точно:

• Мы проверяем баланс примерно раз в 30 секунд — 2 минуты. Когда доступный баланс равен порогу или опускается ниже, мы списываем с сохранённой карты заданную сумму.
• Каждое списание — это обычная заявка на пополнение с пометкой Автопополнение. Она получает тот же бонус, что и пополнение вручную на ту же сумму, и на неё можно выписать счёт.
• Месячный лимит считается по календарным месяцам в UTC. Когда он исчерпан, автопополнение ждёт до 1-го числа следующего месяца. Неудачные списания в лимит не засчитываются.
• Если списание не удалось, мы пробуем снова через 1 час, а потом ещё через 6 часов. Если третья попытка подряд тоже не удалась, автопополнение выключается само. Если банк окончательно отклоняет карту (например, она украдена или закрыта), оно выключается сразу. Успешное списание обнуляет счётчик попыток.
• Если автопополнение выключилось само, исправьте проблему с картой (или сохраните новую) и включите его снова.
• Выключить автопополнение можно в любой момент — будущие списания прекратятся. Это никогда не меняет ваш баланс и уже прошедшие пополнения.

Создайте API-ключ

Откройте страницу Ключи API: spicyapi.ai/console/keys — и нажмите Создать ключ (или Создать первый ключ).

В окне Создать API-ключ обязательно только название. Всё, что находится в блоке Дополнительно, можно изменить позже.

Название. Назовите ключ по тому, что будет им пользоваться, например production backend или my laptop. Вам нужно будет узнать его, когда вы захотите его отозвать. До 120 символов.

Лимиты расходов (в блоке Дополнительно, в долларах США). Когда лимит достигнут, этот ключ отклоняет новые задачи с кодом 40202, пока не начнётся новый период. Остальные ваши ключи продолжают работать. Деньги, зарезервированные под ещё выполняющиеся задачи, засчитываются в каждый лимит.

Введите 0 в любое поле лимита, чтобы снять ограничение; пустое поле означает то же самое.

Доступ.

• Разрешённые модели. Если оставить Все модели (без ограничений), ключ сможет вызывать любую модель, включая добавленные позже. Если выбрать конкретные модели, любую другую модель ключ отклонит с кодом 40301.
• Разрешённые IP. Любой адрес принимает вызовы откуда угодно. Только эти принимает вызовы только с перечисленных вами адресов: IPv4, IPv6 или диапазонов CIDR, например 203.0.113.10, 198.51.100.0/24, через запятую, до 64 записей. Указывайте публичный адрес, с которого обращается ваш сервер, а не адрес внутри офисной или домашней сети. Вызовы с любых других адресов отклоняются с кодом 40302. Для ноутбука, у которого адрес меняется, оставьте Любой адрес.
• Срок действия. Выберите 7, 30 или 90 дней, 1 год, Бессрочно или конкретную дату. Ключ перестаёт работать в конце этого дня по UTC, и с этого момента на него приходит тот же 401, что и на отозванный ключ.

Нажмите Создать.

Что вы должны увидеть: окно Ключ создан с полным ключом, который начинается с sk-spicy-. Скопируйте его кнопкой Копировать ключ или нажмите Сохранить в файл. Отметьте Ключ сохранён в надёжном месте, затем нажмите Готово.

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

Позже, на той же странице:

• Редактировать меняет название, лимиты, разрешённые модели, разрешённые IP и срок действия. Изменения вступают в силу сразу.
• Отозвать немедленно останавливает ключ, и это нельзя отменить. Уже принятые задачи продолжают выполняться и по-прежнему оплачиваются.
• В одной области можно держать до 50 активных ключей. Используйте отдельный ключ для каждого приложения или окружения, чтобы отзывать один, не останавливая остальные.

Сохраните ключ в SPICY_API_KEY

Переменная окружения — это именованное значение, которое терминал передаёт запущенным из него программам. Официальные SDK, CLI и MCP-сервер, а также все примеры в этой документации читают ваш ключ из переменной SPICY_API_KEY. Так ключ никогда не приходится вписывать в команду или сохранять внутри проекта.

Сначала откройте терминал: в macOS нажмите Cmd + Пробел, наберите Terminal и нажмите Enter. В Windows откройте меню Пуск, наберите PowerShell и откройте Windows PowerShell.

export SPICY_API_KEY="sk-spicy-paste-your-key-here"

nano ~/.zshrc

echo "${SPICY_API_KEY:0:9}"

На сервере задавайте SPICY_API_KEY в настройках секретов или переменных окружения у своего хостинг-провайдера, а не в файле внутри проекта.

Сделайте бесплатный тестовый вызов

Этот запрос узнаёт ваш баланс. Он ничего не стоит, ничего не создаёт и проверяет сразу три вещи: ключ задан, ключ действителен и вашему аккаунту разрешено вызывать API.

curl https://api.spicyapi.ai/api/v1/chat/credit \
  -H "Authorization: Bearer $SPICY_API_KEY"

Ожидаемый результат: ответ примерно такого вида (в сокращении):

{
  "code": 200,
  "msg": "success",
  "data": {
    "available": "25",
    "held": "0",
    "total": "25"
  },
  "request_id": "req_01k..."
}

Что это значит: "code": 200 — успех. Суммы указаны в долларах США и записаны текстом. available — сколько можно потратить на новые генерации, held — сколько зарезервировано под генерации, которые ещё выполняются, а total — обе суммы вместе. В настоящем ответе есть ещё объект funding, который отделяет оплаченные средства от промоначислений; пока на него можно не обращать внимания.

Если вы получили что-то другое:

Не хотите пользоваться curl? CLI делает то же самое командой spicyapi balance.