Jalankan pengujian curl ini terlebih dahulu
Sebelum mengubah kode, keluarkan aplikasi Anda dari persamaan. Perintah ini mengirimkan permintaan valid minimum ke API:
curl -i https://api.unrestrictedaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
GET /v1/models tidak memakan biaya, sehingga ini adalah cara yang aman untuk menguji kunci. Bendera -i mencetak baris status dan header.
- 200 dan daftar model: kunci Anda baik-baik saja. Aplikasi Anda mengirimkan sesuatu yang berbeda, jadi lanjutkan ke bagian tentang variabel lingkungan dan URL dasar.
- 401: kunci atau header salah. Lanjutkan dengan bagian berikutnya.
- Kesalahan koneksi atau DNS: URL dasar salah, yang merupakan masalah berbeda dari 401.
Tempelkan kunci secara manual ke dalam pengujian ini, bukan melalui variabel. Itu menghilangkan lingkungan dari daftar tersangka.
Penyebab 1: header tidak sepenuhnya benar
API mengharapkan Authorization: Bearer <key>. Penyimpangan kecil semuanya menghasilkan kesalahan API LLM 401:
Authorization: YOUR_KEYdengan kata Bearer hilang.Authorization: Bearer: YOUR_KEYdengan titik dua tambahan.Authorization: Bearer "YOUR_KEY"dengan tanda kutip di dalam nilai.Authorization: Bearer YOUR_KEYdengan dua spasi.- Header bernama
X-API-Keyatauapi-keysebagai penggantiAuthorization. Itu adalah konvensi layanan lain.
Jika Anda menggunakan SDK OpenAI, Anda tidak menulis header sendiri. SDK membuatnya dari argumen api_key. Jika Anda tetap melihat 401, nilai yang diteruskan ke SDK adalah masalahnya, bukan format header.
Penyebab 2: kunci itu sendiri rusak
Kunci adalah string acak panjang, sehingga kesalahan penyalinan sering terjadi dan sulit dilihat dengan mata.
- Baris baru atau spasi di akhir. Menyalin dari terminal atau file teks sering menambahkannya. Banyak pustaka HTTP kemudian mengirim header tidak valid atau kunci yang tidak cocok.
- Kunci terpotong. Mengklik dua kali hanya memilih sebagian string jika kunci berisi karakter yang mengganggu pemilihan kata. Gunakan tombol salin di halaman kunci API sebagai gantinya.
- Tanda kutip pintar. Menempelkan melalui pemroses kata atau aplikasi obrolan dapat menukar tanda kutip lurus dengan tanda kutip melengkung.
- Kunci lama atau yang telah diputar. Jika Anda membuat kunci baru, kunci lama mungkin tidak lagi menjadi kunci yang Anda gunakan.
Untuk memeriksa karakter tak terlihat di Python, cetak repr dari nilai tersebut:
import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))
Jika baris kedua mencetak False, Anda memiliki spasi di sekitar kunci. Panggil .strip() saat Anda membacanya.
Penyebab 3: URL dasar yang salah
Ini adalah kesalahan paling umum saat mengalihkan aplikasi yang ada ke penyedia baru. Kunci Anda hanya valid pada host yang menerbitkannya. URL dasar untuk situs ini adalah:
{"base_url": "https://api.unrestrictedaiapi.com/v1"}
Dua pola kegagalan muncul berulang kali:
- Anda mengatur kunci baru tetapi meninggalkan URL dasar lama. Permintaan dikirim ke penyedia lama, yang menolak kunci yang belum pernah dilihatnya dan mengembalikan 401. Teks kesalahan kemudian menyebutkan penyedia lama, yang merupakan petunjuk yang berguna.
- Anda mengatur URL dasar baru tetapi meninggalkan kunci lama di lingkungan. Permintaan mencapai kami, dan kami menolak kunci penyedia lain.
Periksa juga jalurnya. URL dasar sudah berakhir dengan /v1, sehingga SDK menambahkan /chat/completions ke dalamnya. Jika Anda membangun URL secara manual, jalur lengkapnya adalah /v1/chat/completions, bukan /v1/v1/chat/completions.
Penyebab 4: variabel lingkungan dan file konfigurasi
Jika curl berhasil tetapi aplikasi Anda gagal, sesuatu memberi aplikasi kunci yang berbeda dari yang Anda kira.
- Variabel tidak diekspor. Di shell,
API_KEY=abc python app.pyberfungsi, tetapiAPI_KEY=abcdi baris sendiri tidak mencapai proses anak. Gunakanexport. - Tertutupi oleh nilai lain. Perpustakaan dapat membaca
OPENAI_API_KEYsecara otomatis. Jika nilai lama diatur di profil shell Anda, nilai tersebut mungkin menimpa apa yang Anda maksudkan. - Tanda kutip di file .env. Beberapa pemuat mempertahankan tanda kutip sebagai bagian dari nilai. Jika kunci Anda tiba dibungkus karakter tanda kutip, hapus atau uji dengan pemeriksaan repr di atas.
- Tidak di-restart. Server dan notebook membaca variabel lingkungan saat start-up. Restart setelah mengedit.
- Lingkungan berbeda di produksi. Kontainer, CI, dan dasbor hosting masing-masing memiliki toko variabel mereka sendiri. Cetak panjang kunci, bukan kunci itu sendiri, di log.
Pemeriksaan Python minimal yang membuktikan konfigurasi
Skrip ini menggunakan SDK OpenAI dan melaporkan dengan jelas jika autentikasi gagal:
import os
from openai import OpenAI, AuthenticationError
client = OpenAI(
base_url="https://api.unrestrictedaiapi.com/v1",
api_key=os.environ["API_KEY"].strip(),
)
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ok."}],
max_tokens=5,
)
print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
print("401:", e.status_code, e.response.headers.get("X-Request-Id"))
Jika ini mencetak X-Request-Id, sertakan saat Anda menghubungi support, karena hal itu membantu tim menemukan permintaan Anda. Cek yang sama dalam bahasa lain ada di quickstart untuk lima bahasa.
401 versus kesalahan lain
Jangan habiskan waktu untuk autentikasi jika kesalahan adalah sesuatu yang lain. Peta singkat:
| Kode | Makna umum | Tempat untuk diperiksa |
|---|---|---|
| 401 | Kunci hilang atau tidak valid | Header, kunci, URL dasar |
| 429 | Batas laju atau kelebihan beban sementara | Lakukan penundaan dan coba lagi; lihat dokumentasi untuk batas |
| 400 | Body permintaan tidak valid | JSON, nama model, parameter |
| 404 | Jalur salah | URL dasar dan endpoint |
Periksa juga nama model. Gunakan uncensored secara tepat; ID model yang salah adalah kesalahan permintaan, bukan 401. Detail spesifikasi, termasuk endpoint dan header yang diterima API, terdapat di halaman spesifikasi API kompatibel OpenAI.
Proxy, peramban, dan langkah terakhir
Dua konfigurasi menyebabkan kesalahan 401 yang tampak membingungkan.
Proxy dan gerbang API
Proxy terbalik, gerbang API, atau pembungkus serverless di antara aplikasi Anda dan API dapat menghapus atau menulis ulang header Authorization. Uji dari mesin yang sama menggunakan curl dan bandingkan. Beberapa kerangka kerja juga meneruskan header hanya ke host asal yang sama, sehingga pembungkus fetch kustom dapat kehilangan header tersebut secara diam-diam pada panggilan lintas asal.
Kunci dalam kode front-end
Memanggil API langsung dari JavaScript peramban mengekspos kunci kepada siapa saja yang membuka alat pengembang, dan peramban juga dapat memblokir permintaan karena alasan lintas asal yang tampak seperti kesalahan autentikasi. Simpan kunci di server, dan biarkan front end Anda memanggil endpoint Anda sendiri, yang pada gilirannya memanggil API dengan kunci yang dilampirkan. Jika kunci pernah disalin ke kode publik atau tangkapan layar, ganti kunci tersebut.
Masih buntu
Jika kunci yang baru saja disalin masih mengembalikan 401 dalam tes curl, buat kunci lagi dari halaman kunci API, tempelkan langsung ke dalam perintah, dan coba lagi. Jika gagal, kirimkan kepada dukungan waktu permintaan, endpoint, dan header respons X-Request-Id. Jangan pernah mengirim kunci lengkap dalam pesan; karakter pertama dan empat karakter terakhir sudah cukup untuk mengidentifikasinya.
