TL;DR
TypingMind — это гибкий интерфейс для общения с ИИ, который позволяет подключать GPT, Claude, DeepSeek и другие поддерживаемые модели с помощью ваших собственных API-ключей. Интегрируя CometAPI через совместимое с OpenAI подключение, вы можете получать доступ к нескольким моделям ИИ без настройки отдельных учетных записей провайдеров. В этом руководстве объясняется, как добавить пользовательскую модель с использованием вашего API-ключа CometAPI и конечной точки Chat Completions, отправить первое сообщение и устранить распространенные ошибки настройки. Вам понадобятся API-ключ CometAPI, доступный кредит на аккаунте и доступ к настройкам пользовательских моделей в TypingMind. Начните с базового текстового запроса, затем по мере необходимости включайте расширенные возможности. Для тестирования API-подключения также включен необязательный пример на Bash и cURL.
Key Takeaways
- Один API-ключ, несколько моделей: доступ к поддерживаемым провайдерам через один аккаунт CometAPI.
- Интеграция, совместимая с OpenAI: настройка стандартной конечной точки Chat Completions без собственного SDK.
- Гибкий выбор модели: регистрируйте несколько моделей на базе CometAPI в TypingMind.
- Раздельное выставление счетов: инференс модели тарифицируется CometAPI; лицензирование TypingMind — отдельно.
What is TypingMind
TypingMind — это интерфейс чата с ИИ, который подключается к моделям через предоставленные вами API-ключи. Он дает единое место для выбора моделей и управления беседами. TypingMind предоставляет интерфейс; подключенный API-сервис обрабатывает запросы к моделям и учет использования.
CometAPI предоставляет TypingMind общий API-канал для поддерживаемых моделей от нескольких провайдеров, включая GPT, Claude, Gemini и DeepSeek. Вы можете управлять доступом к API и биллингом через один аккаунт CometAPI, а затем создавать отдельные записи пользовательских моделей в TypingMind для тех моделей, которые хотите использовать. Это упрощает пробу разных моделей для письма, программирования или повседневных вопросов без настройки отдельного API-аккаунта у каждого провайдера.
What Do You Need Before Connecting CometAPI to TypingMind?
Создайте ключ в разделе API Keys в аккаунте CometAPI, следуя инструкциям по созданию ключа. Используйте выделенный ключ для этого подключения, чтобы при необходимости можно было его отозвать, не затрагивая другие интеграции. Не допускайте попадания ключа на скриншоты, в общие документы и публичные репозитории.
CometAPI поддерживает несколько семейств моделей, включая GPT, Claude, Gemini и DeepSeek; он не ограничивается GPT-6 Luna. В этом руководстве GPT-6 Luna (ID модели: gpt-6-luna) используется только как пример для таблицы конфигурации и терминального теста. Вы можете выбрать другую модель из каталога моделей CometAPI, если ваш аккаунт имеет к ней доступ и ее маршрут поддерживает OpenAI Chat Completions.
При использовании другой модели замените gpt-6-luna на точный ID этой модели как в TypingMind, так и в запросе cURL. Также обновите отображаемое имя, длину контекста, тарифы и настройки возможностей в соответствии с выбранной моделью. Настройки модели из примера не следует считать применимыми ко всем моделям.
Используйте конфигурацию ниже. TypingMind нужна полная ссылка на конечную точку; базовый URL SDK, оканчивающийся на /v1, — это другое поле и подставлять его сюда не нужно.
| Поле TypingMind | Значение |
|---|---|
| Name | GPT-6 Luna через CometAPI |
| Model ID | gpt-6-luna |
| API type | OpenAI Chat Completions API |
| Endpoint URL | https://api.cometapi.com/v1/chat/completions |
| Authentication | API Key via HTTP Header |
| Header key | Authorization |
| Header value | Bearer YOUR_COMETAPI_API_KEY |
How Do You Add CometAPI to TypingMind?
Create a custom model
Откройте TypingMind, выберите Models и нажмите Add custom model. Оставьте включенным Create Manually. Документация по этим элементам есть в руководстве по ручной конфигурации.
Enter the model details
Скопируйте имя и ID модели из таблицы конфигурации. Если требуется Context Length, используйте задокументированный лимит выбранной модели; задокументированное окно контекста GPT-6 Luna — 1,050,000 tokens. Ограничение контекста — это параметр вместимости, а не рекомендация отправлять столько токенов.
Set the endpoint and authentication
В разделе Authentication введите тип API, конечную точку, ключ заголовка и значение заголовка из таблицы. Замените YOUR_COMETAPI_API_KEY на ваш фактический ключ. После Bearer должен быть один пробел и никаких кавычек.
Оба скриншота взяты из официального руководства TypingMind. Пустая форма аутентификации иллюстрирует расположение полей; введите свой endpoint CometAPI, ID модели и ключ.
Test and save the connection
Начните с текстового чата и оставьте необязательные переопределения запроса неустановленными. Нажмите Test & Save, выберите сохраненную модель и отправьте: «Объясните различия между REST API и WebSockets в трех предложениях». Видимый ответ ассистента подтверждает базовое подключение. Отправьте продолжение, чтобы проверить, что беседа продолжается.
Enable optional capabilities
Начните с текстового чата. Включайте потоковую передачу ответов (streaming), системные подсказки, ввод изображений, инструменты или параметры рассуждения только при их поддержке. Тестируйте расширенные возможности отдельно.
Настройки TypingMind для Capabilities предлагают автоматические проверки и ручные переключатели. Рассматривайте обнаружение как отправную точку: проверяйте каждую функцию с выбранной моделью и маршрутом. Сохраняйте рабочую базовую конфигурацию, чтобы можно было убрать последнее переопределение, если тест функции не удался.
How Do You Check the CometAPI Request Outside TypingMind?
Используйте этот необязательный тест, если Test & Save не проходит. Он отправляет минимальный запрос с тем же ключом и ID модели согласно задокументированному формату запроса Chat Completions CometAPI. Это не требует изменений конфигурации TypingMind.
Set the key for the current Bash session
Выполните следующее в Bash, включая Git Bash или WSL в Windows. Вставьте ключ в скрываемую подсказку. Эти команды — синтаксис Bash; не вставляйте их в PowerShell без изменений.
read -r -s -p "CometAPI API key: " COMETAPI_API_KEYprintf '\n'export COMETAPI_API_KEY
Send a minimal chat request
curl --include --silent --show-error \ https://api.cometapi.com/v1/chat/completions \ -H "Authorization: Bearer $COMETAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-luna", "messages": [ {"role": "user", "content": "Explain API gateways in one sentence."} ] }'
Проверьте в choices[0].message.content текст ассистента. Если cURL возвращает HTTP-ошибку, прочитайте тело ответа до изменения настроек. Если в терминале запрос успешен, а в TypingMind — нет, сравните конечную точку, ключ, ID модели и необязательные переопределения, затем проверьте вкладку Network в браузере. Успешный запрос из терминала подтверждает корректность пути запроса; он не гарантирует доступ из браузера или поддержку всех возможностей модели.
Remove the temporary environment variable
unset COMETAPI_API_KEY
How to Troubleshoot TypingMind Connection Errors
Используйте тело ответа и вкладку Network в браузере, чтобы определить запрос, который завершается с ошибкой. Приведенные ниже проверки — отправная точка, а не диагноз, основанный только на статус-коде. Не включайте учетные данные в скриншоты и сообщения в поддержку.
| Симптом | Что проверить сначала | Следующее действие |
|---|---|---|
| 401 Unauthorized | Ключ и заголовок Authorization | Проверьте, не истек ли ключ, не отозван ли он, нет ли лишних пробелов или отсутствующего префикса Bearer. |
| 403 Forbidden | Тело ответа и доступ к модели | Подтвердите права аккаунта и доступ к выбранному маршруту. |
| 404 Not Found | Endpoint и точный ID модели | Используйте полный URL /v1/chat/completions и подтвердите ID в каталоге. |
| 400 Bad Request | Тело запроса и переопределения | Уберите необязательные параметры и повторите простой текстовый запрос. |
| 429 Too Many Requests | Подробности об ограничении/квоте | Проверьте лимиты аккаунта и кредит. Приостановите повторные попытки при rate limit; пополните квоту перед повтором. |
| Browser network error | Вкладка Network и консоль | Проверьте подключение и возможные ошибки cross-origin; сравните с тестом в терминале. |
| Streaming fails | Настройку streaming и поддержку маршрута | Повторите с отключенным streaming, чтобы сузить проблему. |
API может работать в Python или cURL, но не работать в браузере из-за ограничений на междоменные запросы. Не выставляйте неограниченный API-ключ через небезопасный публичный прокси только для обхода CORS.
FAQ
Могу ли я сохранить существующее подключение TypingMind при добавлении CometAPI?
Да: создайте отдельную запись пользовательской модели с отличающимся отображаемым именем, а не редактируйте существующую запись провайдера. Сохраните исходный endpoint и настройки модели, пока вы проверяете подключение CometAPI. Сначала тестируйте в новом чате, чтобы длина старой беседы или вложения не скрыли базовую ошибку настройки.
Как правильно ротировать ключ CometAPI, используемый в TypingMind?
Создайте заменяющий ключ, обновите каждую запись пользовательской модели, использующую старый ключ, и протестируйте новый запрос из каждой записи. Отзовите старый ключ после успешной замены. Если старый ключ был раскрыт, немедленно отзовите его и восстановите затронутые подключения новым ключом.
Почему оценка стоимости в TypingMind может отличаться от счета CometAPI?
TypingMind оценивает использование на основе ставок, введенных в настройках Pricing. Устаревшие ставки или различия в кэше, уровнях контекста или учете reasoning-токенов могут привести к расхождению. Сравните текущие ставки модели и использование по конкретному запросу с информацией о биллинге CometAPI; не воспринимайте клиентскую оценку как конечное списание.
Conclusion
Чтобы подключить CometAPI к TypingMind, создайте пользовательскую модель вручную, укажите полную конечную точку Chat Completions, добавьте заголовок Authorization и протестируйте простой текстовый запрос. Сохраните рабочую базовую конфигурацию перед включением дополнительных функций. При сбоях настройки минимальный запрос cURL помогает отличить ошибки аккаунта или API от проблем браузера и фронтенд-настроек.