Своя документация ИИШКО
От ключа до первого ответа.
Ключ получают только в авторизованном Mini App. Этот сайт объясняет подключение, но не создаёт аккаунт по email и не выдаёт ключ анонимному посетителю.
Начни с Telegram
Открой Telegram-бота
Перейди в @iishkogatewaybot и нажми «Старт». Публичная регистрация по email и паролю отключена.
Запусти Mini App из меню бота
Нажми «Открыть Mini App». Telegram передаст данные для входа: обычная вкладка браузера сама по себе не авторизует тебя.
Получи ключ в разделе «Ключи»
Создай или открой основной ключ в Mini App. Бот не показывает ключи в переписке. Проверь API-кредит ключа и условия доступа своего ранга.
Выбери точную модель и получи первый ответ
В Mini App открой «Модели»: проверь доступ твоему рангу, точный ID и время последней пробы. Для первого ответа открой «Агент» или подключи ключ к OpenAI-совместимому клиенту по инструкции.
Подключи OpenAI-совместимый клиент
В настройках клиента выбери OpenAI-compatible / Custom. Базовый адрес: https://api.reformboss.com/v1. API key — твой ключ из Mini App. Model — точный ID из актуального каталога.
Если клиент сам добавляет /chat/completions, не указывай этот путь в Base URL. Полный endpoint для чата: https://api.reformboss.com/v1/chat/completions. Поддержка OpenAI-совместимого чата не означает поддержку любого протокола или всех возможностей каждой модели.
Bash (Linux / macOS): посмотри доступные ID
Перед запуском задай переменную IISHKO_API_KEY локально. Не отправляй её в чат или поддержку и не публикуй вывод с заголовком авторизации. Эти примеры curl предназначены для Bash; для Windows используй пример PowerShell.
curl --silent --show-error https://api.reformboss.com/v1/models \
--header "Authorization: Bearer $IISHKO_API_KEY"
Bash: отправь короткий тест
Замени EXACT_MODEL_ID на ID чат-модели, доступной твоему ключу. Не используй ID модели изображений или видео для чат-запроса.
# Set IISHKO_API_KEY privately in your environment.
# Replace EXACT_MODEL_ID with an exact ID from the current catalogue.
curl --silent --show-error https://api.reformboss.com/v1/chat/completions \
--header "Authorization: Bearer $IISHKO_API_KEY" \
--header 'Content-Type: application/json' \
--data '{"model":"EXACT_MODEL_ID","messages":[{"role":"user","content":"Reply with OK"}],"max_tokens":32}'
Windows PowerShell 5.1 / PowerShell 7
В PowerShell используй нативный Invoke-RestMethod с переменной $env:IISHKO_API_KEY, а не Bash-команду выше. Пример отправляет объект через ConvertTo-Json и явно кодирует тело в UTF-8, в том числе для кириллицы. Проверь в каталоге доступ ключа к точной модели deepseek-v4.1-flash-1017: наличие примера не гарантирует доступность.
# Set IISHKO_API_KEY privately in your environment.
if ([string]::IsNullOrWhiteSpace($env:IISHKO_API_KEY)) {
throw 'Set IISHKO_API_KEY in your local environment first.'
}
$headers = @{
Authorization = "Bearer $env:IISHKO_API_KEY"
}
$payload = @{
model = 'deepseek-v4.1-flash-1017'
messages = @(
@{ role = 'user'; content = 'Reply with OK' }
)
max_tokens = 32
}
$json = $payload | ConvertTo-Json -Depth 6
$body = [System.Text.Encoding]::UTF8.GetBytes($json)
$request = @{
Uri = 'https://api.reformboss.com/v1/chat/completions'
Method = 'Post'
Headers = $headers
ContentType = 'application/json; charset=utf-8'
Body = $body
}
Invoke-RestMethod @requestЭто реальный API-запрос: он может расходовать API-кредит и учитывается в действующих лимитах. Успешный ответ содержит результат выбранной модели. Сверяй имя модели в ответе; при несовпадении не считай подмену нормой — передай безопасный код ошибки и request ID в поддержку.
Точные модели, ранг и доступность
Источник актуальных ID — GET /v1/models с твоим ключом и раздел «Модели» в Mini App. Используй имя целиком, включая регистр, точки, дефисы и префикс провайдера. Не придумывай сокращения и не считай похожие названия взаимозаменяемыми.
Право доступа по рангу и состояние провайдера — разные вещи. «Доступна тебе» означает право использования, а не гарантированный успешный запрос. Статус и история в Mini App основаны на наблюдаемых пробах с отметкой времени. «Не проверена», устаревшая проба и отсутствие измерений не равны «работает». Даже свежая успешная проба не гарантирует следующий ответ.
Условия рангов, дневные лимиты и ограничения ключей остаются действующими. Каталог и эта инструкция не снимают блокировки и не меняют выбранную модель. Цены смотри на существующей странице цен; фактический расход зависит от модели и запроса.
API-кредит ключа ≠ квота аккаунта сайта
API-кредит основного ключа — остаток канонического кошелька, который использует бот и Mini App. Дополнительные ключи могут иметь собственные остатки: основной кошелёк не является суммой всех ключей.
Квота аккаунта сайта — отдельная запись учётной системы. Это не второй перевод денег и не подтверждение API-кредита ключа. Для запроса могут действовать ограничения обоих уровней. Сайт только читает показатели: ничего не переносит и не синхронизирует.
Приостановленный ключ может сохранять кредит; наличие денег не снимает блокировку. Если прочитать БД или безопасно подтвердить привязку не удалось, показатель недоступен — это не нулевой баланс. Для безлимитного ключа числовой остаток не выдаётся за доступный кредит.
Разбор ошибок
| HTTP | Что означает | Что делать |
|---|---|---|
| 402 | Недостаточно квоты для предоплаты конкретного запроса. Это не доказательство нулевого баланса: запрос с длинным контекстом может требовать больше остатка. Иногда принадлежность квоты не подтверждена. | Проверь API-кредит ключа и квоту аккаунта отдельно, сократи контекст или лимит ответа. Не повторяй тот же запрос бесконечно; при несоответствии обратись в поддержку. |
| 429 | Временный лимит ключа, частоты или дневного использования. Это не сообщение о списании всего кредита. | Прочитай код и пояснение ошибки. Выжди указанный срок, если он есть; проверь дневные ограничения в Mini App. Не запускай параллельные повторы. |
| 503 | Выбранный upstream временно недоступен: перегрузка, маршрут, учётные данные или квота провайдера. Это не подтверждение неисправности твоего ключа или обнуления кошелька. | Повтори позже с паузой. Выбор другой модели — только твоё явное решение. Если часть ответа или действие инструмента уже получены, не воспроизводи запрос вслепую. |
| 401 / 403 | 401 — ключ не принят. 403 — запрет; причина может быть в доступе к точной модели, действующих условиях или другом ограничении, не обязательно в ранге. | Проверь актуальный ключ в Mini App, точный ID модели и текст ошибки. Не отправляй ключ в поддержку. |
| 400 / 413 / 504 | Некорректные параметры или контекст, слишком большой запрос либо таймаут. | Сократи запрос и проверь возможности модели. При таймауте результат уже начатой операции может быть неизвестен. |
Для диагностики сохрани HTTP-статус, безопасный код ошибки и request ID, если он выдан. Не прикладывай ключ, Cookie, Telegram initData, полный запрос или содержимое файлов.
Эфемерные диалоги и остановка
Диалоги ИИ не являются постоянным архивом. Контекст может временно жить в памяти процесса или открытого экрана и исчезнуть после очистки, закрытия или перезапуска. Не рассчитывай восстановить чат; нужный результат сохрани самостоятельно. Сообщения в Telegram подчиняются отдельным правилам Telegram.
«Стоп» останавливает текущую генерацию по возможности, но не откатывает уже выполненный инструмент или принятый провайдером запрос. Если результат действия неизвестен, сначала проверь его, прежде чем повторять.
Явно отправленное обращение в поддержку — не диалог ИИ: текст обращения и добровольно приложенная безопасная диагностика хранятся до 30 дней. Подробнее — конфиденциальность.