TH ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
รับคีย์ API

ข้อผิดพลาด LLM API 401: แก้ไขปัญหาการตรวจสอบสิทธิ์

LLM API error 401 หมายถึงเซิร์ฟเวอร์ไม่สามารถตรวจสอบสิทธิ์คำขอของคุณได้ ในเกือบทุกกรณี สาเหตุมาจากฝั่งไคลเอนต์: header พิมพ์ผิด, คีย์มีอักขระแปลกปลอม หรือส่งคำขอไปยังโฮสต์ผิด คู่มือนี้จะแนะนำขั้นตอนการตรวจสอบตามลำดับที่พบปัญหาเร็วที่สุด

อัปเดต

คีย์ที่ไม่ตรงกับรูปแม่กุญแจเรืองแสง แสดงถึงการตรวจสอบสิทธิ์ล้มเหลวเมื่อเรียก LLM API

ประเด็นสำคัญ

  1. 401 คือข้อผิดพลาดการตรวจสอบสิทธิ์ ไม่ใช่ rate limit หรือข้อผิดพลาดการเรียกเก็บเงิน
  2. header ต้องเป็น Authorization: Bearer YOUR_KEY พอดี โดยมีช่องว่างหนึ่งช่องและไม่มีเครื่องหมายคำพูด
  3. คีย์ที่ส่งไปยัง base URL ที่ผิดจะล้มเหลวเหมือนคีย์ผิด
  4. ทดสอบด้วย curl ก่อน; หาก curl ทำงานได้ บั๊กอยู่ที่การตั้งค่าแอปของคุณ

รันการทดสอบ curl นี้ก่อน

ก่อนเปลี่ยนโค้ด ให้หยุดใช้แอปนี้ คำสั่งนี้ส่งคำขอที่ถูกต้องขั้นต่ำไปยัง API:

curl -i https://api.unrestrictedaiapi.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

GET /v1/models ไม่เสียค่าใช้จ่าย ดังนั้นจึงเป็นวิธีที่ปลอดภัยในการทดสอบคีย์ ตัวระบุ -i จะพิมพ์บรรทัดสถานะและส่วนหัว

  • 200 และรายการโมเดล: คีย์ใช้งานได้ปกติ แอปของคุณกำลังส่งข้อมูลอื่นอยู่ ดังนั้นให้ไปที่ส่วนเกี่ยวกับตัวแปรสภาพแวดล้อมและ Base URL
  • 401: คีย์หรือส่วนหัวไม่ถูกต้อง ดำเนินการต่อด้วยส่วนถัดไป
  • ข้อผิดพลาดการเชื่อมต่อหรือ DNS: Base URL ผิด ซึ่งแตกต่างจากปัญหา 401

วางคีย์ด้วยตนเองในการทดสอบนี้ ไม่ใช่ผ่านตัวแปร วิธีนี้จะตัดตัวแปรสภาพแวดล้อมออกจากกลุ่มผู้ต้องสงสัย

สาเหตุที่ 1: ส่วนหัวไม่ถูกต้อง

API คาดหวัง Authorization: Bearer <key> ความเบี่ยงเบนเล็กน้อยทั้งหมดทำให้เกิดข้อผิดพลาด llm api 401:

  • Authorization: YOUR_KEY โดยขาดคำว่า Bearer
  • Authorization: Bearer: YOUR_KEY พร้อมเครื่องหมายทวิภาคเพิ่ม
  • Authorization: Bearer "YOUR_KEY" มีเครื่องหมายคำพูดภายในค่า
  • Authorization: Bearer YOUR_KEY มีช่องว่างสองช่อง
  • ส่วนหัวชื่อ X-API-Key หรือ api-key แทน Authorization ซึ่งเป็นข้อตกลงของบริการอื่น

หากคุณใช้ OpenAI SDK คุณไม่ต้องเขียนส่วนหัวเอง SDK จะสร้างส่วนหัวจากอาร์กิวเมนต์ api_key หากคุณเห็น 401 อยู่ดี ค่าที่ส่งไปยัง SDK คือปัญหา ไม่ใช่รูปแบบส่วนหัว

สาเหตุที่ 2: คีย์เสียหาย

คีย์เป็นสตริงสุ่มที่มีความยาวมาก ดังนั้นการคัดลอกผิดพลาดจึงเกิดขึ้นบ่อยและยากที่จะสังเกตด้วยตาเปล่า

  • บรรทัดใหม่หรือช่องว่างท้าย. การคัดลอกจากเทอร์มินัลหรือไฟล์ข้อความมักจะทำให้มีเพิ่มเข้ามา หลายไลบรารี HTTP จะส่งส่วนหัวที่ไม่ถูกต้องหรือคีย์ที่ไม่ตรงกัน
  • คีย์ถูกตัด การดับเบิลคลิกจะเลือกเฉพาะส่วนของสตริงหากคีย์มีอักขระที่ทำให้การเลือกคำผิดปกติ ให้ใช้ปุ่มคัดลอกบน หน้าคีย์ API แทน
  • เครื่องหมายคำพูดอัจฉริยะ การวางข้อความผ่านโปรแกรมประมวลคำหรือแอปแชทอาจเปลี่ยนเครื่องหมายคำพูดตรงให้เป็นเครื่องหมายคำพูดโค้ง
  • คีย์เก่าหรือคีย์ที่หมุนแล้ว หากคุณสร้างคีย์ใหม่ คีย์เก่าอาจไม่ใช่คีย์ที่คุณกำลังใช้งานอยู่

