Yêu cầu đầu tiên trong năm phút
Đặt khóa API Kimi của bạn vào bất kỳ máy khách tương thích OpenAI nào và bắt đầu tạo văn bản không kiểm duyệt. Hướng dẫn này cho bạn biết chính xác cách định cấu hình SDK của bạn và hiểu rõ giá token thực tế.
Cài đặt SDK Python/Node OpenAI
Bắt đầu bằng cách cài đặt thư viện máy khách OpenAI tiêu chuẩn. Điều này hoạt động vì API của chúng tôi tuân theo giao diện tương thích OpenAI. Bạn không cần SDK của nhà cung cấp đặc biệt. Chỉ cần chạy pip install openai cho Python hoặc npm install openai cho Node.js. Thư viện tự động xử lý việc tuần tự hóa JSON và các yêu cầu HTTP.
Cấu hình URL cơ sở và Khóa API
Định cấu hình máy khách của bạn trỏ đến endpoint của chúng tôi. Đặt URL cơ sở thành https://api.kimiapi.top/v1 và cung cấp khóa API của bạn từ bảng điều khiển. Khóa này xác thực tín dụng trả trước của bạn. Bạn có thể tạo khóa mới ngay lập tức thông qua Google hoặc email trên trang đăng ký. Không cần thẻ tín dụng để bắt đầu.
curl https://api.kimiapi.top/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."}]
}'
Gửi yêu cầu hoàn thành trò chuyện đầu tiên của bạn
Gửi một tin nhắn đơn giản đến mô hình uncensored. Mô hình này được tinh chỉnh để trả lời mà không từ chối cho việc sử dụng người lớn hợp pháp. Nó hỗ trợ cửa sổ ngữ cảnh 100.000 token, mặc dù đầu ra tối đa là 32.000 token. Phản hồi trả về văn bản trực tiếp. Lỗi và từ chối không tiêu tốn tín dụng của bạn.
from openai import OpenAI
client = OpenAI(base_url="https://api.kimiapi.top/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)
Bật truyền phát với SSE
Để có phản hồi theo thời gian thực, hãy bật truyền phát (streaming). SDK truyền phát các token qua Server-Sent Events (SSE). Chunk cuối cùng chứa tổng mức sử dụng token để tính phí. Cách tiếp cận này giảm độ trễ cảm nhận được đối với các đầu ra dài. Bạn có thể xử lý từng token khi nó đến trong logic ứng dụng của bạn.
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)
Sử dụng chế độ JSON cho đầu ra có cấu trúc
Đảm bảo đầu ra có thể đọc được bằng máy bằng cách đặt response_format thành {"type": "json_object"}. Điều này buộc mô hình trả về JSON hợp lệ. Nó lý tưởng để trích xuất dữ liệu hoặc tạo cấu hình. Mô hình sẽ không phá vỡ cấu trúc, giúp dễ dàng phân tích phản hồi trong mã của bạn.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.kimiapi.top/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);
Kiểm tra mức sử dụng và chi phí
Giám sát mức sử dụng của bạn qua bảng điều khiển. Chi phí đầu vào là $0.25 mỗi triệu token; đầu ra là $1.00 mỗi triệu token. Nếu bạn nhận được 401, hãy kiểm tra khóa của bạn. 402 có nghĩa là bạn cần nạp tiền bằng USDT hoặc USDC. 429 cho biết bạn đã đạt giới hạn 300 yêu cầu mỗi phút. Tín dụng không bao giờ hết hạn, vì vậy hãy nạp tiền khi thuận tiện.
Thông số kỹ thuật
Toàn bộ giới hạn và tính năng thực tế của API ở một nơi — hãy kiểm tra trước khi nạp tiền.
| Mục | Giá trị |
|---|---|
| Định dạng | tương thích OpenAI: mọi SDK OpenAI đều chạy được, chỉ cần đổi base URL và khóa |
| Base URL | https://api.kimiapi.top/v1 |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Xác thực | Authorization: Bearer YOUR_KEY |
| ID mô hình | uncensored |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Đầu ra tối đa | tối đa phần còn lại của cửa sổ 100.000 token; max_tokens tùy chọn (không giới hạn riêng) |
| Streaming | có — server-sent events; phần cuối chứa lượng token đã dùng |
| Tham số | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Gọi hàm | có — tools, tool_choice; phản hồi có tool_calls, kể cả khi streaming; kết quả gửi lại bằng role: tool |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| Yêu cầu đồng thời | tối đa 8 cùng lúc cho mỗi khóa |
| Kích thước yêu cầu | tối đa 8 MB |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Tính phí | tín dụng trả trước theo mức dùng thực tế; lỗi và từ chối miễn phí |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| Giá | $0,25 cho 1 triệu token đầu vào · $1,00 cho 1 triệu token đầu ra |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $10 đến $500 |
| Dùng thử miễn phí | $0,50 trong 7 ngày, không cần thẻ · Khóa dùng thử: 2 yêu cầu song song, 60 yêu cầu/phút; hạn mức đầy đủ (8 và 300) sau lần nạp đầu |
| Thưởng | +5% từ $50, +10% từ $100 |
| Đăng nhập | Google hoặc email và mật khẩu |
| Khóa | mỗi tài khoản một khóa đang hoạt động; khóa mới thay thế khóa cũ |
| Nội dung | cho phép nội dung người lớn; từ chối nội dung tình dục liên quan đến trẻ vị thành niên |
Mã lỗi
Lỗi trả về dạng JSON với type cố định; yêu cầu lỗi hoặc bị từ chối không bị tính phí.
| Mã | Loại | Ý nghĩa |
|---|---|---|
400 | bad_request | JSON sai, tin nhắn trống, tham số sai hoặc vượt cửa sổ ngữ cảnh |
401 | missing_key · invalid_key · key_revoked | thiếu khóa, sai khóa hoặc khóa đã bị thay |
402 | no_credit | hết tín dụng — nạp tiền là dùng tiếp ngay |
403 | content_blocked | nội dung tình dục liên quan trẻ vị thành niên — từ chối, không tính phí |
404 | not_found | endpoint không tồn tại |
413 | request_too_large | nội dung lớn hơn 8 MB |
429 | rate_limited · concurrency | vượt 300/phút hoặc 8 đồng thời — chờ rồi thử lại |
503 | upstream_busy | mô hình đang bận — thử lại sau vài giây |
Hỏi đáp
Cách tính phí hoạt động cho API Kimi?
Bạn chỉ trả tiền cho việc sử dụng token thực tế. Token đầu vào giá $0.25 mỗi triệu, token đầu ra giá $1.00 mỗi triệu. Lỗi và từ chối đều miễn phí. Tín dụng trả trước và không bao giờ hết hạn.
Các loại thanh toán crypto nào được chấp nhận?
Chúng tôi chấp nhận USDT (TRC20) và USDC (Base). Nạp tiền từ $10 đến $500. Thanh toán được xử lý trực tiếp mà không cần thẻ hoặc PayPal.
Giới hạn cửa sổ ngữ cảnh là bao nhiêu?
Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token cho cả prompt và hoàn thành. Tuy nhiên, đầu ra tối đa mỗi yêu cầu là 32.000 token trừ khi bạn chỉ định giới hạn thấp hơn.
Khóa của bạn chỉ cách một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.