Hướng dẫn Bắt đầu Nhanh API Kimi

Điều kiện tiên quyết: Cài đặt SDK

Cài đặt SDK chính thức cho ngôn ngữ ưa thích của bạn để xử lý xác thực và tuần tự hóa một cách tự động. API của chúng tôi tuân thủ tiêu chuẩn OpenAI, vì vậy bất kỳ thư viện máy khách tương thích nào cũng hoạt động với ít thay đổi cấu hình.

Đối với Python, hãy cài đặt thư viện qua pip. Đối với Node.js, hãy sử dụng npm hoặc yarn. Các công cụ này quản lý máy khách HTTP và phân tích cú pháp JSON cho bạn.

Xác thực: Đặt khóa kimi API của bạn

Thu được khóa của bạn từ bảng điều khiển và truyền nó dưới dạng Authorization header. Sử dụng URL cơ bản https://api.apikimi.cc/v1 cho tất cả các yêu cầu.

Lưu khóa một cách bảo mật trong các biến môi trường hoặc tệp cấu hình của bạn. Định dạng header là Bearer YOUR_API_KEY.

Gửi yêu cầu đầu tiên của bạn

Gửi yêu cầu POST đến /v1/chat/completions với định danh mô hình của bạn uncensored. Phản hồi trả về văn bản được tạo trực tiếp.

Đảm bảo bạn đặt model field chính xác. API trả về đầu ra thô mà không từ chối nội dung đối với các chủ đề hợp pháp.

Phản hồi luồng

Bật phát trực tiếp bằng cách đặt stream: true trong thân yêu cầu của bạn. Điều này trả về các chunk dưới dạng Server-Sent Events (SSE).

Phân tích luồng SSE để hiển thị token theo thời gian thực. Chunk cuối cùng bao gồm thống kê sử dụng token để tính phí.

Cài đặt Function Calling

Định nghĩa các công cụ trong tools mảng trong yêu cầu của bạn. Mô hình trả về các lệnh gọi công cụ thay vì văn bản trực tiếp khi thích hợp.

Xử lý các lệnh gọi công cụ trong logic ứng dụng của bạn và gửi kết quả lại cho API để xử lý thêm. Hỗ trợ cho tool_choice cho phép thực thi nghiêm ngặt.

Xử lý lỗi và Giới hạn

Xử lý các lỗi HTTP tiêu chuẩn: 401 cho khóa không hợp lệ, 402 cho số dư không đủ và 429 cho giới hạn tốc độ. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100,000 token.

Đầu ra tối đa là 16.000 token mỗi yêu cầu. Lỗi không tiêu thụ tín dụng. Điều chỉnh logic thử lại của bạn dựa trên mã lỗi.

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);

Phát trực tiếp

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)