FAQ по продукту CoreAPI Последнее изменение: 23 January 2026 16:53:03
Здесь собраны ответы на популярные вопросы по работе с API, личным кабинетом и интеграцией.
Что такое CoreAPI?
CoreAPI представляет собой платформу, которая предлагает унифицированный API для работы с моделями искусственного интеллекта от разных провайдеров. Этот сервис облегчает процесс интеграции, избавляя пользователей от необходимости детально изучать особенности каждого поставщика. В административной панели можно создавать приложения для различных проектов и подключать к ним подходящие модели. Гибкие параметры позволяют адаптировать модели под конкретные требования, расширяя их функциональность. Среди ключевых преимуществ — встроенная система хранения истории бесед и автоматическая смена ключей для стабильной работы.
Для чего предназначен CoreAPI?
Сервис ориентирован на бизнес, стартапы и разработчиков, желающих внедрить искусственный интеллект в свои решения.
Для каких проектов подходит CoreAPI?
Он подходит для любых систем, требующих подключения к моделям провайдеров: от Telegram-ботов и веб-сайтов до мобильных приложений, серверных систем и даже устройств с HTTP-поддержкой, таких как микроконтроллеры.
Каких поставщиков поддерживает CoreAPI?
В настоящее время реализована интеграция только с OpenAI. В планах — расширение на других поставщиков, включая Anthropic, Google и т.д.
Какие модели поддерживает CoreAPI?
Сервис работает со следующими моделями от OpenAI:
- gpt-3.5-turbo-0613;
- gpt-3.5-turbo-16k-0613;
- gpt-3.5-turbo-1106;
- gpt-3.5-turbo-0125;
- gpt-4-0613;
- gpt-4-32k-0613;
- gpt-4-1106-vision-preview;
- gpt-4-1106-preview;
- gpt-4-0125-preview;
- gpt-4-turbo-2024-04-09;
- gpt-4o-2024-05-13;
- gpt-4o-mini-2024-07-18;
- gpt-4o-2024-08-06;
- gpt-4o-2024-11-20;
- o1-mini-2024-09-12;
- o1-preview-2024-09-12.
Имеется ли возможность добавлять собственные модели в CoreAPI (которых нет в списке) через административную панель для определённого поставщика, например, OpenAI?
Нет, но такая функция планируется к внедрению в будущем.
Через какой внутрениий REST API-endpoint происходит обработка запросов моделей в OpenAI?
Сейчас все модели обрабатываются через endpoint POST https://api.openai.com/v1/chat/completions. В перспективе ожидается переход на более современный вариант — POST https://api.openai.com/v1/responses.
Нужен ли собственный сервер для интеграции?
Не всегда: запросы можно отправлять напрямую с клиентской стороны, однако это повышает риск утечки идентификатора приложения.
Какие способы регистрации доступны на сервисе?
На данный момент регистрация возможна только по электронной почте с паролем.
Для чего нужны приложения в CoreAPI?
Каждое приложение создаётся под конкретную задачу, например, под Telegram-бот, веб-сайт или специализированный функционал (к примеру, интеллектуальный поиск на ресурсе).
Нужно ли для каждого своего проекта (Telegram-бот, веб-сайт или какой-то иной функционал) заводить отдельные свои приложения на сервисе?
Да, для каждого проекта рекомендуется создавать отдельное приложение с уникальным идентификатором, поскольку это позволит назначить ему собственный набор моделей, а также отслеживать зарегистрированных пользователей и их беседы с сообщениями.
Как обезопасить идентификатор приложения от хищения третьими лицами?
Его следует хранить на промежуточном сервере (например, прокси), чтобы скрыть передачу от посторонних глаз.
Можно ли привязать несколько моделей к одному приложению?
К одному приложению допускается подключение нескольких моделей от разных поставщиков.
Какие настройки доступны для моделей?
Каждой модели доступны персональные параметры, зависящие от провайдера. Обычно это внутренние опции их API, как в случае с OpenAI и endpoint POST https://api.openai.com/v1/chat/completions: от промпт-инструкции до уровня креативности ответов и других параметров.
Для чего нужен функционал "Аккаунты поставщиков" в административной панели?
Эта функция предназначена для добавления наборов данных для каждого провайдера (например, заголовки и их значения).
Можно ли привязать несколько API-ключей к одной модели?
К одной модели можно прикрепить несколько ключей от того же провайдера.
Зачем привязывать к API-ключу аккаунт поставщика?
Это не обязательно, но такая связь позволяет ассоциировать ключ с конкретными настройками провайдера.
Какие есть статусы у API-ключа?
- «API-ключ активен» — присваивается вручную в личном кабинете при подключении к модели или при смене с других статусов, таких как «Недостаточно средств на API-ключе» или «Ошибка API-ключа»;
- «Недостаточно средств на API-ключе» — устанавливается автоматически, если баланс у провайдера исчерпан (например, в организации OpenAI);
- «Ошибка API-ключа» — появляется автоматически при удалении ключа или неожиданных сбоях на стороне провайдера;
- «Request limit exceeded» (не отображается в административной панели, но возвращается в API при создании сообщения в диалоге) — устанавливается автоматически на 10 секунд (для OpenAI — на 60 секунд), после чего снимается. Этот статус возникает при превышении внутренних лимитов в аккаунте провайдера, что приводит к временной блокировке API-ключа, связанного с организацией. В этот период система переключается на следующий активный ключ, если он доступен. При отсутствии альтернатив модель не сработает, и метод вернёт ошибку «rate_limit_exceeded» до окончания блокировки. В некоторых случаях лимиты провайдера могут затягиваться, вызывая повторные блокировки при последующих запросах, пока ресурсы аккаунта не восстановятся. Чтобы избежать таких проблем, рекомендуется привязывать по одному ключу к каждой организации (аккаунту провайдера). Если к модели подключены несколько ключей от одной организации, блокировка затронет все сразу, делая их неработоспособными на 10 секунд.
Можно ли один и тот же API-ключ привязывать несколько раз к разным моделям?
Нет, каждый ключ подключается только к одной модели в конкретном приложении.
Для чего нужен внутренний механизм системы очередей API-ключей?
Он обеспечивает автоматическое переключение на следующий рабочий ключ со статусом «API-ключ активен» в пределах модели при сбоях или лимитах (включая временный «Request limit exceeded»), что поддерживает непрерывную работу.
Для чего нужен «Чат» в приложениях в административной панели?
В нём удобно проверять модели по отдельности или вместе, сравнивая их работу с разными промптами и параметрами. Чат позволяет загружать изображения с устройства или по ссылке, что полезно для тестирования vision-функций поддерживающих моделей.
Какие версии api доступны на сегодняшний день?
В настоящее время поддерживается только экспериментальная версия 0.
Для чего в API нужны example@fake.email?
Адреса с доменом fake.email используются для создания и авторизации сервисных аккаунтов, которые не требуют подтверждения и предназначены для системных операций.
Обязательно ли выполнять API-метод подтверждения email после регистрации пользователя через API?
Это зависит от логики вашего приложения: подтверждение может быть обязательным или опциональным.
Для чего нужен в приложениях в административной панели функционал "Лог приложений"?
Он предназначен для разработчиков, позволяя анализировать запросы к REST API приложения с целью отладки или других задач.