TH ▾
รับคีย์ API

kimiapikey.comคู่มือ

URL ฐาน API Moonshot: เปลี่ยนทิศทางโค้ดของคุณไปยังที่อื่น

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

อัปเดต

สายเคเบิลที่เคลื่อนย้ายระหว่างสองช่องต่อบนแผงสวิตช์ แสดงถึงการเปลี่ยน URL ฐาน API
ภาพประกอบไอโซเมตริกของโปรแกรมแก้ไขโค้ดที่เชื่อมต่อกับเซิร์ฟเวอร์ API ด้วยสายไฟเรืองแสง

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

  • 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 ของตนเองในเอกสารประกอบของตน ดูที่นั่นแทนที่จะคัดลอกจากโพสต์ฟอรัม เพราะเป็นค่าเดียวที่คุณไม่สามารถเดาได้

ดังนั้นการเปลี่ยนผู้ให้บริการจึงต้องการการแก้ไขสามจุดและไม่มีอะไรอื่น:

  1. Base URL ซึ่งกำหนดว่าคำขอจะถูกส่งไปยังที่ใด
  2. คีย์ API ซึ่งออกให้ตามผู้ให้บริการแต่ละราย และใช้งานได้เฉพาะบนเซิร์ฟเวอร์ของผู้ให้บริการรายนั้นเท่านั้น
  3. 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 ไม่มี /v1404 ในทุกการเรียกเพิ่ม /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 ช่วยในการดีบัก และการติดตามยอดเครดิต พรอมต์ที่ส่งไปยังบริการจะไม่ถูกใช้ในการฝึกโมเดล

คำถามที่พบบ่อย

โมเดลเหมือนกันกับ 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 นั่นคือการตั้งค่าทั้งหมด

รับคีย์ APIอ่านเอกสาร