Dokumentasi

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.

Pengaturan → Perutean Model → Tambahkan → URL Kustom
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-sol
Periksa paket Amp Anda terlebih dahulu. Halaman Model Routing Amp menyatakan, per 2026-09-21, bahwa “router dan gateway model AI bersifat eksperimental dan sedang dalam akses awal, hanya untuk pelanggan Megawatt, Gigawatt, dan Enterprise. Kami akan segera meluncurkannya untuk semua orang.” Koneksi Custom URL termasuk dalam kategori tersebut, jadi menu Add tidak akan menawarkannya pada akun Hobby. Amp belum mengumumkan tanggal peluncuran, dan halaman ini tidak memprediksikannya.
Kunavo belum menjalankan Amp dengan endpoint ini. Semua kolom di atas merujuk pada dokumentasi Amp sendiri, bukan sesi yang telah diselesaikan oleh siapa pun di sini—fitur ini hanya tersedia melalui paket Amp berbayar. Anggap ini sebagai transkripsi spesifikasi Amp, dan gunakan Check Access untuk memastikan fitur ini berfungsi.
chat-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.
Model sistem Dictation dan Realtime Voice Amp adalah fitur suara, sedangkan Kunavo tidak menyediakan model ucapan-ke-teks maupun teks-ke-ucapan. Koneksi Custom URL di sini tidak dapat digunakan untuk keduanya; biarkan baris tersebut tetap menggunakan Amp.
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 Amp.

Langkah demi langkah

  1. Buat key di /app/keys dan salin — key hanya ditampilkan sekali.
  2. 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.
  3. Atur format API ke chat-completions, tempelkan https://api.kunavo.com/v1 sebagai URL dasar, lalu masukkan kunci sk-kn- Anda. Amp mengirimkannya sebagai Authorization: Bearer <key> dalam semua format; Kunavo mengautentikasi melalui header tersebut, jadi biarkan Headers dan Query Parameters kosong.
  4. 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 menggunakan openai/gpt-5.6-sol, sedangkan Kunavo menerima gpt-5-6-sol), jadi panah tersebut wajib dicantumkan. Gunakan pemilih Models untuk memasukkan ID kanonis, bukan mengetiknya dari ingatan.
  5. 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.

Ini versi singkatnya. Panduan lengkap — pilihan model, biaya sesi nyata, dan mode kegagalan — ada di biaya Amp sendiri dan bagian yang tagihannya berubah atau tidak berubah setelah menambahkan koneksi.

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 modelKunavo masuk / keluarKegunaannya di Amp
gpt-5-6-sol$2.00 / $12.00agen utama mode Medium dan Puck — model kerja default Amp
gpt-6-astra$4.00 / $20.00agen utama mode High dan subagen Oracle di sebagian besar mode
claude-fable-5-1$7.00 / $35.00agen utama mode Ultra, yang dikhususkan untuk pekerjaan terbuka yang sulit
gpt-5-6-terra$0.70 / $4.20subagen Search — penelusuran basis kode, tempat volume menjadi faktor utama
claude-haiku-4-5$0.70 / $3.50View Media, model Amp untuk gambar, PDF, dan video — Claude membaca gambar, bukan video
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.

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.