เพื่อตรวจสอบอักขระที่มองไม่เห็นใน Python ให้พิมพ์ repr ของค่า:

import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))

หากบรรทัดที่สองพิมพ์ False แสดงว่าคุณมีช่องว่างรอบคีย์ ให้เรียกใช้ .strip() เมื่อคุณอ่านค่า

สาเหตุที่ 3: base URL ผิด

นี่คือความผิดพลาดที่พบบ่อยที่สุดเมื่อเปลี่ยนแอปพลิเคชันที่มีอยู่ไปยังผู้ให้บริการรายใหม่ คีย์ของคุณจะใช้งานได้เฉพาะบนโฮสต์ที่ออกคีย์ให้เท่านั้น base URL ของเว็บไซต์นี้คือ:

{"base_url": "https://api.unrestrictedaiapi.com/v1"}

รูปแบบความล้มเหลวสองรูปแบบปรากฏซ้ำแล้วซ้ำอีก:

  • คุณตั้งค่าคีย์ใหม่แต่ยังใช้ base URL เก่า คำขอจะถูกส่งไปยังผู้ให้บริการรายเก่า ซึ่งจะปฏิเสธคีย์ที่มันไม่เคยเห็นและส่งกลับสถานะ 401 ข้อความข้อผิดพลาดจะกล่าวถึงผู้ให้บริการรายเก่า ซึ่งเป็นเบาะแสที่มีประโยชน์
  • คุณตั้งค่า base URL ใหม่แต่ยังใช้คีย์เก่าในสภาพแวดล้อม คำขอจะมาถึงเรา และเราจะปฏิเสธคีย์ของผู้ให้บริการรายอื่น

ตรวจสอบ path ด้วย Base URL ลงท้ายด้วย /v1 แล้ว SDK จะเพิ่ม /chat/completions ลงไป หากสร้าง URL ด้วยตนเอง path เต็มคือ /v1/chat/completions ไม่ใช่ /v1/v1/chat/completions

สาเหตุที่ 4: ตัวแปรสภาพแวดล้อมและไฟล์ config

หาก curl ทำงานได้แต่แอปพลิเคชันของคุณล้มเหลว แสดงว่ามีบางอย่างป้อนคีย์ที่แตกต่างจากที่คุณคิดให้กับแอปพลิเคชัน

  • ไม่ได้ export ตัวแปร ใน shell คำสั่ง API_KEY=abc python app.py ทำงานได้ แต่ API_KEY=abc ในบรรทัดเดียวจะไม่ส่งไปยังกระบวนการลูก ให้ใช้ export
  • ถูกทับด้วยค่าอื่น ไลบรารีสามารถอ่าน OPENAI_API_KEY ได้โดยอัตโนมัติ หากค่าเก่าถูกตั้งค่าไว้ใน shell profile ของคุณ มันอาจทับค่าที่คุณตั้งใจจะตั้ง
  • เครื่องหมายคำพูดในไฟล์ .env ตัวโหลดบางตัวเก็บเครื่องหมายคำพูดไว้เป็นส่วนหนึ่งของค่า หากคีย์ของคุณถูกห่อหุ้มด้วยเครื่องหมายคำพูด ให้ลบออกหรือทดสอบด้วยการตรวจสอบ repr ด้านบน
  • ไม่ได้รีสตาร์ท เซิร์ฟเวอร์และโน้ตบุ๊กอ่านตัวแปรสภาพแวดล้อมตอนเริ่มต้น ให้รีสตาร์ทหลังจากแก้ไข
  • สภาพแวดล้อมที่แตกต่างใน production คอนเทนเนอร์ CI และแดชบอร์ดโฮสติ้งต่างมีที่เก็บตัวแปรของตัวเอง ให้พิมพ์ความยาวคีย์ ไม่ใช่คีย์เอง ลงในบันทึก

การตรวจสอบ Python ขั้นต่ำที่พิสูจน์การกำหนดค่า

สคริปต์นี้ใช้ SDK ของ OpenAI และรายงานอย่างชัดเจนหากการตรวจสอบสิทธิ์ล้มเหลว:

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"))

หากสิ่งนี้พิมพ์ค่า X-Request-Id ให้รวมค่านี้เมื่อคุณเขียนถึง ฝ่ายสนับสนุน เนื่องจากช่วยให้ทีมค้นหาคำขอของคุณได้ การตรวจสอบเดียวกันในภาษาอื่น ๆ มีอยู่ใน คู่มือเริ่มต้นใช้งานสำหรับห้าภาษา

