FRELY / Вопросы и ответы
Использование моделей и API-ключей
API-ключи, настройки клиента, расход ресурсов и что делать, если запрос не прошёл.
Инструменты аккаунта доступны из ИИ-приложения, подключённого к FrelyMCP (https://mcp.frely.cloud/mcp, через frely_list и frely_call), или из терминала с Frely CLI: frely api describe <tool>, затем frely api call <tool>. Инструменты, которые что-либо изменяют, требуют вашего подтверждения на сайте Frely.
01
Как создать API-ключ?
Откройте страницу API-ключей в своей консоли и создайте ключ. Ключ авторизует вызовы моделей, а не управляющие действия. Храните его в защищённой конфигурации вашего клиента. Никогда не помещайте его в Git, скриншоты или чаты. Отзыв ключа прекращает его дальнейшее использование.
Инструменты API: keys.listkeys.createkeys.set_limits
02
Какой базовый URL у API Frely?
https://api.frely.cloud. Всегда используйте https: запросы по обычному http отклоняются, поэтому клиент, настроенный на http://api.frely.cloud, работать не будет. Один и тот же адрес обслуживает все протоколы, например https://api.frely.cloud/v1/chat/completions, /v1/responses, /v1/messages, /v1/embeddings и список моделей по адресу /v1/models. Некоторым клиентам нужен базовый URL с /v1 на конце (https://api.frely.cloud/v1), и путь эндпоинта они добавляют сами.
Инструменты API: models.available
03
Как аутентифицировать API-запросы?
Передавайте свой API-ключ как Bearer-токен: Authorization: Bearer <ваш ключ>. Добавляйте Content-Type: application/json к запросам с телом. Запрос без действительного ключа получает ответ 401. Ключ авторизует только вызовы моделей, но не управление учётной записью.
Инструменты API: keys.listkeys.create
04
Как выглядит ответ с ошибкой?
Тело JSON вида {"error":{"message","type","param","code"}}. Тип соответствует HTTP-статусу: 401 — authentication_error, 402 — insufficient_quota, 403 — permission_error, 404 — not_found_error, 408 или 504 — timeout_error, 429 — rate_limit_error, остальные 4xx — invalid_request_error, 503 — service_unavailable_error, остальные 5xx — server_error. Каждый ответ содержит заголовок x-request-id; сохраняйте его при обращении в поддержку. При ошибке, которую стоит повторить, может присутствовать заголовок Retry-After со значением в секундах.
Инструменты API: request_history.list
05
Что вводить в моём ИИ-приложении или клиенте?
Три значения: публичный адрес сервиса для выбранного вами протокола (не внутренний адрес), ваш собственный API-ключ и публичное имя модели, доступное вашей учётной записи. Точные значения показаны в инструкциях вашей учётной записи.
Инструменты API: models.availablekeys.list
06
Как добавить Frely в Claude или ChatGPT?
Добавьте Frely как connector (коннектор), используйте адрес FrelyMCP в качестве URL сервера MCP, выберите OAuth, войдите в Frely и подтвердите доступ. Пошаговые руководства показывают каждый экран.
07
Модель отображается в списке, но я не могу её вызвать.
Присутствие в списке не означает разрешения на вызов. Проверьте свой тариф, баланс, лимиты и условия сервиса, а если у вас тариф Team — обратитесь к уполномоченному администратору. Ротация ключей не обходит ограничение.
Инструменты API: models.availablebudget.getcredits.account
08
Мой запрос завершился ошибкой или по таймауту.
Сохраните обезличенную запись со временем, протоколом, названием модели и идентификатором запроса и посмотрите историю запросов. Таймаут или разрыв соединения не доказывает, что ничего не было израсходовано, поэтому перед повторной попыткой проверьте расход ресурсов. Никому не отправляйте учётные данные, тела запросов или необработанные дампы ошибок.
Инструменты API: request_history.listusage.summary
09
Можно ли полагаться на вывод модели?
Вывод модели может содержать ошибки, и Frely не гарантирует его точность. Проверяйте его перед использованием в критически важных для безопасности, юридических, финансовых, медицинских задачах, в вопросах безопасности или в производственной среде.