VI ▾
Lấy khóa API

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ụcGiá trị
Định dạngtương thích OpenAI: mọi SDK OpenAI đều chạy được, chỉ cần đổi base URL và khóa
Base URLhttps://api.kimiapi.top/v1
EndpointPOST /v1/chat/completions · GET /v1/models
Xác thựcAuthorization: Bearer YOUR_KEY
ID mô hìnhuncensored
Cửa sổ ngữ cảnh100.000 token (đầu vào + đầu ra)
Chế độ JSONresponse_format: {"type": "json_object"}
Đầu ra tối đatố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)
Streamingcó — 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àmcó — 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ờitối đa 8 cùng lúc cho mỗi khóa
Kích thước yêu cầutối đa 8 MB
Header phản hồiX-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ạntí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ềnUSDT (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ậpGoogle hoặc email và mật khẩu
Khóamỗi tài khoản một khóa đang hoạt động; khóa mới thay thế khóa cũ
Nội dungcho 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
400bad_requestJSON sai, tin nhắn trống, tham số sai hoặc vượt cửa sổ ngữ cảnh
401missing_key · invalid_key · key_revokedthiếu khóa, sai khóa hoặc khóa đã bị thay
402no_credithết tín dụng — nạp tiền là dùng tiếp ngay
403content_blockednội dung tình dục liên quan trẻ vị thành niên — từ chối, không tính phí
404not_foundendpoint không tồn tại
413request_too_largenội dung lớn hơn 8 MB
429rate_limited · concurrencyvượt 300/phút hoặc 8 đồng thời — chờ rồi thử lại
503upstream_busymô 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.