Pahami Istilah Umum AI dan Provider AI Terlebih Dahulu
Saat Anda menemui Key, Base URL, nama model, pengali harga, dan kode kesalahan, buka halaman ini terlebih dahulu untuk memahami istilah-istilah tersebut sebelum melanjutkan integrasi dan pemecahan masalah.
Istilah Dasar AI
| Istilah | Penjelasan sederhana | Apa yang perlu diperhatikan pemula? |
|---|---|---|
| model | Kemampuan AI yang sebenarnya bertanggung jawab untuk menjawab pertanyaan, menulis kode, serta menghasilkan gambar atau video. | Nama model harus disalin persis dari backend provider; jangan mengubah huruf besar/kecil, tanda hubung, atau nomor versi sendiri. |
| Large Model | Istilah umum untuk model yang dapat menangani tugas seperti bahasa alami, kode, gambar, dan lain-lain. | Lebih mahal tidak selalu berarti lebih cocok untuk Anda; model yang berbeda mungkin lebih sesuai untuk penulisan, pemrograman, gambar, atau video. |
| Multimodal | Model yang sama dapat memproses berbagai jenis input seperti teks, gambar, audio, atau video. | Alat yang mendukung multimodal bukan berarti provider dan model Anda saat ini juga mendukungnya. |
| Prompt / Instruction | Permintaan yang Anda kirimkan ke AI, misalnya, "Bantu saya merangkum konten ini." | Semakin spesifik prompt, semakin mudah mendapatkan hasil yang sesuai kebutuhan. |
| System Prompt | Aturan dengan prioritas lebih tinggi daripada pertanyaan biasa, sering digunakan untuk membatasi peran, gaya bahasa, dan batasan keamanan. | System prompt pada alat pemrograman memengaruhi cara alat tersebut membaca file dan memodifikasi kode. |
| Context Window | Jumlah konten yang dapat diingat dan diproses oleh model dalam satu waktu. | Konteks yang lebih besar tidak selalu berarti lebih pintar, tetapi lebih cocok untuk menangani dokumen panjang, proyek besar, dan percakapan multiturn yang berkelanjutan. |
| Automatic Compression / Automatic Summarization | Ketika percakapan atau konten file hampir melebihi batas konteks, beberapa alat akan meringkas konten sebelumnya menjadi rangkuman yang lebih pendek lalu melanjutkan pengiriman ke model. | Kompresi otomatis memungkinkan percakapan berlanjut, tetapi ringkasan mungkin melewatkan detail; saat memecahkan masalah, mengubah kode, atau memeriksa konfigurasi, jangan berasumsi bahwa model masih mengingat seluruh teks asli. |
| Token | Unit dasar untuk penagihan model dan penghitungan panjang teks, dapat dipahami secara sederhana sebagai potongan-potongan kecil dari teks. | Baik input maupun output mengonsumsi token; dokumen panjang dan percakapan panjang akan meningkatkan biaya secara signifikan. |
| Temperature | Parameter yang mengontrol tingkat keacakan respons. | Jika Anda menginginkan stabilitas dan hasil yang konsisten, turunkan nilainya; jika Anda menginginkan kreativitas yang bervariasi, Anda dapat menaikkannya secukupnya. |
Terkait Provider AI
| Istilah | Penjelasan sederhana | Apa yang perlu diperhatikan pemula? |
|---|---|---|
| AI provider | Meneruskan permintaan dari alat Anda ke satu atau beberapa platform layanan model. | Ini bukan model itu sendiri; fokus utamanya adalah model apa saja yang didukung, stabilitas, harga, dan rekam jejak risikonya. |
| provider | Platform yang menyediakan antarmuka AI, model, penagihan, dan manajemen backend, yang bisa berupa platform resmi atau provider AI relay. | Alamat API, key, nama model, dan metode penagihan dari provider yang berbeda bisa berbeda sama sekali. |
| Official channels | Layanan yang disediakan langsung oleh vendor model, seperti platform resmi OpenAI, Anthropic, Google, dll. | Stabilitas dan aturannya lebih jelas, tetapi mungkin memiliki batasan pembayaran, wilayah, harga, dan kuota. |
| Mirror / Proxy | Meneruskan permintaan ke lapisan perantara dari layanan target. | Beri perhatian khusus pada privasi, stabilitas, dan apakah konten permintaan disimpan saat melihat istilah ini. |
| New API / Secondary Development Panel | Banyak provider AI membangun atau mengembangkan backend berdasarkan panel sumber terbuka (open-source). | Nama menu mungkin disebut Token, Channel, Grouping, Model Multiplier, dan belum tentu sama dengan platform resmi. |
| Channel | Jalur koneksi di backend yang terhubung ke layanan model upstream tertentu. | Ketika saluran bermasalah, Key mungkin sudah benar, tetapi permintaan tetap akan gagal. |
| Model Grouping | Menetapkan model yang berbeda atau izin yang berbeda ke grup yang berbeda. | Jika key Anda tidak berada dalam grup yang sesuai, model tidak akan tersedia atau muncul pesan 'model not found'. |
| Model Mapping | Provider memetakan nama tampilan ke model upstream yang sebenarnya. | Nama tampilan di halaman web mungkin berbeda dari nama model sebenarnya; saat melakukan konfigurasi, ikuti ketentuan di backend. |
Bidang Konfigurasi
| Pengaturan | Penjelasan sederhana | Cara Mengisi |
|---|---|---|
| API | Aplikasi memanggil API model. Alat tidak membuka obrolan web, melainkan mengirim pertanyaan ke provider melalui API. | Hanya diperlukan jika alat tersebut secara eksplisit mendukung konfigurasi API. |
| API Key / Key / Secret | Rangkaian karakter yang digunakan alat untuk membuktikan identitas akun ("Saya adalah akun ini"). | Salin seluruh teks dari backend provider, jangan membagikan tangkapan layarnya secara publik, dan jangan menyalin spasi tambahan. |
| Token | Sebutan yang sering digunakan oleh banyak provider AI untuk Key di backend mereka. | Melihat token, Token, API Key, atau secret biasanya merujuk pada hal yang sama: kredensial akses. |
| Base URL / API Address | Alamat antarmuka yang disediakan oleh provider agar alat dapat meminta respons ke model. | Ini adalah tautan API; terkadang terlihat seperti beranda situs web, terkadang harus diakhiri dengan /v1, ikuti petunjuk contoh di backend. |
| Endpoint | Nama lain untuk alamat antarmuka API. | Jika melihat Endpoint di dokumentasi provider, biasanya yang dicari adalah Alamat API atau Base URL. |
| Provider | Item konfigurasi provider di dalam alat. | Bisa dipahami sebagai "provider mana, Key mana, dan alamat API mana yang ingin digunakan". |
| Model / Model ID / Model Name | Memberi tahu provider API model mana yang ingin dipanggil. | Salin persis sesuai dengan daftar model di backend; tambahkan secara manual hanya jika pengambilan daftar model gagal. |
| Compatible with OpenAI | Format API provider meniru API OpenAI, dan banyak alat cukup diisi sebagai Provider OpenAI. | Kompatibel dengan OpenAI bukan berarti mendukung semua antarmuka Claude, Gemini, gambar, dan video. |
Penagihan dan Batasan
| Istilah | Penjelasan sederhana | Apa yang perlu diperhatikan pemula? |
|---|---|---|
| Balance | Jumlah uang atau poin yang masih dapat Anda gunakan di akun provider. | Saldo yang tidak mencukupi dapat menyebabkan permintaan gagal; ini belum tentu kesalahan konfigurasi. |
| Pricing multiplier | Koefisien penagihan yang umum digunakan di provider AI, menunjukkan kelipatan harga yang dikenakan untuk model tertentu. | Semakin kuat model, semakin besar konteks, dan semakin kompleks tugas gambar atau video, pengalinya bisa semakin tinggi. |
| Input price | Biaya yang timbul dari konten yang Anda kirimkan ke model. | Dokumen panjang, kode panjang, dan riwayat obrolan yang panjang akan meningkatkan biaya input. |
| Output Price | Biaya yang timbul dari konten respons yang dihasilkan oleh model. | Saat meminta model menulis konten yang sangat panjang, biaya output juga akan meningkat. |
| Concurrency | Berapa banyak permintaan yang dapat diajukan secara bersamaan. | Jika konkurensi terlalu rendah, membuka beberapa alat sekaligus atau berbagi dengan beberapa orang akan menyebabkan antrean atau kegagalan. |
| RPM / TPM | Batas permintaan per menit (Requests Per Minute) / token per menit (Tokens Per Minute). | Pesan pembatasan laju (rate limit) biasanya berarti permintaan dikirim terlalu cepat atau konten terlalu panjang. |
| Context length | Berapa banyak konten maksimal yang dapat dimuat dalam satu permintaan? | Jika batas terlampaui, alat dapat memotong konten, langsung memunculkan kesalahan, atau mengompresi/meringkas riwayat percakapan secara otomatis sebelum melanjutkan. |
| Cache | Provider atau model menggunakan kembali konten yang sudah diproses sebelumnya untuk menghemat biaya atau mempercepat respons. | Caching tidak selalu aktif secara otomatis dan tidak selalu sepenuhnya gratis; hal ini bergantung pada aturan provider dan model. |
| Cache price | Istilah umum untuk biaya terkait cache; beberapa sistem backend membaginya menjadi harga yang berbeda seperti pembuatan, hit, pembacaan, dll. | Saat melihat harga cache, pastikan terlebih dahulu apakah ini mengacu pada penulisan cache (write), pembacaan cache (read), atau tampilan gabungan dari backend. |
| Cache creation price / Cache write price | Biaya yang dikenakan saat menulis konten yang dapat digunakan kembali ke dalam cache untuk pertama kalinya. | Saat menggunakan system prompt yang panjang, dokumen panjang, atau konteks tetap untuk pertama kalinya, biaya jenis ini mungkin akan dikenakan. |
| Cache hit price / Cache read price | Biaya yang dikenakan saat permintaan berikutnya menggunakan kembali konten yang sudah di-cache. | Biasanya lebih murah daripada harga input normal, tetapi mungkin tetap dikenakan biaya; jangan menganggap bahwa hit cache pasti gratis. |
| Cache hit | Sebagian konten dalam permintaan ini dikenali oleh provider sama dengan sebelumnya sehingga cache langsung digunakan kembali. | Cache hanya akan di-hit jika memenuhi aturan caching provider, seperti memiliki prefiks yang sama, konten cukup panjang, dan digunakan kembali dalam masa berlaku. |
| Cache expiration time | Rentang waktu di mana cache masih dapat digunakan kembali. | Mengirim permintaan kembali setelah kedaluwarsa dapat dikenakan biaya input reguler, atau memicu kembali biaya pembuatan cache. |
Istilah Kesalahan Umum
| Pesan kesalahan | Arti umum | Pemeriksaan prioritas |
|---|---|---|
| 401 / Unauthorized | Autentikasi gagal. | Periksa apakah Key lengkap, sudah kedaluwarsa, atau terdapat spasi tambahan yang ikut tersalin. |
| 403 / Forbidden | Akun atau key tidak memiliki izin akses. | Izin model, izin grup, pembatasan wilayah, status saldo. |
| 404 / model not found | Model tidak ditemukan atau key saat ini tidak dapat menggunakan model tersebut. | Apakah nama model disalin sesuai backend, dan apakah Key telah dimasukkan ke dalam grup model terkait. |
| 429 / rate limit | Permintaan terlalu sering atau batas kuota telah tercapai. | Konkurensi, RPM, TPM, batasan provider, silakan coba lagi nanti. |
| timeout / timeout | Permintaan tidak memberikan respons tepat waktu. | Base URL, jaringan, status provider, apakah model sedang dalam antrean. |
| invalid api key | Format Key atau izin akses salah. | Salin Key sekali lagi, pastikan tidak tertukar antara nama catatan (remark) dan Key itu sendiri. |
| invalid base url | Alamat antarmuka salah. | Pastikan bahwa itu adalah alamat API, bukan alamat konsol; apakah perlu /v1? Ikuti ketentuan di backend. |
| insufficient quota | Kredit atau saldo tidak mencukupi. | Saldo akun, pengali model, apakah pengisian saldo (top-up) sudah masuk. |
Jika Anda tidak memahami pesan kesalahan, jangan mengubah banyak pengaturan sekaligus. Periksa secara berurutan: Key, Base URL, nama model, saldo, izin model, status provider.