TL;DR
TypingMind to elastyczny interfejs czatu AI, który pozwala łączyć GPT, Claude, DeepSeek i inne obsługiwane modele przy użyciu własnych kluczy API. Integrując CometAPI przez zgodne z OpenAI połączenie, możesz uzyskać dostęp do wielu modeli AI bez konfigurowania oddzielnych kont dostawców. Ten przewodnik wyjaśnia, jak dodać model niestandardowy przy użyciu klucza API CometAPI i endpointu Chat Completions, wysłać pierwszą wiadomość oraz rozwiązywać typowe błędy konfiguracji. Potrzebujesz klucza API CometAPI, dostępnych środków na koncie oraz dostępu do ustawień modeli niestandardowych w TypingMind. Zacznij od podstawowego promptu tekstowego, a następnie włączaj zaawansowane możliwości w razie potrzeby. Dla testu połączenia z API dołączono opcjonalny przykład Bash i cURL.
Key Takeaways
- Jeden klucz API, wiele modeli: dostęp do obsługiwanych dostawców przez jedno konto CometAPI.
- Integracja zgodna z OpenAI: skonfiguruj standardowy endpoint Chat Completions bez niestandardowego SDK.
- Elastyczny wybór modeli: zarejestruj wiele modeli opartych na CometAPI w TypingMind.
- Oddzielne rozliczenia: inferencja modelu jest rozliczana przez CometAPI; licencja TypingMind jest oddzielna.
What is TypingMind
TypingMind to interfejs czatu AI, który łączy się z modelami przez dostarczone przez Ciebie klucze API. Zapewnia jedno miejsce do wyboru modeli i zarządzania rozmowami. TypingMind dostarcza interfejs; podłączona usługa API obsługuje żądania do modelu i rozliczanie użycia.
CometAPI zapewnia TypingMind wspólne połączenie API dla obsługiwanych modeli od wielu dostawców, w tym GPT, Claude, Gemini i DeepSeek. Możesz zarządzać dostępem do API i rozliczeniami przez jedno konto CometAPI, a następnie tworzyć oddzielne wpisy modeli niestandardowych w TypingMind dla modeli, których chcesz używać. Ułatwia to testowanie różnych modeli do pisania, kodowania lub codziennych pytań bez zakładania oddzielnego konta API u każdego dostawcy.
What Do You Need Before Connecting CometAPI to TypingMind?
Utwórz klucz w sekcji API Keys konta CometAPI, postępując zgodnie z instrukcjami tworzenia klucza. Użyj dedykowanego klucza dla tego połączenia, aby móc go odwołać bez zakłócania innych integracji. Nie umieszczaj klucza na zrzutach ekranu, w udostępnianych dokumentach ani publicznych repozytoriach.
CometAPI obsługuje wiele rodzin modeli, w tym GPT, Claude, Gemini i DeepSeek; nie jest ograniczony do GPT-6 Luna. Ten samouczek używa GPT-6 Luna (ID modelu: gpt-6-luna) wyłącznie jako przykładu dla tabeli konfiguracji i testu w terminalu. Możesz wybrać inny model z katalogu modeli CometAPI, o ile Twoje konto ma do niego dostęp i jego trasa obsługuje OpenAI Chat Completions.
Korzystając z innego modelu, zamień gpt-6-luna na dokładny ID tego modelu zarówno w TypingMind, jak i w żądaniu cURL. Zaktualizuj również nazwę wyświetlaną, długość kontekstu, ceny i ustawienia możliwości tak, aby pasowały do wybranego modelu. Ustawienia przykładowego modelu nie powinny być traktowane jako obowiązujące dla każdego modelu.
Użyj poniższej konfiguracji. TypingMind potrzebuje pełnego adresu URL endpointu; podstawowy adres URL SDK kończący się na /v1 to inne pole i nie powinien być używany w tym miejscu.
| Pole w TypingMind | Wartość |
|---|---|
| Name | GPT-6 Luna via 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
Otwórz TypingMind, wybierz Models i kliknij Add custom model. Pozostaw Create Manually. Przewodnik konfiguracji ręcznej dokumentuje te ustawienia.
Enter the model details
Skopiuj nazwę i ID modelu z tabeli konfiguracji. Jeśli wymagane jest pole Context Length, użyj udokumentowanego limitu wybranego modelu; udokumentowane okno kontekstu GPT-6 Luna to 1,050,000 tokenów. Limit kontekstu to ustawienie pojemności, a nie rekomendacja wysyłania tylu tokenów.
Set the endpoint and authentication
W sekcji Authentication wprowadź typ API, endpoint, klucz nagłówka i wartość nagłówka z tabeli. Zastąp YOUR_COMETAPI_API_KEY swoim rzeczywistym kluczem. Dodaj jedną spację po Bearer i nie używaj cudzysłowów.
Oba zrzuty pochodzą z oficjalnego przewodnika TypingMind. Pusty formularz uwierzytelniania ilustruje rozmieszczenie pól; wprowadź własny endpoint CometAPI, ID modelu i klucz.
Test and save the connection
Zacznij od czatu tekstowego i pozostaw opcjonalne nadpisania żądań niewypełnione. Kliknij Test & Save, wybierz zapisany model i wyślij: “Wyjaśnij różnice między REST API a WebSockets w trzech zdaniach.” Widoczna odpowiedź asystenta potwierdza podstawowe połączenie. Wyślij wiadomość uzupełniającą, aby sprawdzić ciągłość rozmowy.
Enable optional capabilities
Zacznij od czatu tekstowego. Włącz strumieniowanie, prompty systemowe, wejście obrazów, narzędzia lub kontrolki rozumowania tylko wtedy, gdy są obsługiwane. Testuj zaawansowane możliwości osobno.
Ustawienia Capabilities w TypingMind oferują automatyczne sprawdzanie i ręczne sterowanie. Traktuj wykrywanie jako punkt wyjścia: weryfikuj każdą funkcję z wybranym modelem i trasą. Zachowaj działającą podstawową konfigurację, aby móc usunąć najnowsze nadpisanie, jeśli test funkcji się nie powiedzie.
How Do You Check the CometAPI Request Outside TypingMind?
Użyj tego opcjonalnego testu, gdy Test & Save się nie powiedzie. Wysyła minimalne żądanie używając tego samego klucza i ID modelu, zgodnie z udokumentowanym formatem żądania Chat Completions CometAPI. Nie wymaga zmieniania konfiguracji TypingMind.
Set the key for the current Bash session
Uruchom poniższe w Bash, w tym w Git Bash lub WSL na Windows. Wklej klucz przy ukrytym monicie. Te polecenia używają składni Bash i nie powinny być wklejane bez zmian do 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."} ] }'
Sprawdź choices[0].message.content pod kątem tekstu asystenta. Jeśli cURL zwróci błąd HTTP, przeczytaj treść odpowiedzi przed zmianą ustawień. Jeśli się powiedzie, a TypingMind zawodzi, porównaj endpoint, klucz, ID modelu i opcjonalne nadpisania, a następnie sprawdź panel Sieć w przeglądarce. Udane żądanie w terminalu potwierdza tę ścieżkę żądania; nie weryfikuje dostępu z przeglądarki ani każdej możliwości modelu.
Remove the temporary environment variable
unset COMETAPI_API_KEY
How to Troubleshoot TypingMind Connection Errors
Użyj treści odpowiedzi i panelu Sieć w przeglądarce, aby zidentyfikować nieudane żądanie. Poniższe kontrole to punkty wyjścia, a nie diagnoza wyłącznie na podstawie kodu statusu. Nie umieszczaj danych uwierzytelniających na zrzutach ekranu i w zgłoszeniach do wsparcia.
| Objaw | Pierwsza kontrola | Kolejne działania |
|---|---|---|
| 401 Unauthorized | Klucz i nagłówek Authorization | Sprawdź wygasły lub odwołany klucz, dodatkowe spacje lub brak prefiksu Bearer. |
| 403 Forbidden | Treść odpowiedzi i dostęp do modelu | Potwierdź uprawnienia konta i dostęp do wybranej trasy. |
| 404 Not Found | Endpoint i dokładny ID modelu | Użyj pełnego adresu URL /v1/chat/completions i potwierdź ID w katalogu. |
| 400 Bad Request | Treść żądania i nadpisania | Usuń parametry opcjonalne i spróbuj ponownie z prostym żądaniem tekstowym. |
| 429 Too Many Requests | Szczegóły limitu/kwoty | Sprawdź limity konta i środki. Wstrzymaj próby objęte limitami; uzupełnij środki przed ponowieniem. |
| Błąd sieci przeglądarki | Panel Sieć i konsola | Sprawdź łączność i ewentualne błędy cross-origin; porównaj z testem w terminalu. |
| Strumieniowanie nie działa | Ustawienie i wsparcie trasy | Spróbuj ponownie z wyłączonym strumieniowaniem, aby odizolować problem. |
API może działać w Pythonie lub cURL, ale nie w przeglądarce z powodu ograniczeń cross-origin. Nie ujawniaj nieograniczonego klucza API przez niezabezpieczony publiczny proxy tylko po to, by obejść CORS.
FAQ
Can I keep an existing TypingMind connection while adding CometAPI?
Tak: utwórz oddzielny wpis modelu niestandardowego z wyróżniającą się nazwą wyświetlaną zamiast edytować istniejący wpis dostawcy. Zachowaj oryginalny endpoint i ustawienia modelu podczas weryfikacji połączenia CometAPI. Najpierw testuj w nowym czacie, aby długość starej rozmowy lub załączniki nie zaciemniały podstawowego błędu konfiguracji.
How should I rotate a CometAPI key used in TypingMind?
Utwórz klucz zastępczy, zaktualizuj każdy wpis modelu niestandardowego używający starego klucza i przetestuj nowe żądanie z każdego wpisu. Odwołaj stary klucz po potwierdzeniu działania nowego. Jeśli stary klucz został ujawniony, natychmiast go odwołaj i przywróć działanie połączeń nowym kluczem.
Why can TypingMind’s cost estimate differ from the CometAPI bill?
TypingMind szacuje użycie na podstawie stawek wpisanych w ustawieniach Pricing. Nieaktualne stawki lub różnice w cache, warstwach kontekstu (context-tier) czy rozliczaniu tokenów rozumowania mogą powodować rozbieżności. Porównaj bieżące stawki modelu i użycie konkretnego żądania z informacjami rozliczeniowymi CometAPI; nie traktuj szacunku po stronie klienta jako ostatecznej opłaty.
Conclusion
Aby połączyć CometAPI z TypingMind, utwórz ręcznie model niestandardowy, wprowadź pełny endpoint Chat Completions, dodaj nagłówek Authorization i przetestuj prostą wiadomość tekstową. Zachowaj działającą konfigurację przed dodaniem funkcji opcjonalnych. W razie problemów z konfiguracją minimalne żądanie cURL pomaga odróżnić błędy konta lub API od ustawień przeglądarki i frontendu.