TypingMind

Models → Add custom model: Endpoint URL lengkap https://api.kunavo.com/v1/chat/completions, header Authorization dengan Bearer dan key Anda, Model ID, serta panjang konteksnya — satu entri per model, dipanggil langsung dari browser.

Models  →  Add custom model  →  Create Manually

Name                    Kunavo · Claude Sonnet 5
Model ID                claude-sonnet-5
Context Length          1000000

Authentication tab
  API Type              OpenAI Chat Completions API
  Endpoint URL          https://api.kunavo.com/v1/chat/completions
  Authentication Type   API Key via HTTP Header
    Header Key          Authorization
    Header Value        Bearer sk-kn-...

Capabilities tab        tick only what you have checked (see below)
Request Options tab     leave "Route requests via TypingMind Cloud" off

                        → Test & Save

Langkah demi langkah

1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
2. Di TypingMind, buka Model di bilah samping kiri dan klik Tambahkan model kustom. Tetap di Buat Secara Manual; Impor JSON dan Impor OpenRouter ditujukan untuk sumber lain.
3. Isi Nama (apa saja), ID Model (persis seperti yang tercantum dalam GET /v1/models — misalnya claude-sonnet-5) dan Panjang Konteks. Formulir mengisi 128000 secara otomatis; tetapkan ukuran jendela konteks model yang sebenarnya dari halaman model, karena TypingMind menggunakan angka ini untuk menentukan seberapa banyak riwayat yang dikirim.
4. Di tab Authentication, pilih API Type = OpenAI Chat Completions API, tempel Endpoint URL lengkap, atur Authentication Type ke API Key via HTTP Header, lalu masukkan Header Key Authorization dan Header Value Bearer sk-kn-... — kata Bearer, spasi, lalu kunci API.
5. Di Capabilities, centang fitur secara manual atau biarkan Auto check capabilities on save aktif — formulir menyatakan bahwa sistem akan mengirim “a few test requests” saat menyimpan, yang akan membebankan biaya beberapa token. Anda juga dapat mengisi Pricing dengan tarif per sejuta token dari tabel di bawah agar tampilan biaya TypingMind sesuai dengan tagihan Anda. Lalu klik Test & Save.
6. Ulangi untuk setiap model. Tidak ada entri tingkat penyedia untuk endpoint kustom: Claude Sonnet, Claude Haiku, dan model GPT adalah tiga model kustom terpisah dengan Endpoint URL dan header yang sama.

Diperiksa terhadap Dokumentasi model TypingMind pada 1 Oktober 2026. Pengaturan pihak ketiga dapat berubah; jika nama bidang di sini tidak lagi sama dengan yang Anda lihat, halaman tersebut adalah acuan, bukan halaman ini.

Verifikasi sebelum men-debug klien

Satu permintaan menentukan apakah masalahnya ada pada endpoint, kunci, atau berkas konfigurasi. Jika ini mengembalikan JSON, base URL dan kunci yang sama berfungsi di TypingMind.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

ID model yang harus dimasukkan ke bidang

Setiap model teks dapat diakses melalui ID model — daftar terkininya ada di GET /v1/models, dan katalog beserta harga ada di halaman model. Tarif dalam USD per 1 juta token, input / output.

Tiga jenis API lainnya

Menu tarik-turun API Type pada formulir yang tersedia menawarkan OpenAI Chat Completions API, OpenAI Responses API, Claude Messages API, dan Gemini API. Kunavo mendukung tiga jenis pertama; masing-masing memerlukan rute lengkapnya sendiri di Endpoint URL.

• Claude Messages API — Endpoint URL https://api.kunavo.com/v1/messages. Contoh berformat Claude dari TypingMind sendiri menggunakan header x-api-key; Kunavo menerima header tersebut atau Authorization: Bearer pada rute ini. Kunavo hanya menyediakan ID keluarga Claude pada rute ini.
• OpenAI Responses API — Endpoint URL https://api.kunavo.com/v1/responses, dengan header Bearer yang sama. Dokumentasi TypingMind tidak memiliki contoh lengkap untuk jenis ini, jadi format rute lengkapnya disimpulkan dari tiga jenis lainnya, bukan dikutip.
• Gemini API — tidak cocok untuk endpoint ini. Gemini mengharapkan bentuk permintaan native Google; akses model Gemini melalui jenis Chat Completions.

Ini bukan TypingMind API

“TypingMind API” biasanya merujuk pada REST API instance TypingMind Teams (custom.typingmind.com), yang mengelola instance obrolan tersebut. API itu tidak menjual token model dan tidak terkait dengan konfigurasi ini. Model kustom hanyalah TypingMind yang memanggil endpoint milik pihak lain menggunakan kunci yang Anda berikan.

Dua tagihan terpisah

Lisensi TypingMind membayar penggunaan aplikasinya. Setiap pesan yang Anda kirim melalui model kustom ditagih per token oleh pemilik kunci di header — dalam hal ini, Kunavo, dari saldo prabayar. Rincian tingkatan lisensi dan biaya obrolan selama sebulan dengan tarif ini dijelaskan di Harga TypingMind dan biaya API.

Jika Test & Save gagal

• 404 dengan “POST /v1 is the base URL, not an endpoint” (atau “Not found: /” jika URL hanya mencantumkan host) — Endpoint URL tidak menyertakan rute. URL harus diakhiri dengan /v1/chat/completions (atau /v1/messages, /v1/responses untuk jenis tersebut). Sebelum 1 Oktober 2026, keduanya mengembalikan halaman HTML.
• 404 dengan “No such endpoint” — nama rutenya salah eja, misalnya /v1/chat/completion. Pesan yang sama menyebutkan rute terdekat yang disediakan Kunavo.
• 404 dengan “Not found: /chat/completions. Kunavo's API lives under /v1” — rutenya benar, tetapi tidak ada /v1: Endpoint URL yang dimasukkan adalah https://api.kunavo.com/chat/completions. Tambahkan /v1 sebelum rute. (Diperiksa pada 1 Oktober 2026; sebelum tanggal tersebut, kesalahan yang sama mengembalikan halaman HTML.)
• 401 “Missing or invalid API key” — header salah: Header Key harus berupa Authorization dan nilainya harus diawali dengan Bearer , atau kunci tersebut telah dicabut.
• Kesalahan model tidak tersedia — ejaan Model ID tidak sesuai dengan yang tercantum di GET /v1/models. ID menggunakan huruf kecil dan tanda hubung.
• Kesalahan jaringan atau CORS di konsol browser — pastikan Endpoint URL adalah https://api.kunavo.com, bukan domain situs web; host API-lah yang mengirim header CORS.