kimiapikey.comคู่มือ
คีย์ API Kimi ใช้ไม่ได้: สาเหตุ วิธีแก้ และทางสำรอง
หากข้อผิดพลาดคีย์ API Kimi ใช้ไม่ได้แสดงเป็น 401, 404 หรือ 429 สาเหตุมักเกิดจากหนึ่งในห้าสิ่งนี้: base URL ผิด คีย์ไม่ตรงกัน ไม่มียอดเงิน ขีดจำกัดอัตรา หรือชื่อโมเดลที่เอนด์พอยต์ไม่รู้จัก ให้ตรวจสอบตามลำดับนี้
อัปเดต


ประเด็นสำคัญ
- คีย์ใช้งานได้เฉพาะกับผู้ให้บริการที่ออกคีย์เท่านั้น ดังนั้น Base URL และคีย์ต้องมาจากแดชบอร์ดเดียวกัน
- 401 หมายถึงคีย์ถูกปฏิเสธ 404 มักหมายถึงเส้นทางที่ผิด 429 หมายถึงคุณชนขีดจำกัดหรือบริการกำลังยุ่ง
- พิมพ์รหัสสถานะและบอดี้การตอบกลับก่อนที่จะเปลี่ยนแปลงสิ่งอื่นใด
- รักษาการกำหนดค่าเอนด์พอยต์ที่เข้ากันได้กับ OpenAI ไว้สองแห่ง เพื่อให้การหยุดทำงานครั้งเดียวไม่หยุดแอปของคุณ
อ่านรหัสสถานะก่อน
ก่อนจะสร้างข้อมูลใหม่ใดๆ ให้ดูสิ่งที่เซิร์ฟเวอร์ส่งกลับมาจริงๆ ไคลเอนต์สไตล์ OpenAI ส่วนใหญ่ซ่อนบอดี้ไว้ภายใต้ข้อยกเว้นทั่วไป ให้พิมพ์ทั้งรหัสสถานะและข้อความ
curl -i https://api.kimiapikey.com/v1/models \
-H "Authorization: Bearer $YOUR_KEY"
บรรทัดแรกของการตอบกลับบอกตำแหน่งที่คุณต้องตรวจสอบ:
| รหัส | ความหมายทั่วไป | เริ่มต้นด้วย |
|---|---|---|
| 401 | คีย์ถูกปฏิเสธ | การคัดลอกคีย์ คีย์และ Base URL จากผู้ให้บริการที่ต่างกัน |
| 404 | ไม่พบ Path หรือโมเดล | ขาด /v1, path ซ้ำ, ID โมเดลผิด |
| 400 | Body ของคำขอไม่ถูกต้อง | ชื่อพารามิเตอร์, รูปแบบข้อความ, ขนาด body |
| 429 | ถึงขีดจำกัดหรือบริการกำลังยุ่ง | อัตราคำขอ, การเรียกแบบขนาน, การกำหนดเวลา retry |
| 5xx | ปัญหาฝั่งเซิร์ฟเวอร์ | ลองใหม่พร้อม backoff แล้วเปลี่ยนไปใช้ทางสำรอง |
หากคุณไม่ได้รับ HTTP response เลย (timeout หรือข้อผิดพลาด DNS) ปัญหาคือเครือข่ายหรือ hostname ที่คุณพิมพ์ ไม่ใช่คีย์
Base URL และคีย์ต้องเข้าคู่กัน
นี่คือสาเหตุที่พบบ่อยที่สุดที่ทำให้คีย์ใหม่ใช้งานไม่ได้ คีย์ออกให้เฉพาะผู้ให้บริการรายนั้นๆ คีย์จากแดชบอร์ดหนึ่งจึงไม่เป็นที่รู้จักในเซิร์ฟเวอร์ของผู้ให้บริการรายอื่น จึงส่ง 401 กลับมาแม้ว่าคีย์นั้นจะถูกต้องตามแหล่งที่มา
ตรวจสอบจุดเหล่านี้:
- คีย์และ Base URL มาจากหน้าบัญชีเดียวกัน หากคุณคัดลอกคีย์จากผู้ให้บริการรายหนึ่งแต่ยังทิ้ง Base URL เก่าไว้ใน config ของคุณ คำขอจะส่งไปยังที่ผิด
- ตัวแปรสภาพแวดล้อมไม่ได้บดบังโค้ดของคุณ SDK ของ OpenAI จะอ่าน
OPENAI_API_KEYและOPENAI_BASE_URLเมื่อคุณไม่ได้ส่งค่าเหล่านี้โดยชัดแจ้ง ดังนั้นตัวแปร shell ที่ล้าสมัยอาจทับซ้อนสิ่งที่คุณเขียนในไฟล์ - คีย์ไม่มีช่องว่างหรือ newline ท้ายสุด การมี newline ต่อท้ายจากการ copy และ paste เป็นสาเหตุคลาสสิกของ 401
- header ต้องเป็น
Authorization: Bearer <key>เครื่องมือบางตัวคาดหวังคีย์ใน header ที่ต่างออกไปและต้องการเปิดโหมดที่เข้ากันได้กับ OpenAI
Editor และ chat frontend เพิ่มกับดักอีกอย่างหนึ่ง หลายตัวมีช่องแยกสำหรับ "OpenAI base URL" และ toggle แยกเพื่อเปิดใช้งาน หาก toggle ปิด แอปจะเรียก host เริ่มต้นด้วยคีย์ใหม่ของคุณอย่างเงียบๆ และคุณจะได้ 401 ที่ดูเหมือนคีย์เสีย บันทึกการตั้งค่าและรีสตาร์ทแอปหากมีการ cache แล้วส่งข้อความทดสอบสั้นๆ ก่อนทดสอบอะไรที่ซับซ้อน
URL ฐานควรลงท้ายที่ /v1 ไม่ใช่ที่โฮสต์และไม่ใช่ที่ /v1/chat/completions SDK จะเติมส่วนที่เหลือให้ URL ที่มีเส้นทางเต็มอยู่แล้วจะกลายเป็นเส้นทางซ้ำและเกิดข้อผิดพลาด 404
การเข้าถึงตามภูมิภาค, proxy และเครือข่ายองค์กร
บางครั้งคีย์ถูกต้องแต่คำขอไม่ไปถึงเซิร์ฟเวอร์ที่ถูกต้อง ความพร้อมของผู้ให้บริการอาจขึ้นอยู่กับตำแหน่งที่คุณเชื่อมต่อจากนั้น และ VPN, corporate proxy หรือกฎ firewall อาจบล็อกหรือเขียนทับ traffic ดูเอกสารหรือหน้าสถานะของผู้ให้บริการเองสำหรับภูมิภาคที่รองรับ และอย่าสันนิษฐานว่ากฎเดียวกันใช้กับบริการอื่น
การทดสอบการแยกปัญหาอย่างรวดเร็ว: รันคำสั่ง curl เดียวกันจากเครือข่ายอื่น เช่น ฮอตสปอตโทรศัพท์ หากใช้งานได้ แสดงว่าคีย์ถูกต้องและเครือข่ายของคุณเป็นสาเหตุ หากพร็อกซีตั้งค่า HTTPS_PROXY ให้ตรวจสอบว่าไลบรารี HTTP ของคุณเคารพการตั้งค่านี้หรือไม่ เครื่องมือบางตัวอาจเพิกเฉยและเกิดข้อผิดพลาดการเชื่อมต่อ
ยอดเงิน โควตา และลักษณะของขีดจำกัดอัตรา
คีย์อาจใช้งานได้แต่ยังปฏิเสธคำขอเนื่องจากบัญชีไม่มีเครดิตเหลือหรือใช้โควตาจนหมด ตรวจสอบแดชบอร์ดก่อนดีบักโค้ด หากคุณไม่เคยเติมเงิน โปรดจำไว้ว่าโควตาฟรีมักมีจำนวนน้อยและหมดอายุเร็ว
สถานะ 429 เป็นเรื่องต่างออกไป มันหมายถึงเซิร์ฟเวอร์กำลังลดความเร็วให้คุณ ไม่ใช่คีย์มีปัญหา บนเอนด์พอยต์ที่อธิบายไว้ในเว็บไซต์นี้ คีย์แบบเต็มอนุญาตให้ทำคำขอพร้อมกัน (concurrency) ได้ 8 คำขอ และ 300 คำขอต่อนาที ส่วนคีย์ทดลองอนุญาตให้ทำคำขอพร้อมกัน 2 คำขอ และ 60 คำขอต่อนาที เมื่อคุณเกินขีดจำกัดเหล่านี้ API จะส่ง HTTP 429 พร้อมรหัสข้อผิดพลาด rate_limited (เกินจำนวนต่อนาที) หรือ concurrency (เกินจำนวนพร้อมกัน) การโอเวอร์โหลดชั่วคราวก็ส่ง 429 เช่นกัน พร้อมหัวข้อความ Retry-After: 5
สองนิสัยนี้ช่วยแก้ไขปัญหาส่วนใหญ่ได้ เคารพค่า Retry-After เมื่อมีอยู่ และจำกัดจำนวน worker พร้อมกันให้ไม่เกินขีดจำกัดการทำงานพร้อมกัน คำขอแบบสตรีมมิงจะคงสถานะการใช้งานไว้จนกว่าสตรีมจะจบ ดังนั้นสตรีมที่ค้างอยู่จึงนับเป็นภาระต่อคุณนานกว่าที่คุณคาดคิด
ชื่อโมเดล พารามิเตอร์ และขนาดบอดี
สถานะ 404 หรือ 400 พร้อมคีย์ที่ถูกต้อง มักชี้ไปที่คำขอของคุณเอง สิ่งที่ต้องตรวจสอบสามอย่าง:
- รหัสโมเดล ผู้ให้บริการแต่ละรายมีชื่อโมเดลเป็นของตัวเอง ถามเอนด์พอยต์ว่าให้บริการโมเดลใดด้วย
GET /v1/modelsแล้วคัดลอก ID จากคำตอบ บนเว็บไซต์นี้ ID คือuncensored - Parameters. ชื่อเช่น
max_tokens,temperatureและresponse_formatเป็นมาตรฐาน แต่ผู้ให้บริการอาจยอมรับเฉพาะบางฟิลด์เท่านั้น ให้ลบฟิลด์ที่ไม่บังคับออกจนกว่าคำขอจะผ่าน แล้วเพิ่มกลับทีละฟิลด์ - ขนาด พรอมต์ขนาดใหญ่เกินไปอาจล้มเหลวเนื่องจากข้อจำกัดของขนาดบอดีก่อนที่โมเดลจะประมวลผล ที่นี่ขนาดบอดีสูงสุดคือ 8 MB และหน้าต่างบริบทคือ 100,000 โทเคนสำหรับพรอมต์และการสร้างคำตอบรวมกัน
การสตรีมมิงเป็นอีกจุดที่คีย์ที่ใช้งานได้ดูเหมือนจะเสีย หากคำขอสำเร็จเมื่อไม่มี stream: true แต่ล้มเหลวเมื่อมี สาเหตุมักเป็นพร็อกซีที่บัฟเฟอร์หรือตัดเหตุการณ์ที่ส่งจากเซิร์ฟเวอร์ (SSE) ไม่ใช่เอนด์พอยต์ ให้ปิดการสตรีมมิงเพื่อยืนยัน แล้วตรวจสอบการตั้งค่าพร็อกซี
หากคุณเปลี่ยนเฉพาะชื่อโมเดลแล้วการเรียกใช้ล้มเหลว ให้กลับชื่อเดิมเพื่อยืนยันว่าการตั้งค่าอื่นๆ ของคุณถูกต้อง
เตรียมเอนด์พอยต์สำรองไว้
แม้ผู้ให้บริการที่ทำงานปกติก็อาจมีช่วงเวลาที่ย่ำแย่ หากผลิตภัณฑ์ของคุณพึ่งพาคีย์เดียว ความล้มเหลวเพียงครั้งเดียวก็อาจทำให้ระบบหยุดทำงานได้ เนื่องจากรูปแบบคำขอ OpenAI เป็นมาตรฐานร่วมกัน คุณสามารถกำหนดค่าเอนด์พอยต์ที่สองไว้และสลับใช้งานได้ด้วยโค้ดเพียงไม่กี่บรรทัด
เอนด์พอยต์ที่เว็บไซต์นี้เป็นแบบ OpenAI-compatible จึงสามารถใช้งานในฐานะผู้ให้บริการที่สองได้ เป็นโมเดลแบบเปิดน้ำหนักที่โฮสต์แยกต่างหาก ไม่ใช่บริการทางการของ Moonshot และจะตอบกลับแตกต่างจากโมเดล Kimi ดังนั้นควรทดสอบพรอมต์ของคุณก่อนพึ่งพาที่นี่ นี่คือโค้ด wrapper เล็กน้อยที่ลองเรียกใช้ primary ก่อนแล้วจึงใช้ fallback เมื่อเกิดข้อผิดพลาด:
import os
from openai import OpenAI
primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
api_key=os.environ["FALLBACK_KEY"])
def ask(messages):
try:
r = primary.chat.completions.create(
model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
except Exception as e:
print("primary failed:", e)
r = fallback.chat.completions.create(
model="uncensored", messages=messages, timeout=60)
return r.choices[0].message.content
print(ask([{"role": "user", "content": "Say hi in five words."}]))
ราคาแบบจ่ายตามการใช้งาน: $0.15 ต่อ 1M input tokens และ $0.50 ต่อ 1M output tokens จาก prepaid credit ที่ไม่มีวันหมดอายุ คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน ดังนั้น fallback ที่แทบไม่ได้ทำงานจึงมีค่าใช้จ่ายในการคงไว้เกือบเป็นศูนย์ การเติมเงินเริ่มต้นที่ $20; ดู ราคา สำหรับระดับโบนัส
ทดสอบจุดสำรองในสองนาที
ผู้ใช้ใหม่สามารถรับเครดิตทดลองใช้ $0.50 ได้คลิกเดียวที่หน้าคีย์ API หลังการเข้าสู่ระบบ ไม่ต้องใช้บัตร และใช้ได้ 7 วัน ซึ่งเพียงพอสำหรับรันพรอมต์จริงของคุณผ่านเอนด์พอยต์หนึ่งครั้ง จากนั้นให้รัน smoke test ด้านล่าง
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $FALLBACK_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
ตรวจสอบ response header X-Balance-USD เพื่อดูเครดิตที่เหลือ เอกสารอ้างอิงคำขอเต็มรูปแบบอยู่ใน เอกสาร หากคุณกำลังเชื่อมต่อกับ editor การแนะนำที่มีอยู่เกี่ยวกับ การใช้คีย์ API แบบ Kimi ใน Cursor แสดงตำแหน่งของช่อง base URL และ ภาพรวมคีย์ API ของ Kimi อธิบายความสัมพันธ์ของ endpoint นี้กับโมเดลที่คุณเคยใช้
คู่มือเพิ่มเติม
- URL ฐานของ API Moonshot: เปลี่ยนจุดเชื่อมต่อโค้ดของคุณ
- วิธีใช้คีย์ API แบบ Kimi ใน Cursor: คู่มือการติดตั้ง
คำถามที่พบบ่อย
โมเดลเหมือนกันกับ Kimi ทางการของ Moonshot หรือไม่?
ไม่ เราโฮสต์โมเดลแบบเปิดน้ำหนักที่ปรับแต่งให้ไม่เซ็นเซอร์ มันไม่ใช่ GPT, Claude, Gemini, Grok, DeepSeek หรือโมเดลของผู้ให้บริการรายอื่น มันเป็นโมเดลที่แตกต่างกันที่รันบนเซิร์ฟเวอร์ของเราเอง
คุณฝึกข้อมูลของฉันหรือไม่?
ไม่ พรอมต์และการสร้างข้อความของคุณไม่ถูกใช้ในการฝึก เราให้ความสำคัญกับความเป็นส่วนตัวและความโปร่งใส ดังนั้นข้อมูลของคุณยังคงเป็นของคุณ
ขีดจำกัดอัตราคืออะไร?
คุณจำกัดอยู่ที่ 300 คำขอต่อนาทีต่อคีย์ ขนาดบอดีในคำขอสูงสุดคือ 8 MB ขีดจำกัดเหล่านี้ถูกออกแบบมาเพื่อให้แน่ใจว่าประสิทธิภาพที่เสถียรสำหรับผู้ใช้ทุกคน
นโยบายเนื้อหาคืออะไร?
โมเดลไม่เซ็นเซอร์เรื่องผู้ใหญ่ วิวาทะ และสร้างสรรค์ แต่เราบล็อกเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ นี่คือขีดจำกัดที่แข็งซึ่งใช้เสมอไม่ว่าระดับสมาชิกของคุณจะเป็นอย่างไร
ถาม-ตอบ
ทำไมคีย์ใหม่ของฉันจึงส่ง 401 ทันที?
สาเหตุที่พบบ่อยที่สุดคือการใช้คีย์กับ base URL ของผู้ให้บริการอื่น มีช่องว่างหรือบรรทัดใหม่ในคีย์ที่คัดลอกมา หรือตัวแปรสภาพแวดล้อมแทนที่ค่าในโค้ดของคุณ ให้ทดสอบด้วย curl เพื่อยกเลิกความเป็นไปได้ว่าเกิดจาก SDK ของคุณ
สถานะ 429 เหมือนกับคีย์มีปัญหาหรือไม่?
ไม่ สถานะ 429 หมายถึงคุณชนขีดจำกัดอัตรา ขีดจำกัดการทำงานพร้อมกัน หรือโอเวอร์โหลดชั่วคราว คีย์ใช้งานได้ รอค่า Retry-After แล้วลดจำนวนคำขอพร้อมกัน
คำขอที่ล้มเหลวเสียเงินที่นี่หรือไม่?
คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงินในเอนด์พอยต์นี้ ดังนั้นการเรียกซ้ำของคำขอที่ขัดข้องจะไม่ทำให้เครดิตของคุณหมดลง
สามารถใช้เอนด์พอยต์นี้เป็นตัวแทนโมเดล Kimi ได้หรือไม่
รองรับรูปแบบคำขอ OpenAI เช่นกัน ดังนั้นการเปลี่ยนแปลงโค้ดจึงเป็นการเปลี่ยน base URL, คีย์ และโมเดล ID uncensored โมเดลพื้นฐานนั้นแตกต่างกัน ดังนั้นคำตอบจะไม่เหมือนกัน; ควรทดสอบพรอมต์ของคุณก่อน
คีย์ของคุณอยู่ห่างแค่ขั้นตอนเดียว
สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด