Dokumentasi

goose

goose memisahkan endpoint menjadi dua bagian: URL Host dan path permintaan yang ditambahkannya sendiri. Berikan origin polos dan biarkan path apa adanya, maka provider OpenAI bawaan akan menghubungkan goose ke Claude dan GPT menggunakan satu key.

Settings → Models → Configure providers → OpenAI: Host URL menerima origin tanpa tambahan apa pun, karena goose sendiri menambahkan jalur permintaan (v1/chat/completions).

Konfigurasikan penyedia → OpenAI, atau lingkungan

# goose Desktop → Settings → Models → Configure providers → OpenAI
API Key           sk-kn-...
Host URL          https://api.kunavo.com
Organization ID   (leave blank)
Project           (leave blank)

# …or as environment variables, which goose CLI reads too:
OPENAI_API_KEY=sk-kn-...
OPENAI_HOST=https://api.kunavo.com

# OPENAI_BASE_PATH is left unset on purpose. Its default is
# v1/chat/completions, which is the path Kunavo serves — that default is
# exactly why Host URL above carries no /v1.

URL Host tidak menyertakan /v1. goose mendokumentasikan OPENAI_BASE_PATH sebagai “Path permintaan yang ditambahkan ke host (default-nya v1/chat/completions)”, dan meminta pengguna proxy untuk menetapkan OPENAI_HOST ke “root proxy Anda (tanpa path di akhir)”. Kedua petunjuk itu menjelaskan pengaturannya: masukkan origin ke kolom tersebut, lalu /v1 akan ditambahkan melalui path default. Mengetik https://api.kunavo.com/v1 akan meminta /v1/v1/chat/completions — dan di halaman yang sama disebutkan bahwa 404 berarti path-nya salah, bukan key-nya.

Konfigurasi ini dirujuk dari dokumentasi goose sendiri pada tanggal di bawah. Kunavo belum menjalankan goose ke endpoint-nya — belum ada sesi, giliran streaming, ataupun round-trip tool. Halaman penyiapan yang dipublikasikan bukanlah pengujian, dan tidak ada bagian di sini yang menyatakan sebaliknya; curl di bawah adalah bagian yang dapat Anda periksa dalam sepuluh detik, sementara perilaku klien menjadi urusan Anda dan goose.

Kunavo tidak menyediakan model embedding, text-to-speech, ataupun speech-to-text, jadi endpoint ini hanya merespons permintaan chat completion. Semua pengaturan goose Anda yang mentranskripsikan audio atau membuat indeks vektor tetap menggunakan key provider yang sudah dimilikinya — mengarahkan provider OpenAI ke sini tidak mengalihkan permintaan tersebut.

