Dokumentasi
Amp
Amp merutekan model di sisi server, jadi Anda tidak perlu mengatur variabel URL dasar di mesin Anda—tambahkan koneksi Custom URL di Model Routing, lalu cloud Amp akan memanggil endpoint tersebut. Fitur ini hanya tersedia pada paket berbayar, jadi hal pertama yang perlu diperiksa adalah paket Anda.
Koneksi Custom URL di Amp's Model Routing — format API chat-completions, base URL https://api.kunavo.com/v1, key sebagai bearer token — memindahkan model yang dipetakan ke satu key, pada tingkat yang menyediakan opsi tersebut.
Connection type Custom URL (Model Routing → Add)
API format chat-completions OpenAI Chat Completions API, the default
Base URL https://api.kunavo.com/v1
Key sk-kn-... sent as Authorization: Bearer <key>
Headers — nothing extra is needed
Query Parameters — nothing extra is needed
Model mapping anthropic/claude-opus-4-6 -> claude-opus-4-6
anthropic/claude-fable-5 -> claude-fable-5
openai/gpt-5.6-sol -> gpt-5-6-solchat-completions mempertahankan akhiran /v1 pada URL dasar karena Amp hanya menambahkan rute. Contoh yang diberikan Amp sendiri menjelaskan hal ini: “URL dasar https://api.example.com/v1 dengan chat-completions mengirimkan permintaan ke https://api.example.com/v1/chat/completions.” Halaman yang sama menyebutkan bahwa URL dasar yang sudah diakhiri /v1 “diterima dan tidak digandakan”, serta formulir koneksi menampilkan URL permintaan saat Anda mengetik—jadi Anda dapat memeriksa URL gabungannya sebelum menyimpan.sk-kn-) dan tambahkan kredit mulai dari $10 — panggilan dibayar dari saldo tersebut, dan panggilan yang gagal tidak ditagihkan. Dasbor kemudian terbuka pada penyiapan Amp.Langkah demi langkah
- Buat key di
/app/keysdan salin — key hanya ditampilkan sekali. - Buka Model Routing di pengaturan pribadi Anda (admin ruang kerja menggunakan Workspace Model Routing untuk berbagi satu koneksi dengan semua anggota), buka menu Add, lalu pilih Custom URL.
- Atur format API ke
chat-completions, tempelkanhttps://api.kunavo.com/v1sebagai URL dasar, lalu masukkan kuncisk-kn-Anda. Amp mengirimkannya sebagaiAuthorization: Bearer <key>dalam semua format; Kunavo mengautentikasi melalui header tersebut, jadi biarkan Headers dan Query Parameters kosong. - Tulis pemetaan model, satu pola per baris. Sisi kiri adalah ID model kanonis Amp, sedangkan sisi kanan setelah
->adalah ID yang diterima Kunavo—penulisannya berbeda (Amp menggunakanopenai/gpt-5.6-sol, sedangkan Kunavo menerimagpt-5-6-sol), jadi panah tersebut wajib dicantumkan. Gunakan pemilih Models untuk memasukkan ID kanonis, bukan mengetiknya dari ingatan. - Tekan Check Access. Amp menampilkan model endpoint saat pemetaannya luas dan mengirimkan permintaan satu token saat pemetaan menyebutkan tepat satu model. Kemudian, pastikan grafik perutean di bawah daftar koneksi menunjukkan bahwa Kunavo menyediakan model yang Anda petakan, sedangkan semua model yang tidak Anda petakan tetap menggunakan Amp.
Diperiksa terhadap Dokumentasi Model Routing Amp pada 21 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 Amp.
# 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 Amp |
|---|---|---|
gpt-5-6-sol | $2.00 / $12.00 | agen utama mode Medium dan Puck — model kerja default Amp |
gpt-6-astra | $4.00 / $20.00 | agen utama mode High dan subagen Oracle di sebagian besar mode |
claude-fable-5-1 | $7.00 / $35.00 | agen utama mode Ultra, yang dikhususkan untuk pekerjaan terbuka yang sulit |
gpt-5-6-terra | $0.70 / $4.20 | subagen Search — penelusuran basis kode, tempat volume menjadi faktor utama |
claude-haiku-4-5 | $0.70 / $3.50 | View Media, model Amp untuk gambar, PDF, dan video — Claude membaca gambar, bukan video |
Biaya yang tidak berubah setelah menambahkan koneksi
Perutean model hanya mengubah pihak yang menagih token Anda, dan tidak mengubah hal lain. Komputasi orb Amp ditagih secara terpisah per menit, jadi koneksi tidak mengubah pos tersebut—dan alat nonmodel seperti pencarian web tetap menggunakan kredit Amp, apa pun perutean modelnya. Langganan Amp yang membuka opsi Custom URL sendiri merupakan biaya tetap yang harus dibayar sebelum token pertama digunakan.
Dua model yang dijalankan Amp secara default tidak tercantum dalam tabel di atas karena Kunavo tidak menyediakannya: model GLM di balik mode Low dan subagen Read Thread. Koneksi tidak dapat meniru konfigurasi jalur termurah Amp, jadi pemetaan */* akan membuat kedua model tersebut tetap menggunakan Amp tanpa pemberitahuan. Itulah hasil yang benar, bukan kesalahan konfigurasi—aturan Amp sendiri menyatakan bahwa model apa pun yang tidak disediakan oleh koneksi akan disediakan oleh Amp.
Pertanyaan umum
Bisakah Amp menggunakan endpoint API kustom?
Ya, melalui koneksi Custom URL di Model Routing, tetapi tidak tersedia di semua paket. Dokumentasi Model Routing Amp menyatakan bahwa router dan gateway model AI—kategori yang mencakup Custom URL—bersifat eksperimental dan sedang dalam akses awal, hanya untuk pelanggan Megawatt, Gigawatt, dan Enterprise. Amp juga menyatakan akan segera meluncurkannya untuk semua orang, tanpa menyebutkan tanggal. Itulah statusnya pada 21 September 2026. Pada akun Hobby, menu Add sama sekali tidak menawarkan opsi tersebut, jadi hal pertama yang perlu diperiksa adalah paket Anda, bukan URL dasarnya.
Apakah URL dasar Amp harus diakhiri dengan /v1?
Tergantung format API yang Anda pilih, dan itulah sebabnya kolom ini sering disalahartikan. Dengan chat-completions, Amp hanya menambahkan /chat/completions, jadi URL dasar harus berupa akar /v1—contoh yang didokumentasikan Amp sendiri mengubah https://api.example.com/v1 menjadi https://api.example.com/v1/chat/completions. Dengan anthropic-messages, Amp menambahkan /v1/messages, jadi cukup gunakan origin tanpa jalur. Amp juga menyatakan bahwa URL dasar yang sudah diakhiri /v1 diterima dan tidak digandakan, serta formulir koneksi menampilkan URL permintaan gabungan saat Anda mengetik, sehingga Anda dapat memeriksanya sebelum menyimpan.
Di mana Amp menyimpan kunci API untuk endpoint kustom?
Di server Amp, bukan di mesin Anda. Amp menjadi perantara inferensi melalui cloud-nya sendiri, jadi koneksi Custom URL dikonfigurasi di Model Routing dalam pengaturan akun, bukan di berkas konfigurasi lokal atau variabel lingkungan. Endpoint yang Anda cantumkan harus dapat dijangkau dari infrastruktur Amp. Amp mengirimkan kredensial sebagai header Authorization: Bearer dalam ketiga format API-nya. Referensi pengaturan CLI Amp yang dipublikasikan tidak memuat pengaturan URL dasar maupun kunci API; fakta yang sama terlihat dari sisi klien.
Mengapa Amp masih menggunakan modelnya sendiri setelah saya menambahkan koneksi?
Karena koneksi hanya menyediakan model yang tercakup dalam pemetaannya, sedangkan Amp menyediakan semua model lainnya. Periksa tiga hal secara berurutan: apakah koneksi aktif, posisinya dalam daftar prioritas—koneksi pribadi terlebih dahulu, lalu ruang kerja, kemudian Amp, dengan prioritas 0 dicoba lebih dulu—dan apakah pemetaan model benar-benar cocok dengan model yang dijalankan mode Anda. Grafik perutean di bawah daftar koneksi menunjukkan koneksi yang menyediakan setiap model, sedangkan amp config model-providers check-access --provider-model menjalankan satu inferensi singkat dan melaporkan koneksi yang benar-benar melayaninya.
Apakah Kunavo telah menguji Amp dengan endpointnya?
Belum. Kunavo belum menguji Amp saat dijalankan, dan halaman ini merupakan transkripsi dokumentasi Model Routing Amp sendiri sebagaimana dibaca pada 21 September 2026, bukan laporan sesi yang telah diselesaikan. Fitur Custom URL dibatasi untuk paket Amp berbayar, jadi kolom-kolom di sini diperiksa berdasarkan spesifikasi Amp yang dipublikasikan, bukan melalui klien yang sedang berjalan. Tombol Check Access Amp memverifikasi kredensial dengan penyedia dan merupakan pengujian yang paling otoritatif. Jika nama kolom di halaman ini tidak lagi cocok dengan yang ditampilkan Amp, jadikan halaman Amp sebagai acuan.