TL;DR
TypingMind adalah antarmuka chat AI yang fleksibel yang memungkinkan Anda menghubungkan GPT, Claude, DeepSeek, dan model lain yang didukung menggunakan kunci API milik Anda. Dengan mengintegrasikan CometAPI melalui koneksi yang kompatibel dengan OpenAI, Anda dapat mengakses banyak model AI tanpa mengonfigurasi akun penyedia terpisah. Panduan ini menjelaskan cara menambahkan model kustom menggunakan kunci API CometAPI dan endpoint Chat Completions, mengirim pesan pertama Anda, serta menelusuri kesalahan umum saat penyiapan. Anda memerlukan kunci API CometAPI, kredit akun yang tersedia, dan akses ke pengaturan model kustom TypingMind. Mulailah dengan prompt teks dasar, lalu aktifkan kapabilitas lanjutan sesuai kebutuhan. Contoh Bash dan cURL opsional juga disertakan untuk menguji koneksi API.
Key Takeaways
- Satu kunci API, banyak model: akses penyedia yang didukung melalui satu akun CometAPI.
- Integrasi kompatibel OpenAI: konfigurasikan endpoint standar Chat Completions tanpa SDK kustom.
- Pemilihan model fleksibel: daftarkan beberapa model berbasis CometAPI di TypingMind.
- Penagihan terpisah: inferensi model ditagihkan oleh CometAPI; lisensi TypingMind terpisah.
What is TypingMind
TypingMind adalah antarmuka chat AI yang terhubung ke model melalui kunci API yang Anda sediakan. Ini memberikan satu tempat untuk memilih model dan mengelola percakapan. TypingMind menyediakan antarmuka; layanan API yang terhubung menangani permintaan model dan penagihan penggunaan.
CometAPI memberi TypingMind koneksi API bersama untuk model yang didukung dari berbagai penyedia, termasuk GPT, Claude, Gemini, dan DeepSeek. Anda dapat mengelola akses API dan penagihan melalui satu akun CometAPI, lalu membuat entri model kustom terpisah di TypingMind untuk model yang ingin Anda gunakan. Ini memudahkan untuk mencoba model berbeda untuk menulis, coding, atau pertanyaan sehari-hari tanpa menyiapkan akun API terpisah untuk tiap penyedia.
What Do You Need Before Connecting CometAPI to TypingMind?
Buat kunci melalui bagian API Keys di akun CometAPI, mengikuti instruksi pembuatan kunci. Gunakan kunci khusus untuk koneksi ini sehingga Anda dapat mencabutnya tanpa mengganggu integrasi lain. Jaga agar kunci tetap tidak muncul di tangkapan layar, dokumen bersama, dan repositori publik.
CometAPI mendukung berbagai keluarga model, termasuk GPT, Claude, Gemini, dan DeepSeek; tidak terbatas pada GPT-6 Luna. Tutorial ini menggunakan GPT-6 Luna (ID model: gpt-6-luna) hanya sebagai contoh untuk tabel konfigurasi dan pengujian terminal. Anda dapat memilih model lain dari katalog model CometAPI, selama akun Anda dapat mengaksesnya dan rutenya mendukung OpenAI Chat Completions.
Saat menggunakan model lain, ganti gpt-6-luna dengan ID model yang persis sama baik di TypingMind maupun di permintaan cURL. Juga perbarui nama tampilan, panjang konteks, harga, dan pengaturan kapabilitas agar sesuai dengan model yang dipilih. Pengaturan model contoh tidak boleh diasumsikan berlaku untuk setiap model.
Gunakan konfigurasi di bawah ini. TypingMind memerlukan URL endpoint lengkap; URL basis SDK yang diakhiri dengan /v1 adalah kolom yang berbeda dan tidak boleh disubstitusikan di sini.
| Bidang di TypingMind | Nilai |
|---|---|
| Nama | GPT-6 Luna melalui CometAPI |
| Model ID | gpt-6-luna |
| Jenis API | OpenAI Chat Completions API |
| Endpoint URL | https://api.cometapi.com/v1/chat/completions |
| Otentikasi | API Key via HTTP Header |
| Kunci header | Authorization |
| Nilai header | Bearer YOUR_COMETAPI_API_KEY |
How Do You Add CometAPI to TypingMind?
Create a custom model
Buka TypingMind, pilih Models, dan pilih Add custom model. Biarkan Create Manually tetap dipilih. Alur konfigurasi manual mendokumentasikan kontrol ini.
Enter the model details
Salin nama dan ID model dari tabel konfigurasi. Jika Context Length diperlukan, gunakan batas yang didokumentasikan untuk model yang dipilih; jendela konteks yang didokumentasikan untuk GPT-6 Luna adalah 1.050.000 token. Batas konteks adalah pengaturan kapasitas, bukan rekomendasi untuk mengirim sejumlah token tersebut.
Set the endpoint and authentication
Di Authentication, masukkan jenis API, endpoint, kunci header, dan nilai header dari tabel. Ganti YOUR_COMETAPI_API_KEY dengan kunci Anda yang sebenarnya. Sertakan satu spasi setelah Bearer dan tanpa tanda kutip.
Kedua tangkapan layar berasal dari panduan resmi TypingMind. Formulir otentikasi kosong mengilustrasikan penempatan kolom; masukkan endpoint CometAPI, ID model, dan kunci milik Anda.
Test and save the connection
Mulailah dengan chat teks dan biarkan override permintaan opsional tidak diisi. Klik Test & Save, pilih model yang disimpan, lalu kirim: “Explain REST APIs versus WebSockets in three sentences.” Balasan asisten yang terlihat menegaskan koneksi dasar berhasil. Kirim tindak lanjut untuk memeriksa bahwa percakapan berlanjut.
Enable optional capabilities
Mulailah dengan chat teks. Aktifkan streaming, system prompts, masukan gambar, tools, atau kontrol reasoning hanya jika didukung. Uji kapabilitas lanjutan secara terpisah.
Pengaturan Capabilities di TypingMind menyediakan pemeriksaan otomatis dan kontrol manual. Perlakukan deteksi sebagai titik awal: verifikasi setiap fitur dengan model dan rute yang dipilih. Pertahankan konfigurasi dasar yang berfungsi sehingga Anda dapat menghapus override terbaru jika pengujian fitur gagal.
How Do You Check the CometAPI Request Outside TypingMind?
Gunakan pengujian opsional ini saat Test & Save gagal. Ini mengirimkan permintaan minimal menggunakan kunci dan ID model yang sama, mengikuti format permintaan Chat Completions yang didokumentasikan CometAPI. Ini tidak memerlukan perubahan konfigurasi TypingMind.
Set the key for the current Bash session
Jalankan perintah berikut di Bash, termasuk Git Bash atau WSL di Windows. Tempelkan kunci pada prompt tersembunyi. Perintah ini menggunakan sintaks Bash dan tidak boleh ditempelkan ke PowerShell tanpa perubahan.
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."} ] }'
Periksa choices[0].message.content untuk teks asisten. Jika cURL mengembalikan kesalahan HTTP, baca body respons sebelum mengubah pengaturan. Jika berhasil sementara TypingMind gagal, bandingkan endpoint, kunci, ID model, dan override opsional, lalu periksa panel Network di browser. Permintaan terminal yang berhasil menegaskan jalur permintaan tersebut; ini tidak memverifikasi akses browser atau setiap kapabilitas model.
Remove the temporary environment variable
unset COMETAPI_API_KEY
How to Troubleshoot TypingMind Connection Errors
Gunakan body respons dan panel Network browser untuk mengidentifikasi permintaan yang gagal. Pemeriksaan di bawah ini adalah titik awal, bukan diagnosis berdasarkan status code semata. Jangan sertakan kredensial dalam tangkapan layar dan pesan dukungan.
| Gejala | Pemeriksaan awal | Tindakan berikutnya |
|---|---|---|
| 401 Unauthorized | Kunci dan header Authorization | Periksa kunci kedaluwarsa atau dicabut, spasi berlebih, atau prefiks Bearer yang hilang. |
| 403 Forbidden | Body respons dan akses model | Konfirmasi izin akun dan akses ke rute yang dipilih. |
| 404 Not Found | Endpoint dan ID model yang tepat | Gunakan URL lengkap /v1/chat/completions dan konfirmasi ID di katalog. |
| 400 Bad Request | Body permintaan dan override | Hapus parameter opsional dan coba ulang permintaan teks biasa. |
| 429 Too Many Requests | Detail kuota atau batas laju | Periksa batas akun dan kredit. Jeda ulangi yang dibatasi laju; atasi kuota habis sebelum mencoba lagi. |
| Browser network error | Panel Network dan konsol | Periksa konektivitas dan error lintas asal (CORS) yang dilaporkan; bandingkan dengan uji terminal. |
| Streaming fails | Pengaturan streaming dan dukungan rute | Coba ulang dengan streaming dimatikan untuk mengisolasi kegagalan. |
API mungkin berfungsi di Python atau cURL tetapi gagal di browser karena pembatasan lintas asal. Jangan mengekspos kunci API tanpa batas melalui proxy publik yang tidak aman hanya untuk melewati CORS.
FAQ
Can I keep an existing TypingMind connection while adding CometAPI?
Ya: buat entri model kustom terpisah dengan nama tampilan yang berbeda alih-alih mengedit entri penyedia yang ada. Pertahankan endpoint dan pengaturan model asli tersedia saat Anda memvalidasi koneksi CometAPI. Uji terlebih dahulu di chat baru agar panjang percakapan lama atau lampiran tidak menutupi kesalahan penyiapan dasar.
How should I rotate a CometAPI key used in TypingMind?
Buat kunci pengganti, perbarui setiap entri model kustom yang menggunakan kunci lama, dan uji permintaan baru dari tiap entri. Cabut kunci lama setelah pengganti berfungsi. Jika kunci lama telah terekspos, segera cabut dan pulihkan koneksi yang terdampak dengan kunci baru.
Why can TypingMind’s cost estimate differ from the CometAPI bill?
TypingMind memperkirakan penggunaan dari tarif yang dimasukkan di pengaturan Pricing. Tarif usang atau perbedaan dalam cache, tier konteks, atau penghitungan reasoning token dapat menghasilkan ketidaksesuaian. Bandingkan tarif model saat ini dan penggunaan permintaan tertentu dengan informasi penagihan CometAPI; jangan anggap estimasi sisi klien sebagai biaya final.
Conclusion
Untuk menghubungkan CometAPI ke TypingMind, buat model kustom manual, masukkan endpoint lengkap Chat Completions, tambahkan header Authorization, dan uji pesan teks sederhana. Pertahankan satu konfigurasi yang berfungsi sebelum menambahkan fitur opsional. Saat penyiapan gagal, permintaan cURL minimal membantu membedakan kesalahan akun atau API dari pengaturan browser dan frontend.