kimiapikey.comคู่มือ
URL ฐาน API Moonshot: เปลี่ยนทิศทางโค้ดของคุณไปยังที่อื่น
URL ฐาน API Moonshot เป็นเพียงสตริงหนึ่งตัวในไคลเอนต์สไตล์ OpenAI ของคุณ และการเปลี่ยนมันคือวิธีเปลี่ยนทิศทางโค้ดชุดเดิมไปยังผู้ให้บริการอื่น หน้าเว็บนี้แสดงว่าสตริงนี้อยู่ที่ไหนใน Python, Node, curl และเครื่องมือทั่วไป รวมถึงวิธีชี้ไปยัง endpoint ทางเลือก
อัปเดต


ประเด็นสำคัญ
- base URL เป็นการตั้งค่าเดียว; ร่างคำขอยังคงอยู่ในรูปแบบแชทของ OpenAI
- เปลี่ยนสามสิ่งเมื่อสลับ: base URL, คีย์ API, model ID
- endpoint ของเราคือ https://api.kimiapikey.com/v1 และ model ID คือ uncensored
- มันเป็นโมเดลที่โฮสต์แยกต่างหาก ไม่ใช่บริการทางการของ Moonshot ดังนั้นควรทดสอบพรอมต์ของคุณอีกครั้ง
สิ่งที่ base URL ทำจริงๆ
ไคลเอนต์ที่เข้ากันได้กับ OpenAI สร้างทุกคำขอจากสองส่วน: base URL และพาธ SDK จะรวมเข้าด้วยกัน ดังนั้นการเรียก chat.completions.create จะกลายเป็น POST ไปยัง <base_url>/chat/completions ผู้ให้บริการที่ปฏิบัติตามรูปแบบนี้ รวมถึง Moonshot เผยแพร่ base URL ของตนเองในเอกสารประกอบของตน ดูที่นั่นแทนที่จะคัดลอกจากโพสต์ฟอรัม เพราะเป็นค่าเดียวที่คุณไม่สามารถเดาได้
ดังนั้นการเปลี่ยนผู้ให้บริการจึงต้องการการแก้ไขสามจุดและไม่มีอะไรอื่น:
- Base URL ซึ่งกำหนดว่าคำขอจะถูกส่งไปยังที่ใด
- คีย์ API ซึ่งออกให้ตามผู้ให้บริการแต่ละราย และใช้งานได้เฉพาะบนเซิร์ฟเวอร์ของผู้ให้บริการรายนั้นเท่านั้น
- Model ID เนื่องจากผู้ให้บริการแต่ละรายตั้งชื่อโมเดลของตนแตกต่างกัน
Messages, roles, streaming, tools และ JSON mode มีโครงสร้างเดียวกัน จึงทำให้การย้ายแพลตฟอร์มทำได้รวดเร็ว ส่วนฟีเจอร์เฉพาะของผู้ให้บริการรายใดรายหนึ่ง เช่น เครื่องมือค้นหาเว็บแบบบูรณาการ จะต้องการการจัดการแยกต่างหาก
การเก็บค่าทั้งสามนี้ไว้ด้วยกันในบล็อก config เดียวหรือไฟล์ environment ไฟล์เดียวต่อผู้ให้บริการก็ช่วยได้เช่นกัน เมื่อ base URL, คีย์ และ model ID อยู่เคียงข้างกัน การสลับกลับทำได้เพียงแก้ไขบรรทัดเดียว และคุณหลีกเลี่ยงสถานะที่ย้ายระบบไม่สมบูรณ์ซึ่งคีย์ใหม่อาจจับคู่กับที่อยู่เก่าได้
Python: แพ็กเกจ openai
ใน Python คุณตั้งค่า base URL เมื่อสร้าง client ตัวอย่างนี้เชื่อมต่อกับ endpoint บนเว็บไซต์นี้:
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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
หากคุณต้องการเก็บโค้ดให้ปราศจากการตั้งค่าแบบ hardcode ให้ใช้ environment แทน SDK จะอ่านค่า OPENAI_BASE_URL และ OPENAI_API_KEY เมื่อคุณเรียกใช้ OpenAI() โดยไม่ส่งอาร์กิวเมนต์ ทำให้การปรับใช้สามารถสลับผู้ให้บริการได้โดยไม่ต้องแก้ไขโค้ด โปรดทราบว่าสิ่งนี้หมายความว่าตัวแปรที่หลงเหลืออยู่ใน shell ของคุณสามารถทับค่าที่คุณเขียนไว้ในไฟล์ได้
Node และ curl
แพ็กเกจ JavaScript ทางการใช้ชื่อตัวเลือกเดียวกัน เขียนในรูปแบบ camel case:
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: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
เมื่อไม่มี SDK เลย base URL คือส่วนหน้าของที่อยู่:
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":"Hello"}]}'
เอนด์พอยต์เดียวกันนี้ยังรองรับ POST /v1/responses และ GET /v1/models แสดงรายการสิ่งที่ให้บริการ การตรวจสอบสิทธิ์คือ bearer token ใน header Authorization ในทุกกรณี
โปรแกรมแก้ไขและส่วนติดต่อผู้ใช้แบบแชท
เครื่องมือ GUI แสดง base URL ภายใต้ป้ายกำกับที่แตกต่างกัน: "API base", "Override OpenAI Base URL", "Custom endpoint" หรือ "Provider URL" ค่าที่คุณวางคือสตริงเดียวกันกับในโค้ดข้างต้น โดยลงท้ายที่ /v1 อย่าวางที่อยู่ /chat/completions เต็มๆ เว้นแต่เครื่องมือระบุว่าต้องการ URL แบบสมบูรณ์
หลังจากบันทึกแล้ว ให้เพิ่มไอดีโมเดลด้วยตนเองหากเครื่องมือไม่ดึงรายการ บางโปรแกรมแก้ไขตรวจสอบคีย์กับผู้ให้บริการคงที่และปฏิเสธค่าที่กำหนดเอง ในกรณีนี้ ให้มองหาการตั้งค่าที่เปิดโหมดกำหนดเองหรือโหมดที่เข้ากันได้กับ OpenAI ก่อน บทความเกี่ยวกับ การใช้คีย์ API สไตล์ Kimi ใน Cursor จะอธิบายเครื่องมือดังกล่าวอย่างละเอียด
สิ่งที่เปลี่ยนแปลงเมื่อสลับผู้ให้บริการ
รูปแบบที่ตรงกันไม่ได้หมายความว่าพฤติกรรมจะตรงกัน ก่อนย้ายปริมาณการผลิต ให้ตรวจสอบจุดเหล่านี้ทีละจุด:
- สไตล์ของผลลัพธ์ โมเดลที่แตกต่างกันเขียนผลลัพธ์แตกต่างกัน รันพรอมต์จริงของคุณ ไม่ใช่ตัวอย่างง่ายๆ
- ขนาดของ context window endpoint ที่นี่มีหน้าต่างบริบทขนาด 100,000 โทเคนสำหรับพรอมต์รวมกับการสร้างผลลัพธ์ หากการตั้งค่าปัจจุบันของคุณส่งพรอมต์ที่ยาวกว่า ให้ตัดทอนก่อน
- ขีดจำกัด คีย์แบบเต็มอนุญาตให้ทำคำขอพร้อมกัน (parallel requests) ได้ 8 คำขอและ 300 คำขอต่อนาที หากเกินขีดจำกัดใดขีดจำกัดหนึ่ง คุณจะได้รับ HTTP 429 พร้อมโค้ด
rate_limitedหรือconcurrency - ฟีเจอร์ รองรับสตรีมมิงผ่าน SSE, การเรียกใช้ฟังก์ชัน (function calling) และโหมด JSON ไม่รองรับการสร้างภาพ, เสียงและวิดีโอ, embeddings และการไฟน์ทูนิง นี่คือ API สำหรับข้อความเท่านั้น
- การตั้งชื่อ บริการนี้รันโมเดลแบบเปิดน้ำหนัก (open-weight model) เพียงตัวเดียวที่เลือกมาเพื่อตอบคำถามโดยไม่มีการปฏิเสธเนื้อหาสำหรับการใช้งานผู้ใหญ่ที่ถูกต้องตามกฎหมาย ไม่ใช่ API ทางการของ Moonshot และไม่ใช่ router ที่เชื่อมระหว่างผู้ขายหลายราย
วิธีที่เป็นกลางในการเปรียบเทียบคือการบันทึกพรอมต์สิบตัวเดียวกันผ่านเอนด์พอยต์ทั้งสองและอ่านคำตอบเคียงข้างกัน ใช้เวลาเพียงไม่กี่นาทีและช่วยประหยัดการคาดเดา
ข้อผิดพลาดของ Base URL และลักษณะที่ปรากฏ
ความล้มเหลวส่วนใหญ่หลังการสลับมาจากที่อยู่ ไม่ใช่คีย์ นี่คือวิธีที่ข้อผิดพลาดแต่ละข้อปรากฏขึ้นและวิธีแก้ไข
| ข้อผิดพลาด | อาการ | การแก้ไข |
|---|---|---|
เฉพาะ host ไม่มี /v1 | 404 ในทุกการเรียก | เพิ่ม /v1 ไปที่ส่วนท้าย |
| วางเส้นทางเต็มแล้ว | 404 พร้อมเส้นทางที่ซ้ำในข้อความแสดงข้อผิดพลาด | ตัดที่อยู่กลับเป็น /v1 |
| เครื่องหมายทับท้ายรวมกับการต่อเส้นทางด้วยตนเอง | เครื่องหมายทับคู่ใน URL | ให้ SDK ต่อเส้นทาง |
| คีย์เก่า URL ใหม่ | 401 | ใช้คีย์ที่ออกโดยผู้ให้บริการรายใหม่ |
| URL เก่า คีย์ใหม่ | 401 จากผู้ให้บริการรายเก่า | ค้นหาใน repo และ shell เพื่อหาที่อยู่เก่า |
http:// แทนที่จะเป็น https:// | ข้อผิดพลาดการเปลี่ยนเส้นทางหรือการเชื่อมต่อ | ใช้ https ทุกที่ |
วิธีค้นหาส่วนที่เหลืออย่างรวดเร็วคือค้นหาชื่อโฮสต์เก่าในโปรเจกต์และการตั้งค่าการ deploy ของคุณ ดูในไฟล์ .env ตัวแปร CI ไฟล์ Docker compose และการตั้งค่า editor และวิธีสลับไปใช้ endpoint อื่นด้วยรหัสโมเดล uncensored ทั้งหมด เนื่องจากสำเนาที่ถูกลืมเพียงสำเนาก็เพียงพอที่จะส่ง traffic ไปยังผู้ให้บริการเก่า
สตรีมมิงและเครื่องมือหลังจากการเปลี่ยน
ตั้งค่า stream: true และการตอบกลับจะมาถึงในรูปแบบ server-sent events โดยมีการรายงานการใช้งานโทเคนที่ส่วนท้าย การเรียกใช้เครื่องมือใช้ฟิลด์ tools และ tool_choice ตามปกติ โดยส่ง tool_calls และผลลัพธ์กลับเป็นข้อความที่มี role: "tool" หากโค้ดของคุณจัดการสิ่งเหล่านี้สำหรับผู้ให้บริการเก่าอยู่แล้ว มันควรทำงานต่อไปได้; ยืนยันโดยการเรียกใช้การเรียกแบบสตรีมหนึ่งครั้งและการเรียกใช้เครื่องมือหนึ่งครั้งก่อนจะเปลี่ยนอย่างสมบูรณ์ โปรดจำไว้ว่าการเรียกแบบสตรีมจะครอบครอง slot concurrency จนกว่าสตรีมจะสิ้นสุด
ตรวจสอบต้นทุนก่อนเปลี่ยน
การเรียกเก็บเงินที่นี่คิดตามโทเคน: $0.15 ต่อ 1M โทเคนอินพุต และ $0.50 ต่อ 1M โทเคนเอาต์พุต จากเครดิตแบบเติมเงินล่วงหน้า โดยไม่มี subscription คำขอที่ล้มเหลวหรือถูกปฏิเสธจะไม่ถูกเรียกเก็บเงิน และเครดิตไม่หมดอายุ สำหรับอัตราของผู้ให้บริการรายอื่น โปรดดูหน้าราคาปัจจุบันของพวกเขาเนื่องจากมีการเปลี่ยนแปลง
ตัวอย่างการคำนวณ สมมติว่าคำขอมีโทเคนอินพุต 2,000 และโทเคนเอาต์พุต 500:
- อินพุต: 2,000 / 1,000,000 x $0.15 = $0.0003
- เอาต์พุต: 500 / 1,000,000 x $0.50 = $0.00025
- รวม: $0.00055 ต่อคำขอ ดังนั้น 1,000 คำขอมีค่าใช้จ่าย $0.55
การเติมเงินขั้นต่ำคือ $20 และการเติมเงินจำนวนมากขึ้นจะเพิ่มโบนัส: +5% จาก $50, +10% จาก $100 และ +15% จาก $200 คริปโต (USDT บน TRC20, USDC บน Base) เท่านั้น รายละเอียดเต็มมีอยู่ใน หน้าราคา และการแยกย่อยที่เน้น Kimi มีอยู่ใน ราคาคีย์ API ของ Kimi
รับคีย์และเรียกใช้คำขอแรก
สมัครสมาชิกด้วย Google หรือด้วยอีเมลและรหัสผ่าน จากนั้นเปิด หน้าคีย์ API ผู้ใช้ใหม่สามารถรับเครดิตทดลองใช้ $0.50 ได้ที่นั่นด้วยการคลิกหนึ่งครั้ง ต่อหนึ่งคน ใช้ได้เป็นเวลา 7 วัน และไม่จำเป็นต้องใช้บัตร คีย์ทดลองใช้จำกัดคำขอพร้อมกัน 2 คำขอและ 60 คำขอต่อนาที ซึ่งเพียงพอสำหรับการทดสอบ
วางคีย์ลงในโค้ด Python ด้านบน รัน และยืนยันว่าคุณได้รับข้อความกลับ รายการ เอกสาร ระบุพารามิเตอร์ทั้งหมด และส่วนหัวของคำตอบ X-Request-Id และ X-Balance-USD ช่วยในการดีบัก และการติดตามยอดเครดิต พรอมต์ที่ส่งไปยังบริการจะไม่ถูกใช้ในการฝึกโมเดล
คู่มือเพิ่มเติม
- คีย์ API Kimi ใช้ไม่ได้: สาเหตุ วิธีแก้ และทางสำรอง
- วิธีใช้คีย์ API แบบ Kimi ใน Cursor: คู่มือการติดตั้ง
คำถามที่พบบ่อย
โมเดลเหมือนกันกับ Kimi ทางการของ Moonshot หรือไม่?
ไม่ เราโฮสต์โมเดลแบบเปิดน้ำหนักที่ปรับแต่งให้ไม่เซ็นเซอร์ มันไม่ใช่ GPT, Claude, Gemini, Grok, DeepSeek หรือโมเดลของผู้ให้บริการรายอื่น มันเป็นโมเดลที่แตกต่างกันที่รันบนเซิร์ฟเวอร์ของเราเอง
คุณฝึกข้อมูลของฉันหรือไม่?
ไม่ พรอมต์และการสร้างข้อความของคุณไม่ถูกใช้ในการฝึก เราให้ความสำคัญกับความเป็นส่วนตัวและความโปร่งใส ดังนั้นข้อมูลของคุณยังคงเป็นของคุณ
ขีดจำกัดอัตราคืออะไร?
คุณจำกัดอยู่ที่ 300 คำขอต่อนาทีต่อคีย์ ขนาดบอดีในคำขอสูงสุดคือ 8 MB ขีดจำกัดเหล่านี้ถูกออกแบบมาเพื่อให้แน่ใจว่าประสิทธิภาพที่เสถียรสำหรับผู้ใช้ทุกคน
นโยบายเนื้อหาคืออะไร?
โมเดลไม่เซ็นเซอร์เรื่องผู้ใหญ่ วิวาทะ และสร้างสรรค์ แต่เราบล็อกเนื้อหาทางเพศที่เกี่ยวข้องกับผู้เยาว์ นี่คือขีดจำกัดที่แข็งซึ่งใช้เสมอไม่ว่าระดับสมาชิกของคุณจะเป็นอย่างไร
ถาม-ตอบ
ต้องเปลี่ยนโค้ดเมื่อเปลี่ยน Base URL หรือไม่?
โดยปกติมีเพียงสามค่า: base URL, คีย์ API และรหัสโมเดล รูปแบบข้อความ การสตรีม และการเรียกใช้ฟังก์ชันจะคงเดิมตราบใดที่ผู้ให้บริการรายใหม่รองรับ
Base URL ควรลงท้ายด้วย /v1 หรือไม่?
ใช่สำหรับเอนด์พอยต์นี้: https://api.kimiapikey.com/v1. SDK จะเพิ่ม /chat/completions ให้เอง ดังนั้นไม่ต้องใส่
นี่คือ API ทางการของ Moonshot ใช่หรือไม่?
ไม่ นี่คือโมเดลแบบเปิดน้ำหนักที่โฮสต์โดยอิสระผ่าน API ที่เข้ากันได้กับ OpenAI ไม่ใช่บริการของ Moonshot และไม่ใช่ตัวกระจายคำขอข้ามผู้ให้บริการ
ฉันจะหารหัสโมเดลได้อย่างไร
เรียกใช้ GET /v1/models พร้อมคีย์ของคุณ ที่เอนด์พอยต์นี้ model ID คือ uncensored
คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว
สร้างบัญชี คัดลอกคีย์ และเปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด