kimiapikey.comTài liệu
API Kimi: Yêu cầu đầu tiên trong năm phút
Nhận phản hồi đầu tiên của bạn trong vòng năm phút bằng giao diện tương thích OpenAI tiêu chuẩn. Hướng dẫn này bao gồm thiết lập, xác thực và cách sử dụng cơ bản cho mô hình không kiểm duyệt.
Yêu cầu tiên quyết
Để bắt đầu, bạn cần một khóa API từ kimiapikey.com. Đăng ký chỉ bằng email và mật khẩu; không cần thẻ tín dụng cho bản dùng thử. Bạn cũng cần môi trường ngôn ngữ được hỗ trợ với SDK chính thức hoặc tương thích đã được cài đặt. API của chúng tôi tuân theo định dạng chat-completions của OpenAI, vì vậy mã hiện có cho GPT-3.5/4 thường hoạt động với ít thay đổi. Đảm bảo phiên bản SDK của bạn đủ mới để hỗ trợ tham số base_url.
URL cơ sở và Xác thực
API của chúng tôi nằm tại https://api.kimiapikey.com/v1. Xác thực được xử lý qua tiêu đề Authorization tiêu chuẩn. Hãy truyền khóa của bạn dưới dạng token Bearer. Điều này hoạt động với bất kỳ máy khách nào chấp nhận các endpoint tương thích OpenAI. Nếu bạn đang sử dụng proxy hoặc máy khách tùy chỉnh, hãy đảm bảo nó chuyển tiếp tiêu đề Authorization một cách chính xác. ID mô hình bạn sẽ yêu cầu là uncensored.
Yêu cầu đầu tiên
Gửi một yêu cầu chat đơn giản để kiểm tra cài đặt. Dùng lệnh curl bên dưới, thay YOUR_API_KEY bằng khóa API của bạn. Yêu cầu này gửi prompt ngắn đến mô hình uncensored. Nếu thành công, bạn nhận được phản hồi JSON chứa câu trả lời. Kiểm tra mảng choices để lấy văn bản. Lỗi 401 nghĩa là khóa không hợp lệ hoặc hết hạn.
SDK Python
Dùng thư viện Python chính thức của OpenAI để tích hợp dễ nhất. Đặt base_url thành endpoint của chúng tôi và cung cấp khóa của bạn. Ví dụ này minh họa một lệnh tạo văn bản cơ bản. Bạn có thể điều chỉnh tham số model nếu cần, mặc dù uncensored là mặc định. Cách này giữ mã nguồn của bạn tương thích với các dịch vụ tương thích OpenAI khác.
SDK Node.js
Với dự án JavaScript/TypeScript, dùng gói npm openai. Cấu hình client với URL cơ sở của chúng tôi và khóa API của bạn. Điều này cho phép bạn gửi yêu cầu trực tiếp từ môi trường Node. Cú pháp giống SDK Python, đảm bảo tính nhất quán khi chuyển ngôn ngữ. Nhớ xử lý phản hồi không đồng bộ đúng cách bằng await.
Phản hồi truyền phát
Để xuất đầu ra thời gian thực, hãy bật streaming trong SDK của bạn. Điều này gửi các đoạn văn bản khi chúng được tạo, giảm độ trễ cảm nhận. Dùng cờ stream trong yêu cầu. SDK sẽ trả về các phản hồi từng phần, cho phép bạn cập nhật giao diện người dùng theo từng bước. Điều này lý tưởng cho giao diện trò chuyện hoặc tạo nội dung dài nơi phản hồi ngay lập tức có giá trị.
Giới hạn và Lỗi
Mỗi khóa bị giới hạn 300 yêu cầu mỗi phút. Nếu bạn vượt quá giới hạn này, bạn sẽ nhận được lỗi 429. Thân yêu cầu của bạn không được vượt quá 8 MB. Cửa sổ ngữ cảnh 100.000 token áp dụng cho tổng của prompt và phần hoàn thành. Các lỗi phổ biến bao gồm 401 (khóa không hợp lệ) và 402 (tín dụng không đủ). Nạp tiền qua bảng điều khiển để tiếp tục sử dụng API. Tín dụng không bao giờ hết hạn và không có phí hàng tháng.
cURL
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": "Write a blunt product review of a cheap VPN."}]
}'Python
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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Truyền phát
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)Hỏi đáp
API có hỗ trợ gọi hàm không?
Có, endpoint hỗ trợ gọi công cụ/hàm theo định dạng OpenAI tiêu chuẩn. Bạn có thể định nghĩa công cụ trong yêu cầu và mô hình sẽ trả về các đối số có cấu trúc.
Điều gì xảy ra nếu tôi vượt quá giới hạn tốc độ?
Bạn sẽ nhận được lỗi 429 Quá nhiều yêu cầu. Hãy đợi một lúc và thử lại, hoặc nâng cấp gói tín dụng trả trước để duy trì thông lượng cao hơn.
Mô hình có được huấn luyện trên dữ liệu của tôi không?
Không. Các prompt gửi đến API không được dùng để huấn luyện. Dữ liệu của bạn vẫn riêng tư và không được dùng để cải thiện mô hình cơ sở.
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ộ quá trình thiết lập.
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 |
| ID mô hình | uncensored |
| Xác thực | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| Đầ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) |
| 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 |
| Streaming | có — server-sent events; phần cuối chứa lượng token đã dùng |
| Cửa sổ ngữ cảnh | 100.000 token (đầu vào + đầu ra) |
| Chế độ JSON | response_format: {"type": "json_object"} |
| Yêu cầu đồng thời | tối đa 8 cùng lúc cho mỗi khóa |
| Giới hạn tốc độ | 300 yêu cầu mỗi phút cho mỗi khóa |
| Header phản hồi | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Kích thước yêu cầu | tối đa 8 MB |
| Giá | $0,15 cho 1 triệu token đầu vào · $0,50 cho 1 triệu token đầu ra |
| 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ưởng | +5% từ $50, +10% từ $100, +15% từ $200 |
| Thời hạn | tín dụng đã trả không hết hạn, không đăng ký định kỳ |
| Nạp tiền | USDT (TRC20) hoặc USDC (Base), số tiền nguyên bất kỳ từ $20 đế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 |
| 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ũ |
| Đăng nhập | Google hoặc email và mật khẩu |
| 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 |