ID ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
Dapatkan kunci API

Kesalahan API LLM 401: Memperbaiki Kegagalan Autentikasi

Error LLM API 401 berarti server tidak dapat mengautentikasi permintaan Anda. Dalam hampir semua kasus, penyebabnya ada di sisi klien: header yang salah ketik, kunci yang mengandung karakter asing, atau permintaan yang dikirim ke host yang salah. Panduan ini menelusuri pemeriksaan sesuai urutan yang menemukan masalah dengan cepat.

Diperbarui

Kunci yang tidak cocok dengan kunci mengkilap, menggambarkan kegagalan autentikasi saat memanggil LLM API

Poin utama

  1. 401 adalah kegagalan autentikasi, bukan batas laju atau kesalahan penagihan.
  2. Header harus tepat Authorization: Bearer YOUR_KEY, dengan satu spasi dan tanpa tanda kutip.
  3. Kunci yang dikirim ke URL dasar yang salah gagal sama seperti kunci yang salah.
  4. Uji dengan curl terlebih dahulu; jika curl berhasil, bug ada di konfigurasi aplikasi Anda.

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_KEY dengan kata Bearer hilang.
  • Authorization: Bearer: YOUR_KEY dengan titik dua tambahan.
  • Authorization: Bearer "YOUR_KEY" dengan tanda kutip di dalam nilai.
  • Authorization: Bearer YOUR_KEY dengan dua spasi.
  • Header bernama X-API-Key atau api-key sebagai pengganti Authorization. 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.py berfungsi, tetapi API_KEY=abc di baris sendiri tidak mencapai proses anak. Gunakan export.
  • Tertutupi oleh nilai lain. Perpustakaan dapat membaca OPENAI_API_KEY secara 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:

KodeMakna umumTempat untuk diperiksa
401Kunci hilang atau tidak validHeader, kunci, URL dasar
429Batas laju atau kelebihan beban sementaraLakukan penundaan dan coba lagi; lihat dokumentasi untuk batas
400Body permintaan tidak validJSON, nama model, parameter
404Jalur salahURL 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.

Tanya jawab

Apakah 401 berarti saya kehabisan saldo prabayar?

Tidak. 401 berkaitan dengan autentikasi: kunci tidak ada, tidak valid, atau tidak dikenal. Keadaan kehabisan saldo prabayar adalah kondisi terpisah.

Mengapa kunci yang sama berhasil di curl tetapi tidak di aplikasi saya?

Aplikasi Anda kemungkinan membaca nilai berbeda, seperti variabel lingkungan lama, entri .env yang dikutip, atau kunci dengan spasi di akhir. Cetak panjang dan representasi kunci yang sebenarnya digunakan oleh kode Anda.

Bisakah saya menggunakan kunci OpenAI saya dengan API ini?

Tidak. Setiap kunci hanya berfungsi pada host yang menerbitkannya. Gunakan kunci dari halaman kunci API bersama dengan base URL situs ini.

Apakah 401 dikenakan biaya?

Tidak. Permintaan yang gagal atau ditolak tidak dikenakan biaya.

Kunci Anda hanya selangkah lagi dari satu formulir

Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.

Dapatkan kunci API