Belum punya kunci? Buat akun Kunavo, buat kunci (diawali sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan goose.

Langkah demi langkah

Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
Di goose Desktop: sidebar → Pengaturan → Model → Konfigurasi provider → OpenAI. Di CLI: goose configure → Konfigurasi Provider → OpenAI.
Isi API Key dan URL Host. Biarkan ID Organisasi dan Proyek kosong — goose mendokumentasikan kolom tersebut untuk pelacakan penggunaan dan pengelolaan sumber daya pada akun OpenAI sendiri, dan Kunavo tidak memiliki kolom setara untuk diisi. Klik Kirim.
Pilih model. Catatan goose secara eksplisit menyebutkan bahwa goose configure “tidak mendukung entri nama model kustom” — jadi jika ID yang Anda inginkan tidak ada dalam daftar yang muncul, ketikkan di goose Desktop atau tetapkan GOOSE_MODEL di config.yaml, yang menggantikan isi file untuk proses tersebut.
Mulai sesi dan berikan tugas yang melibatkan file. goose mengandalkan pemanggilan tool untuk hampir semua hal yang dilakukannya — halaman provider-nya sendiri memperingatkan bahwa model tanpa pemanggilan tool “hanya dapat melakukan chat completion” dan ekstensi harus dinonaktifkan untuk model tersebut — jadi uji coba pertama yang membaca dan mengedit sesuatu memberi lebih banyak informasi daripada sapaan.

Diperiksa terhadap halaman goose Configure LLM Provider pada 29 September 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 goose.

# 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.

ID model	Kunavo masuk / keluar	Kegunaannya di goose
`claude-sonnet-5`	$1.40 / $7.00	model kerja default untuk sesi yang mengedit file
`claude-opus-5`	$3.50 / $17.50	merencanakan perubahan yang akan mahal jika salah
`claude-haiku-4-5`	$0.70 / $3.50	giliran murah — triase, ringkasan, loop yang berjalan sepanjang hari
`gpt-5-6-sol`	$2.00 / $12.00	pendapat kedua dari keluarga model lain, dengan key dan URL Host yang sama

Penagihan dilakukan per token dari saldo prabayar tanpa biaya bulanan — lihat penagihan. Pada konteks berulang — yang merupakan sebagian besar kiriman editor atau klien obrolan — caching prompt lebih memengaruhi tagihan daripada pilihan model.

Cara lain: file provider Kunavo

goose juga memuat definisi provider dari file JSON di direktori custom_providers. Provider yang ditambahkan dengan cara ini akan memiliki entri, key, dan daftar model tersimpan tersendiri di pemilih, tanpa menggunakan ulang slot bernama OpenAI. Kunavo menyediakan file di kunavo.com/goose/kunavo.json. File tersebut dibuat dari katalog aktif, sehingga daftar modelnya mencakup model yang disediakan Kunavo saat ini, dan hanya memuat nama variabel key, bukan key itu sendiri:

terminal

# macOS / Linux — goose reads every JSON file in this directory
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://kunavo.com/goose/kunavo.json \
  -o ~/.config/goose/custom_providers/kunavo.json

# The file names the variable; the key itself never goes in the file
export KUNAVO_API_KEY=sk-kn-...
goose session start --provider kunavo

Di Windows, direktorinya adalah %APPDATA%\Block\goose\config\custom_providers\. Di goose Desktop, provider tersebut kemudian muncul di bagian Konfigurasi provider sebagai Kunavo, tempat key dapat disimpan di keychain, bukan di variabel lingkungan.

Endpoint. File tersebut menetapkan base_url ke https://api.kunavo.com/v1. Dokumentasi goose tidak menjelaskan apakah kolom itu mengharapkan base /v1 atau /v1/chat/completions lengkap seperti yang ditampilkan dalam contohnya; source-nya menjelaskan bahwa derive_base_path mengubah keduanya menjadi path v1/chat/completions yang sama.
ID GPT menggunakan Responses API. goose mengirim ID model yang diawali gpt-5 atau gpt-6 ke /v1/responses, dan semua ID lainnya ke /v1/chat/completions. Kunavo menyediakan keduanya, sehingga ID Claude dan GPT dalam file tersebut berfungsi dengan satu key.
Hanya model dengan pemanggilan tool yang dicantumkan. goose mengandalkan tool di hampir setiap giliran, jadi model gambar, video, dan audio tidak disertakan dalam file meskipun dapat dipanggil menggunakan key yang sama.

Catatan yang sama seperti bagian lain halaman ini berlaku: informasi ini dirujuk dari dokumentasi dan source goose, bukan hasil pengujian. Ingin menulis file provider sendiri? Konfigurasi provider → Tambahkan provider kustom meminta informasi yang sama — tipe OpenAI Compatible, URL API https://api.kunavo.com/v1, key sk-kn- Anda, dan daftar model yang dipisahkan koma.

Pertanyaan umum

Bagaimana cara mengarahkan goose ke API kustom yang kompatibel dengan OpenAI?

Gunakan provider OpenAI bawaan dan masukkan host. Di goose Desktop, buka Settings → Models → Configure providers → OpenAI; kolomnya adalah API Key, Host URL, Organization ID, dan Project. Di CLI, buka `goose configure` → Configure Providers → OpenAI, lalu masukkan nilai yang sama saat diminta. Sebagai variabel lingkungan, gunakan OPENAI_API_KEY dan OPENAI_HOST. Jika Anda memerlukan beberapa endpoint sekaligus, alur Add Custom Provider di goose memberi setiap endpoint entri tersendiri dalam daftar provider.

Apakah URL Host goose harus diakhiri dengan /v1?

Tidak, dan menambahkannya akan merusak permintaan. goose mendokumentasikan OPENAI_BASE_PATH sebagai path permintaan yang ditambahkan ke host, dengan default v1/chat/completions, serta meminta pengguna proxy untuk menetapkan OPENAI_HOST ke root proxy tanpa path di akhir. Jadi, kolom tersebut menggunakan origin polos — https://api.kunavo.com — dan /v1 ditambahkan melalui path default. Host yang diakhiri dengan /v1 akan meminta /v1/v1/chat/completions, yang menghasilkan 404, bukan error autentikasi.

Mengapa goose mengembalikan 404 setelah saya menetapkan host kustom?

Menurut jawaban goose sendiri, 404 biasanya berarti base path tidak sesuai dengan endpoint: kebanyakan proxy menyediakan v1/chat/completions, sebagian menyediakan chat/completions tanpa v1, dan nilai yang Anda tetapkan harus sesuai. Kunavo menyediakan v1/chat/completions, yaitu default goose. Jadi, 404 pada Kunavo biasanya berarti /v1 juga dimasukkan ke host sehingga path-nya menjadi ganda. Respons 401 yang menyatakan tidak ada API key yang diberikan adalah masalah lain — goose mendokumentasikan bahwa key yang ditempatkan di config.yaml akan diabaikan.

Bisakah goose menggunakan model Claude melalui endpoint yang kompatibel dengan OpenAI?

Ya. Jenis provider menunjukkan protokol wire, bukan vendor: goose mengirim chat completion berformat OpenAI ke host yang Anda konfigurasi dan meneruskan ID model apa adanya, sehingga ID Claude diresolusikan oleh endpoint tersebut, bukan di dalam goose. Perlu diingat bahwa goose banyak menggunakan pemanggilan tool, dan halaman provider-nya menyebutkan bahwa model tanpa pemanggilan tool hanya dapat melakukan chat completion, dengan ekstensi dinonaktifkan — jadi pilih ID yang mendukung tool.

Apakah penyiapan ini sudah diuji oleh Kunavo?

Tidak. Yang diperiksa adalah dokumentasi goose sendiri (21 dan 29 September 2026) — nama kolom, urutannya, serta aturan host dan path dikutip dari sana — dan, untuk file provider, source provider goose (29 September). Kunavo belum menjalankan sesi goose ke endpoint-nya dan tidak membuat klaim mengenai streaming, round-trip tool, atau perilaku ekstensi di klien ini. Satu hal yang dapat Anda pastikan secara terpisah adalah apakah endpoint dan key berfungsi, dengan curl di halaman ini.

Apakah ada file provider Kunavo siap pakai untuk goose?

Ya: https://kunavo.com/goose/kunavo.json. Simpan file tersebut ke direktori custom_providers goose (~/.config/goose/custom_providers/ di macOS dan Linux, %APPDATA%\Block\goose\config\custom_providers\ di Windows), tetapkan KUNAVO_API_KEY, lalu Kunavo akan muncul dalam daftar provider dengan ID model yang sudah terisi. File tersebut dibuat dari katalog aktif, sehingga hanya mencantumkan model yang saat ini disediakan Kunavo, dan tidak memuat key.