VI ▾
Lấy khóa API

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.

Lấy khóa API

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.

Lấy khóa APIĐọc tài liệu

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
ID mô hìnhuncensored
Xác thựcAuthorization: Bearer YOUR_KEY
EndpointPOST /v1/chat/completions · GET /v1/models
Base URLhttps://api.kimiapikey.com/v1
Đầ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)
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
Streamingcó — server-sent events; phần cuối chứa lượng token đã dùng
Cửa sổ ngữ cảnh100.000 token (đầu vào + đầu ra)
Chế độ JSONresponse_format: {"type": "json_object"}
Yêu cầu đồng thờitố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ồiX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Kích thước yêu cầutố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ạntín dụng đã trả không hết hạn, không đăng ký định kỳ
Nạp tiềnUSDT (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óamỗi tài khoản một khóa đang hoạt động; khóa mới thay thế khóa cũ
Đăng nhậpGoogle hoặc email và mật khẩu
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