รันการทดสอบ 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โดยขาดคำว่า BearerAuthorization: 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 ไปยังฝ่ายสนับสนุน อย่าส่งคีย์เต็มในข้อความ; ตัวอักษรสี่ตัวแรกและสี่ตัวสุดท้ายก็เพียงพอที่จะระบุคีย์
