kimiapikey.comDocs
Kimi API: คำขอแรกในห้านาที
รับคำตอบแรกของคุณภายในห้านาทีโดยใช้อินเทอร์เฟซที่เข้ากันได้กับ OpenAI คู่มือนี้ครอบคลุมการตั้งค่า การตรวจสอบสิทธิ์ และการใช้งานพื้นฐานสำหรับโมเดลที่ไม่เซ็นเซอร์
ข้อกำหนดเบื้องต้น
เพื่อเริ่มต้น คุณจำเป็นต้องมีคีย์ API จาก kimiapikey.com ลงทะเบียนด้วยเพียงอีเมลและรหัสผ่าน ไม่จำเป็นต้องใช้บัตรเครดิตสำหรับการทดลอง คุณยังต้องการสภาพแวดล้อมภาษาที่รองรับพร้อมติดตั้ง SDK ที่เป็นทางการหรือเข้ากันได้ API ของเราปฏิบัติตามรูปแบบ chat-completions ของ OpenAI ดังนั้นโค้ดที่มีอยู่สำหรับ GPT-3.5/4 จึงมักใช้งานได้ด้วยการเปลี่ยนแปลงเพียงเล็กน้อย ตรวจสอบให้แน่ใจว่าเวอร์ชัน SDK ของคุณใหม่พอที่จะรองรับพารามิเตอร์ base_url
URL พื้นฐานและการตรวจสอบสิทธิ์
API ของเราอยู่ที่ https://api.kimiapikey.com/v1 การตรวจสอบสิทธิ์จัดการผ่านหัวเรื่อง Authorization มาตรฐาน ส่งคีย์ของคุณเป็นโทเคน Bearer สิ่งนี้ใช้งานได้กับไคลเอนต์ใดๆ ที่ยอมรับเอนด์พอยต์ที่เข้ากันได้กับ OpenAI หากคุณใช้พร็อกซีหรือไคลเอนต์ที่กำหนดเอง ตรวจสอบให้แน่ใจว่าส่งต่อหัวเรื่อง Authorization อย่างถูกต้อง รหัสโมเดลที่คุณจะขอคือ uncensored
คำขอแรก
ส่ง chat completion แบบง่ายเพื่อตรวจสอบการตั้งค่า ใช้คำสั่ง curl ด้านล่าง โดยแทนที่ YOUR_API_KEY ด้วยคีย์จริงของคุณ คำขอนี้ส่งพรอมต์สั้นๆ ไปยังโมเดล uncensored หากสำเร็จ คุณจะได้รับการตอบกลับเป็น JSON ที่มีข้อความตอบกลับ ตรวจสอบอาร์เรย์ choices เพื่อรับข้อความที่สร้าง หากได้รับข้อผิดพลาด 401 คีย์ของคุณไม่ถูกต้องหรือหมดอายุ
Python SDK
ใช้ไลบรารี Python ของ OpenAI ทางการเพื่อการผสานรวมที่ง่ายที่สุด ตั้งค่า base_url เป็นเอนด์พอยต์ของเราและระบุคีย์ของคุณ ตัวอย่างนี้แสดงการเรียกสร้างข้อความพื้นฐาน คุณสามารถปรับพารามิเตอร์ model ได้หากจำเป็น แม้ว่าจะใช้ uncensored เป็นค่าเริ่มต้นโดยปกติ วิธีนี้ทำให้โค้ดของคุณใช้งานข้ามแพลตฟอร์มได้กับบริการที่เข้ากันได้กับ OpenAI
Node SDK
สำหรับโปรเจกต์ JavaScript/TypeScript ให้ใช้แพ็คเกจ npm openai กำหนดค่าไคลเอนต์ด้วย URL พื้นฐานและคีย์ API ของคุณ สิ่งนี้ช่วยให้คุณส่งคำขอได้โดยตรงจากสภาพแวดล้อม Node ของคุณ ไวยากรณ์จะสะท้อน SDK ของ Python เพื่อให้แน่ใจถึงความสอดคล้องหากคุณเปลี่ยนภาษา อย่าลืมจัดการการตอบกลับแบบอะซิงโครนัสอย่างถูกต้องโดยใช้ await
การตอบกลับแบบสตรีมมิง
สำหรับการแสดงผลแบบเรียลไทม์ ให้เปิดใช้งาน streaming ใน SDK ของคุณ สิ่งนี้จะส่งชิ้นส่วนของข้อความขณะกำลังสร้าง ลดความล่าช้าในการรับรู้ ใช้แฟลก stream ในคำขอของคุณ SDK จะส่งการตอบกลับบางส่วน ทำให้คุณสามารถอัปเดต UI ได้แบบเพิ่มทีละส่วน เหมาะสำหรับอินเทอร์เฟซแชทหรือการสร้างเนื้อหาแบบยาวซึ่งการตอบกลับทันทีมีคุณค่า
ขีดจำกัดและข้อผิดพลาด
คีย์แต่ละอันจำกัดอยู่ที่ 300 คำขอต่อนาที หากคุณเกินขีดจำกัดนี้ คุณจะได้รับข้อผิดพลาด 429 ร่างคำขอของคุณต้องไม่เกิน 8 MB หน้าต่างบริบท 100,000 โทเคนใช้กับผลรวมของพรอมต์และการตอบกลับ ข้อผิดพลาดทั่วไปรวมถึง 401 (คีย์ไม่ถูกต้อง) และ 402 (เครดิตไม่เพียงพอ) เติมเงินผ่านแดชบอร์ดเพื่อดำเนินการใช้ API ต่อ เครดิตแบบเติมเงินล่วงหน้าไม่หมดอายุ และไม่มีค่าธรรมเนียมรายเดือน
cURL
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapikey.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapikey.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);สตรีมมิง
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)ถาม-ตอบ
API รองรับ function calling หรือไม่?
ใช่ เอนด์พอยต์รองรับการเรียกใช้เครื่องมือ/ฟังก์ชันในรูปแบบมาตรฐานของ OpenAI คุณสามารถกำหนดเครื่องมือในคำขอและโมเดลจะส่งคืนอาร์กิวเมนต์ที่มีโครงสร้าง
เกิดอะไรขึ้นหากฉันเกินขีดจำกัดอัตรา?
คุณจะได้รับข้อผิดพลาด 429 คำขอมากเกินไป รอสักครู่แล้วลองใหม่ หรืออัปเกรดระดับเครดิตแบบเติมเงินล่วงหน้าของคุณเพื่อรักษาปริมาณการส่งข้อมูลที่สูงขึ้น
โมเดลได้รับการฝึกฝนด้วยข้อมูลของฉันหรือไม่
ไม่ พรอมต์ที่ส่งไปยัง API ไม่ถูกใช้ในการฝึกฝน ข้อมูลของคุณยังคงเป็นส่วนตัวและไม่ถูกใช้เพื่อปรับปรุงโมเดลพื้นฐาน
คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว
สร้างบัญชี คัดลอกคีย์ เปลี่ยน URL พื้นฐาน นั่นคือการตั้งค่าทั้งหมด
ข้อมูลจำเพาะทางเทคนิค
ขีดจำกัดและความสามารถจริงทั้งหมดของ API ในที่เดียว ตรวจสอบก่อนเติมเงิน
| รายการ | ค่า |
|---|---|
| รูปแบบ API | รองรับ OpenAI: ใช้ OpenAI SDK ใดก็ได้ แค่เปลี่ยน base URL และคีย์ |
| ID โมเดล | uncensored |
| การยืนยันตัวตน | Authorization: Bearer YOUR_KEY |
| เอนด์พอยต์ | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| เอาต์พุตสูงสุด | ได้ถึงส่วนที่เหลือของหน้าต่าง 100,000 โทเคน; max_tokens ไม่บังคับ (ไม่มีเพดานแยก) |
| พารามิเตอร์ | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| การเรียกใช้ฟังก์ชัน | รองรับ — tools, tool_choice คำตอบมี tool_calls รวมถึงตอนสตรีม ส่งผลลัพธ์กลับด้วย role: tool |
| สตรีมมิง | รองรับ — server-sent events ชิ้นสุดท้ายมีจำนวนโทเคนที่ใช้ |
| หน้าต่างบริบท | 100,000 โทเคน (อินพุตรวมเอาต์พุต) |
| โหมด JSON | response_format: {"type": "json_object"} |
| คำขอพร้อมกัน | สูงสุด 8 คำขอพร้อมกันต่อคีย์ |
| ขีดจำกัดอัตรา | 300 คำขอต่อนาทีต่อคีย์ |
| เฮดเดอร์ของคำตอบ | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| ขนาดคำขอ | ไม่เกิน 8 MB |
| ราคา | $0.15 ต่อ 1 ล้านโทเคนอินพุต · $0.50 ต่อ 1 ล้านโทเคนเอาต์พุต |
| การคิดเงิน | เครดิตแบบเติมเงินล่วงหน้าตามการใช้งานจริง ข้อผิดพลาดและการปฏิเสธไม่คิดเงิน |
| โบนัส | +5% เมื่อเติมตั้งแต่ $50, +10% ตั้งแต่ $100, +15% ตั้งแต่ $200 |
| อายุเครดิต | เครดิตที่ซื้อไม่มีวันหมดอายุ ไม่มีการสมัครรายเดือน |
| เติมเงิน | USDT (TRC20) หรือ USDC (Base) จำนวนเต็มใดก็ได้ตั้งแต่ $20 ถึง $500 |
| เครดิตทดลองใช้ฟรี | $0.50 ใช้ได้ 7 วัน ไม่ต้องใช้บัตร · คีย์ทดลอง: 2 คำขอพร้อมกัน, 60 ครั้งต่อนาที; ขีดจำกัดเต็ม (8 และ 300) หลังเติมเงินครั้งแรก |
| คีย์ | หนึ่งบัญชีมีคีย์ที่ใช้งานได้หนึ่งคีย์ คีย์ใหม่จะแทนคีย์เดิม |
| เข้าสู่ระบบ | Google หรืออีเมลและรหัสผ่าน |
| เนื้อหา | อนุญาตเนื้อหาสำหรับผู้ใหญ่ ปฏิเสธเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ |
รหัสข้อผิดพลาด
ข้อผิดพลาดส่งกลับเป็น JSON พร้อม type ที่คงที่ คำขอที่ล้มเหลวหรือถูกปฏิเสธไม่คิดเงิน
| รหัส | ประเภท | ความหมาย |
|---|---|---|
400 | bad_request | JSON ไม่ถูกต้อง ข้อความว่าง พารามิเตอร์ผิด หรือเกินหน้าต่างบริบท |
401 | missing_key · invalid_key · key_revoked | ไม่มีคีย์ คีย์ผิด หรือคีย์ถูกแทนที่แล้ว |
402 | no_credit | เครดิตหมด เติมเงินแล้วใช้งานต่อได้ทันที |
403 | content_blocked | เนื้อหาทางเพศเกี่ยวกับผู้เยาว์ ถูกปฏิเสธ ไม่คิดเงิน |
404 | not_found | ไม่รู้จักเอนด์พอยต์ |
413 | request_too_large | ขนาดเกิน 8 MB |
429 | rate_limited · concurrency | เกิน 300/นาที หรือ 8 พร้อมกัน รอแล้วลองใหม่ |
503 | upstream_busy | โมเดลไม่ว่าง ลองใหม่ในไม่กี่วินาที |