Подключение API токенов
Ключ работает в любой программе, которая умеет OpenAI-совместимый API: агенты в терминале, редакторы кода, расширения и ваши собственные скрипты. Нужны всего две вещи — адрес сервиса и ключ из сообщения продавца.
Адрес сервиса
https://www.ai-funpay.ru
Для OpenAI-совместимых программ адрес указывается вместе с /v1 — почти все они дописывают его сами, но если в поле просят «Base URL», вставляйте https://www.ai-funpay.ru/v1.
Адрес работает по защищённому протоколу. Если программа или корпоративный прокси подменяет сертификат, соединение не установится — отключите подмену для этого домена.
Настройка за пару минут
Выберите систему, программу и модель — страница соберёт одну готовую строку для терминала (или покажет, что вставить вручную). Скрипт ничего не удаляет: прежние настройки он сохраняет рядом с файлом.
Если вашей программы нет в списке
Любая программа с поддержкой 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, скриншот переписки, чужой чат — всё это утечка. Кто угодно сможет работать за ваш счёт.
- Не храните ключ в коде. Держите его в переменной окружения или в файле настроек программы, как это делает скрипт установки.
- Один ключ — один счёт. Расход по ключу виден только в вашем кабинете, поэтому ключ не стоит передавать коллегам: расход смешается.
- Если ключ утёк — напишите продавцу, чтобы тот закрыл доступ и выдал новый. Старый после этого работать перестанет.
Файл скрипта ключ не содержит — он передаётся ему аргументом. А вот в готовую строку запуска ключ уже подставлен: такую строку никому не пересылайте, ключ в ней — ваш.
Активация ключа
Личный кабинет открывается по ключу — ни пароля, ни регистрации не нужно.
- Откройте кабинет
Страница /portal. Ссылка есть и в шапке этой страницы.
- Вставьте ключ
Полностью, вместе с sk- в начале. Ключ не отправляется нам в открытом виде — сервис сравнивает его отпечаток.
- Нажмите «Войти»
Откроется остаток лимита, расход и журнал запросов. Вход сохраняется в этой вкладке браузера: закрыли браузер — вводите ключ заново.
Что видно в кабинете
- остаток лимита и полоса расхода — обновляются в реальном времени;
- журнал запросов: время, модель, вход, кэш, выход, результат;
- расход по моделям за текущий период;
- доступные модели с размером контекста;
- эта же инструкция по подключению — в неё подставляется ваш ключ.
Ключ в кабинете виден только началом: полный ключ хранится у вас, сервис его не знает.