К содержимому

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: токены входа, выхода и сумма. Такие же числа по каждому запросу — в истории кабинета, в разделе «Расходы». Сверьте их с ответом: данные должны совпадать.

Про подсчёт расхода →
Как проверить доступ к модели?

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

Границы тестового контура →