401 เทียบกับข้อผิดพลาดอื่น ๆ

อย่าเสียเวลากับการตรวจสอบสิทธิ์หากข้อผิดพลาดเป็นอย่างอื่น แผนที่สั้น ๆ:

รหัสความหมายทั่วไปจุดที่ต้องตรวจสอบ
401คีย์หายไปหรือไม่ถูกต้องHeader, คีย์, base URL
429ขีดจำกัดอัตราหรือการโอเวอร์โหลดชั่วคราวถอยหลังและลองใหม่; ดู เอกสาร สำหรับขีดจำกัด
400บอดี้ของคำขอไม่ถูกต้องJSON, ชื่อโมเดล, พารามิเตอร์
404เส้นทางผิดBase URL และเอนด์พอยต์

ตรวจสอบชื่อโมเดลด้วย ใช้ uncensored ให้ถูกต้อง; โมเดล ID ที่ผิดถือเป็นข้อผิดพลาดของคำขอ ไม่ใช่ 401 รายละเอียดสเปค รวมถึงเอนด์พอยต์และเฮดเดอร์ที่ API ยอมรับ มีอยู่ในหน้า สเปก API ที่เข้ากันได้กับ OpenAI

พร็อกซี, บราวเซอร์ และทางออกสุดท้าย

การตั้งค่าสองแบบทำให้เกิด 401 ที่ดูคลุมเครือ

พร็อกซีและเกตเวย์

reverse proxy, API gateway หรือ serverless wrapper ระหว่างแอปของคุณกับ API อาจทำให้ header Authorization หายไปหรือถูกเขียนใหม่ ทดสอบจากเครื่องเดียวกันด้วย curl และเปรียบเทียบ บางเฟรมเวิร์กยังส่ง header นี้ไปยังโฮสต์ same-origin เท่านั้น ทำให้ custom fetch wrapper อาจทำให้ header หายไปโดยไม่รู้ตัวเมื่อเรียก cross-origin

คีย์ในโค้ดส่วนหน้า

การเรียก API โดยตรงจาก JavaScript ในเบราว์เซอร์ทำให้คีย์เปิดเผยต่อทุกคนที่เปิดเครื่องมือพัฒนาเบราว์เซอร์อาจบล็อกคำขอด้วยเหตุผลข้ามโดเมนซึ่งดูเหมือนข้อผิดพลาดการตรวจสอบสิทธิ์ เก็บคีย์ไว้ที่เซิร์ฟเวอร์ และให้ส่วนหน้าเรียกเอนด์พอยต์ของคุณเอง ซึ่งเอนด์พอยต์นั้นจะเรียก API พร้อมแนบคีย์ หากคีย์เคยถูกวางลงในโค้ดสาธารณะหรือภาพหน้าจอ ให้เปลี่ยนคีย์นั้น

ยังติดปัญหา

หากคีย์ที่คัดลอกใหม่ยังส่ง 401 ในการทดสอบ curl ให้สร้างคีย์ใหม่จาก หน้าคีย์ API วางลงในคำสั่งโดยตรง และลองอีกครั้ง หากล้มเหลว ให้ส่งเวลาของคำขอ, endpoint และ X-Request-Id response header ไปยังฝ่ายสนับสนุน อย่าส่งคีย์เต็มในข้อความ; ตัวอักษรสี่ตัวแรกและสี่ตัวสุดท้ายก็เพียงพอที่จะระบุคีย์

ถาม-ตอบ

401 หมายถึงผมหมดเครดิตแล้วหรือไม่?

ไม่ 401 คือเรื่องการตรวจสอบสิทธิ์: คีย์หายไป, ไม่ถูกต้องหรือไม่รู้จัก การหมดเครดิตเป็นเงื่อนไขแยกต่างหาก

ทำไมคีย์เดียวกันถึงใช้ได้ใน curl แต่ไม่ใช้ได้ในแอปของฉัน?

แอปของคุณน่าจะอ่านค่าอื่น เช่น ตัวแปรสภาพแวดล้อมเก่า, entry .env ที่มีเครื่องหมายคำพูด หรือคีย์ที่มีช่องว่างต่อท้าย ให้พิมพ์ความยาวและ repr ของคีย์ที่โค้ดของคุณใช้จริง

ฉันสามารถใช้ OpenAI key ของฉันกับ API นี้ได้หรือไม่?

ไม่ คีย์แต่ละอันใช้งานได้เฉพาะโฮสต์ที่ออกคีย์นั้น ใช้คีย์จากหน้า API key พร้อม Base URL ของเว็บไซต์นี้

คำขอที่ได้ 401 ถูกเรียกเก็บเงินหรือไม่?

ไม่ คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน

คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว

สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด

รับคีย์ API