Cek API key

Kalau tool AI tidak bisa terhubung ke API model, penyebabnya biasanya salah satu dari ini: base URL yang path-nya kurang atau kelebihan, key milik penyedia lain, ID model yang tidak ada, atau browser yang memblokir permintaannya. Pengecek ini mengirim permintaan yang sama seperti tool-mu, dari browser-mu, lalu memberi tahu mana penyebabnya. Bisa dipakai untuk API apa pun yang mengikuti format OpenAI, bukan cuma cheapaimodel.

1. 01Rapikan base URL

   Sebelum ada yang dikirim, alamatnya dirapikan dulu dengan aturan di bawah, supaya salah ketik kecil tidak menutupi masalah yang sebenarnya. Host yang diketahui perlu /v1 (OpenAI dan cheapaimodel) langsung ditambahkan; untuk host lain kami cuma memberi tahu, karena sebagian penyedia tetap jalan tanpa /v1.

   Perbaikan base URL

   • https://api.example.com/v1https:// sudah ditambahkan.
   • http://localhost:11434/v1http:// sudah ditambahkan.
   • https://api.example.com/v1http:// sudah diganti jadi https://. Halaman yang dibuka lewat HTTPS tidak bisa memanggil HTTP biasa; kalau server-mu cuma mendukung HTTP, tes pakai curl.
   • https://api.example.com/v1/chat/completions/chat/completions di bagian akhir sudah dihapus: tool-mu menambahkannya ke setiap permintaan.
   • https://api.example.com//v1/Garis miring berlebih sudah dihapus.
   • https://api.example.com/v1/v1/v1 muncul dua kali; sekarang tinggal satu.
   • https://api.example.com/v1?key=abcQuery string atau fragmen # sudah dihapus.
   • https://api.openai.com/v1/v1 sudah ditambahkan karena API ini memerlukannya.
   • https://apiconsole.cheapaimodel.ai/v1Itu situs web kami, bukan API-nya. Sudah diganti ke alamat API.

2. 02Ambil daftar model

   Mengirim GET <base_url>/models dengan key-mu di header Authorization. Gratis, dan menunjukkan bahwa alamat dan key-nya cocok. Permintaannya dihentikan setelah 15 detik.

3. 03Kirim pesan tes (opsional)

   Hanya saat kamu menekan tombolnya: satu chat completion dengan streaming yang meminta “Reply with OK.” dengan max_tokens 16. Token pertama adalah waktu dari pengiriman sampai potongan stream pertama tiba; totalnya dihitung sampai stream selesai. Kalau model menolak max_tokens, permintaannya dikirim sekali lagi dengan max_completion_tokens. Permintaannya dihentikan setelah 30 detik.

4. 04Baca jawabannya

   Kode error di respons lebih diutamakan daripada status HTTP: model_not_found berarti ID model salah, insufficient_quota berarti kredit habis. Kalau tidak ada kode, statusnya yang menentukan: 401 soal key, 403 soal izin atau saldo, 404 soal path, 429 soal rate limit, dan 5xx dari penyedia. 404 teks biasa biasanya berarti /v1 kurang, dan halaman HTML berarti yang dimasukkan alamat situs web, bukan API.

5. 05Bedakan CORS dari server mati

   Kalau browser tidak menampilkan respons, halaman ini mengirim satu permintaan lagi ke alamat yang sama dalam mode no-cors, tanpa key-mu. Kalau server membalas, berarti server-nya hidup tapi memblokir halaman web (CORS), dan cara mengetesnya adalah dengan perintah curl. Kalau tidak membalas, server itu tidak bisa dijangkau dari jaringanmu.

6. Ke mana key-mu dikirim

   Permintaan dikirim langsung dari halaman ini ke base URL yang kamu masukkan. Key-nya cuma ada di memori halaman ini: tidak dikirim ke cheapaimodel, tidak disimpan di browser, dan tidak dimasukkan ke bilah alamat, lalu hilang saat kamu menutup tab. Perintah curl menyamarkannya, kecuali kamu memilih untuk menampilkannya.

• Key ditolak (401)

  Server tidak menerima API key ini. Mungkin salah ketik, sudah dicabut atau kedaluwarsa, atau milik penyedia lain, bukan penyedia base URL ini. Salin ulang key-nya tanpa spasi dan pastikan key itu untuk penyedia ini.

• Akses ditolak (403)

  Key-nya valid, tapi tidak diizinkan untuk panggilan ini: model, alamat IP, atau akunnya mungkin dibatasi, atau saldonya kurang.

• Bukan path API (404)

  Server membalas dengan 404 teks biasa, bukan error API. Paling sering base URL-nya kurang /v1.

• Model tidak ditemukan

  Tidak ada model dengan ID ini yang bisa dipakai key ini. ID model harus sama persis: salin dari daftar di atas atau dari halaman model penyedia.

• Kena rate limit (429)

  Terlalu banyak permintaan, atau key ini sudah mencapai batas penyedia. Tunggu sebentar lalu coba lagi; kalau terus terjadi, cek rate limit penyedia.

• Diblokir browser (CORS)

  Server-nya bisa dijangkau, tapi tidak mengizinkan halaman web membaca responsnya. Ini tidak ada hubungannya dengan key-mu: jalankan perintah curl di bawah di terminal untuk melihat jawaban sebenarnya.

• Waktu habis

  Tidak ada jawaban dalam 15 detik. Server-nya mungkin sedang kelebihan beban, atau alamatnya mengarah ke sesuatu yang tidak pernah membalas.