คู่มือเริ่มต้นใช้งาน API Kimi

ข้อกำหนดเบื้องต้น: การติดตั้ง SDK

ติดตั้ง SDK ทางการสำหรับภาษาที่คุณต้องการเพื่อจัดการการตรวจสอบสิทธิ์และการจัดรูปแบบคำขอโดยอัตโนมัติ API ของเราปฏิบัติตามมาตรฐาน OpenAI ดังนั้นไลบรารีไคลเอนต์ที่เข้ากันได้จึงทำงานได้ด้วยการเปลี่ยนแปลงการกำหนดค่าเพียงเล็กน้อย

สำหรับ Python ติดตั้งไลบรารีผ่าน pip สำหรับ Node.js ใช้ npm หรือ yarn เครื่องมือเหล่านี้จัดการ HTTP client และการแยกวิเคราะห์ JSON ให้คุณ

การตรวจสอบสิทธิ์: การตั้งค่าคีย์ API ของ kimi

รับคีย์ของคุณจากแดชบอร์ดและส่งเป็น Authorization header. ใช้ URL พื้นฐาน https://api.apikimi.cc/v1 สำหรับคำขอทั้งหมด

เก็บคีย์อย่างปลอดภัยในตัวแปรสภาพแวดล้อมหรือไฟล์กำหนดค่า รูปแบบเฮดเดอร์คือ Bearer YOUR_API_KEY.

การส่งคำขอครั้งแรกของคุณ

ส่งคำขอ POST ไปยัง /v1/chat/completions พร้อมรหัสโมเดลของคุณ uncensored. การตอบสนองจะคืนค่าข้อความที่สร้างขึ้นมาโดยตรง

ตรวจสอบว่าคุณตั้งค่า model field correctly. The API returns raw output without content refusals for lawful topics.

การตอบกลับแบบสตรีมมิ่ง

เปิดใช้งานการสตรีมโดยตั้งค่า stream: true ใน body ของคำขอของคุณ สิ่งนี้จะส่งคืนข้อมูลเป็น Server-Sent Events (SSE)

แยกวิเคราะห์สตรีม SSE เพื่อแสดงผลโทเค็นแบบเรียลไทม์ ชิ้นสุดท้ายรวมสถิติการใช้งานโทเค็นสำหรับการเรียกเก็บเงิน

การตั้งค่า Function Calling

กำหนดเครื่องมือใน tools อาร์เรย์ภายในคำขอของคุณ โมเดลจะส่งคืนการเรียกเครื่องมือแทนข้อความโดยตรงเมื่อเหมาะสม

จัดการการเรียกเครื่องมือในตรรกะแอปพลิเคชันของคุณและส่งผลลัพธ์กลับไปยัง API เพื่อประมวลผลเพิ่มเติม รองรับ tool_choice อนุญาตให้บังคับใช้อย่างเคร่งครัด

การจัดการข้อผิดพลาดและขีดจำกัด

จัดการข้อผิดพลาด HTTP มาตรฐาน: 401 สำหรับคีย์ที่ไม่ถูกต้อง 402 สำหรับยอดเงินไม่เพียงพอ และ 429 สำหรับขีดจำกัดอัตรา หน้าต่างบริบทรองรับ 100,000 tokens รวม

เอาต์พุตสูงสุดคือ 16,000 โทเค็นต่อคำขอ ข้อผิดพลาดไม่ใช้เครดิต ปรับตรรกะการลองใหม่ของคุณตามรหัสข้อผิดพลาด

cURL

Copycurl https://api.apikimi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the key differences between Rust and Go memory management"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apikimi.cc/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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apikimi.cc/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);

การสตรีม

Copystream = 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)