natpush
Кабинет

Подключение API токенов

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

Адрес сервиса

https://www.ai-funpay.ru

Для OpenAI-совместимых программ адрес указывается вместе с /v1 — почти все они дописывают его сами, но если в поле просят «Base URL», вставляйте https://www.ai-funpay.ru/v1.

Только HTTPS

Адрес работает по защищённому протоколу. Если программа или корпоративный прокси подменяет сертификат, соединение не установится — отключите подмену для этого домена.

Настройка за пару минут

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

Если вашей программы нет в списке

Любая программа с поддержкой OpenAI API настраивается двумя значениями:

Base URL
https://www.ai-funpay.ru/v1
API Key
sk-… — ключ из сообщения продавца

Запросы отправляются на https://www.ai-funpay.ru/v1/chat/completions, поддержаны /v1/messages (формат Anthropic) и /v1/responses. Поэтому подходит и то, что просит «Anthropic Base URL», и то, что просит «OpenAI Base URL».

Доступные модели

Имя для APIНазваниеКонтекстОтвет

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

Коды ошибок

Ответ с ошибкой всегда начинается с числа — оно и объясняет, кто виноват: ваш ключ, ваша программа или сервис. Ниже разобраны все коды, которые сервис отдаёт.

Смотреть ошибку нужно в ответе программы. В терминале это текст вида Error 401: …, в кабинете ошибки видны в журнале запросов. Если программа показывает только «не удалось подключиться», повторите запрос командой из раздела «Проверка» — она покажет настоящий ответ.

401 Ключ не принят

Что значит: сервис не нашёл ключ в запросе или не узнал его.

Что делать: проверьте, что ключ скопирован целиком — он длинный, и по краям часто теряются символы. Убедитесь, что в настройках стоит именно Authorization: Bearer sk-…, а не ключ, вставленный в другое поле. Если программа хранит ключ в переменной окружения, перезапустите её после правки настроек.

403 Доступ отключён

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

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

429 Лимит или частота

Этот код означает два разных случая, и различать их важно.

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

Слишком много запросов в секунду. Остаток при этом есть. Так бывает, когда агент запускает несколько задач сразу или очень быстро повторяет запросы после ошибки. Подождите несколько секунд и повторите; если это повторяется постоянно, уменьшите одновременность в настройках программы.

400 Слишком длинный контекст

Что значит: в запросе больше токенов, чем помещается в окно модели. В тексте ошибки указаны оба числа: сколько пришло и сколько допускается.

Что делать: начните новый диалог в программе или очистите контекст — агент снова соберёт его сам, только короче. Длинная переписка накапливается с каждым сообщением, поэтому упереться в лимит можно и в середине работы.

404 Адрес не найден

Что значит: запрос ушёл на путь, которого в сервисе нет. Чаще всего в адресе лишний или недостающий /v1, либо в поле «Base URL» вписан полный путь вместе с /chat/completions.

Что делать: в поле «Base URL» указывайте только https://www.ai-funpay.ru/v1 — остальной путь программа дописывает сама.

502 Модель не ответила

Что значит: запрос дошёл, но модель на стороне поставщика не ответила или ответила ошибкой. Ваш ключ и настройки здесь ни при чём.

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

503 Сервис недоступен

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

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

Чего не будет

Ошибки 500 и 529 от сервиса вы не увидите: вместо них отдаётся 502 или 503 с понятным текстом. А если программа пишет «модель не найдена», это не ошибка сервиса — просто имя модели в настройках не совпадает со списком, и запрос всё равно пройдёт на основную модель.

Что такое ключи

Ключ — единственное, что нужно для работы с сервисом. Он же служит входом в личный кабинет.

Как выглядит
sk-… — 67 символов, буквы и цифры
Где взять
его выдаёт продавец при покупке, в сообщении вместе со ссылкой на этот справочник
Срок действия
не ограничен: ключ работает, пока не кончится объём или пока доступ не закроет продавец
Вход в кабинет
тот же ключ, вставляется на странице Кабинет
Восстановление
невозможно: сервис хранит только отпечаток ключа, а не сам ключ

Как обращаться с ключом

  • Не выкладывайте его в открытый доступ. Репозиторий на GitHub, скриншот переписки, чужой чат — всё это утечка. Кто угодно сможет работать за ваш счёт.
  • Не храните ключ в коде. Держите его в переменной окружения или в файле настроек программы, как это делает скрипт установки.
  • Один ключ — один счёт. Расход по ключу виден только в вашем кабинете, поэтому ключ не стоит передавать коллегам: расход смешается.
  • Если ключ утёк — напишите продавцу, чтобы тот закрыл доступ и выдал новый. Старый после этого работать перестанет.

Файл скрипта ключ не содержит — он передаётся ему аргументом. А вот в готовую строку запуска ключ уже подставлен: такую строку никому не пересылайте, ключ в ней — ваш.

Активация ключа

Личный кабинет открывается по ключу — ни пароля, ни регистрации не нужно.

  1. Откройте кабинет

    Страница /portal. Ссылка есть и в шапке этой страницы.

  2. Вставьте ключ

    Полностью, вместе с sk- в начале. Ключ не отправляется нам в открытом виде — сервис сравнивает его отпечаток.

  3. Нажмите «Войти»

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

Что видно в кабинете

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

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

natpush · справочник по подключению