APIWAY / Вопросы о подключении и тарифах
Ответы до первого запроса.
Что такое API-доступ, как оценить расходы и что проверить при подключении своего инструмента.
Что такое API-ключ?
Это секретная строка, по которой API узнаёт, что запрос — ваш. Ключ создаётся в личном кабинете; передавайте его только своим приложениям и храните как пароль. Если ключ попал в открытый доступ, выключите его в кабинете и создайте новый.
Что такое модель и что такое маршрут?
Модель — нейросеть с точным Model ID. Маршрут — настроенный доступ к ней через сервис. Статусы подключения, тарифа и исторической проверки ответа показаны отдельно; наличие записи не гарантирует успешный запрос сейчас.
Почему у разных моделей расход токенов разный?
Модели по-разному разбирают текст на токены и пишут ответы разной длины и подробности. Один и тот же вопрос может стоить по-разному и занимать разное время. Токены запроса и ответа видны в истории кабинета — по ним видно реальный расход.
Как работают ограничения доступа?
Для запроса нужны подключённая модель, действующий тариф, разрешение ключа и достаточный баланс. При отказе проверьте код ошибки и состояние аккаунта. Доступные лимиты проверяйте в своём аккаунте.
Как считаются расходы?
Фактический расход определяется тарифом сервиса и учтённым объёмом запроса. Вход и ответ могут иметь разные ставки. Каталог показывает доступность; рублёвые ставки уточняются, кабинет — баланс и историю. Рублёвый калькулятор использует примеры коэффициентов; это не курс конвертации и не фактическое списание. Пополнение на витрине не подключено.
Где взять API-ключ?
В личном кабинете откройте раздел «Ключи» и создайте отдельный ключ для приложения. Новый ключ ограничен выбранным каталогом; существующий ключ сохраняет свои ограничения. Храните секрет в защищённых настройках клиента.
Что именно я получаю через API?
Доступ к разрешённым для ключа подключённым моделям через единый адрес API. Перед запросом проверьте точный Model ID, статус, тариф и баланс. Совместимость инструмента и возможности модели проверяются отдельно.
Какие модели уже доступны?
Проверьте живой каталог сервиса на странице «Модели»: подключение, наличие тарифа и время данных указаны отдельно. Справочник содержит и неподключённые модели. Историческая проверка ответа не гарантирует успешный запрос сейчас.
Можно ли оплатить тариф с этой страницы?
Нет. Оплата и пополнение на этой витрине не подключены. Ставки в каталоге — действующие данные сервиса, а не выставляемые счета. Коммерческий доступ пока готовится.
Чем входные токены отличаются от выходных?
Вход — данные, которые вы отправляете модели: сообщения, инструкции и переданный контекст. Выход — сгенерированный ответ. У них могут быть разные ставки; учитывайте обе при оценке запроса.
Нужна ли отдельная подписка на чат?
Подписка на веб-чат и API-доступ — разные продукты. Не считайте оплату одного доступом к другому; условия API и наличие модели смотрите в действующем каталоге сервиса.
Подойдёт ли API для моего редактора?
Проверьте, поддерживает ли ваш инструмент собственный API-адрес, ключ и нужный формат запросов. Сам редактор не всегда подключается к API: часто используется расширение. Совместимость проверяется для конкретной интеграции.
Все модели работают в одном формате?
Нет. Chat Completions, Responses и Messages — разные форматы. Не переносите настройки между ними автоматически. Выберите формат, который поддерживают инструмент и конкретная модель.
Почему не все модели доступны?
Для запроса нужны подключённый маршрут, настроенный тариф и разрешение ключа. Статусы «Тариф уточняется» и «Не подключена» не означают готовность к запросу. Сверяйте актуальные данные и время обновления в каталоге моделей.
Как безопасно хранить API-ключ?
Храните его на сервере или в защищённых настройках инструмента. Не помещайте ключ в публичный репозиторий, адрес страницы или клиентский код сайта. Для разных приложений удобно использовать отдельные ключи.
Почему запрос может завершиться ошибкой?
Проверьте адрес, формат API, идентификатор модели и действительность ключа. Затем — доступный баланс, лимиты и размер запроса. При обращении в поддержку передавайте код ошибки и время, а секреты скрывайте.
Коды ошибок и примеры →Что означают коды ошибок — 401, 404, 429?
401 — ключ не передан или не принят; 404 — ошибка в пути запроса или в ID модели; 429 — достигнут лимит запросов, нужно подождать. Для каждого кода в документации есть действие, которое стоит сделать.
Таблица кодов ошибок →Что такое стриминг и когда он нужен?
Это режим, в котором ответ приходит по частям прямо во время генерации, а не одним куском в конце. Удобно для чатов и ботов: ответ видно сразу. Включается полем stream со значением true.
Как включить стриминг →Что такое токен простыми словами?
Единица текста, на которую модель разбирает запрос и ответ: примерно часть слова. В токенах измеряют объём и расход — короткий вопрос это десятки токенов, длинный ответ сотни.
Как увидеть токены запроса →Как узнать, сколько токенов ушло на конкретный запрос?
В обычном ответе API есть блок usage: токены входа, выхода и сумма. Такие же числа по каждому запросу — в истории кабинета, в разделе «Расходы». Сверьте их с ответом: данные должны совпадать.
Про подсчёт расхода →Как проверить доступ к модели?
Проверьте доступность модели, действующий тариф, баланс и разрешения ключа перед первым запросом. Пополнение в интерфейсе пока недоступно.
Границы тестового контура →