kimiapikey.comHướng dẫn
Sử dụng khóa API kiểu Kimi trong Cursor: Hướng dẫn thiết lập
Cursor có thể kết nối với bất kỳ endpoint nào tương thích OpenAI, vì vậy việc kết nối với API này chỉ cần bốn trường và khoảng hai phút. Hướng dẫn này bao gồm các giá trị chính xác, một bài kiểm tra chứng minh khóa hoạt động và các lỗi có khả năng cao nhất bạn sẽ gặp phải.
Cập nhật

Điểm chính
- Cursor cần ba giá trị: khóa của bạn, URL cơ sở https://api.kimiapikey.com/v1 và tên mô hình
uncensored. - Hãy kiểm thử khóa bằng curl trước, để một vấn đề phía Cursor dễ dàng được phân biệt với một vấn đề phía API.
- Các chỉnh sửa theo kiểu agent gửi các prompt lớn, vì vậy bạn hãy theo dõi token đầu vào: $0,15 cho mỗi 1M token đầu vào, $0,50 cho mỗi 1M token đầu ra.
- Khóa dùng thử cho phép 2 yêu cầu đồng thời, điều mà agent của Cursor có thể vượt quá. Khóa đầy đủ cho phép 8.
Câu trả lời ngắn gọn
Nếu bạn đang tìm kiếm cách sử dụng khóa API Kimi trong Cursor, điều đầu tiên cần biết là một khóa do nhà cung cấp khác cấp phát chỉ hoạt động với endpoint của chính nhà cung cấp đó. Khóa từ trang web này hoạt động với endpoint của trang web này, và Cursor chấp nhận nó vì endpoint sử dụng định dạng chat completions của OpenAI. Bạn dán khóa, trỏ Cursor đến một URL cơ sở khác và thêm một tên mô hình tùy chỉnh.
Toàn bộ quy trình thiết lập theo thứ tự:
- Tạo tài khoản và sao chép khóa của bạn từ trang Khóa API.
- Mở Cursor, vào Cài đặt, sau đó Mô hình.
- Dán khóa vào trường khóa API OpenAI.
- Bật ghi đè URL cơ sở và nhập
https://api.kimiapikey.com/v1. - Thêm một mô hình tùy chỉnh tên là
uncensoredvà chọn nó trong cuộc trò chuyện.
Phần còn lại của bài viết này giải thích từng bước, cung cấp cho bạn một cách để kiểm tra kết nối bên ngoài trình soạn thảo và liệt kê những lỗi thường xảy ra.
Khóa này là gì và không phải là gì
Trang web này bán quyền truy cập vào một mô hình trọng số mở, do một nhà cung cấp độc lập vận hành và được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp. Đây không phải là API chính thức của Moonshot, Kimi hoặc bất kỳ nhà cung cấp nào khác, và đây không phải là một router chuyển tiếp yêu cầu của bạn đến mô hình của người khác. Tên trang web phản ánh những gì mọi người tìm kiếm, không phải ai là người vận hành dịch vụ. Nếu bạn đã sở hữu một khóa từ nhà cung cấp khác, hãy tiếp tục sử dụng nó với endpoint của nhà cung cấp đó. Hai khóa này không thể thay thế cho nhau.
Những gì bạn nhận được là một API theo phong cách OpenAI: POST /v1/chat/completions và GET /v1/models, xác thực token bearer, cửa sổ ngữ cảnh 100.000 token, truyền phát (streaming), gọi hàm và chế độ JSON. Chỉ có văn bản. Không có tạo ảnh, không có embedding và không có tinh chỉnh, điều này quan trọng trong trình soạn thảo vì các tính năng của Cursor phụ thuộc vào những tính năng đó sẽ không sử dụng endpoint này. Giải thích về khóa API Kimi đi vào chi tiết hơn về cách đặt tên và các lựa chọn thay thế.
Đối với lập trình, "uncensored" có một ý nghĩa thực tế. Mô hình sẽ không dừng lại giữa chừng khi thực hiện một nhiệm vụ vì một tên biến hoặc bộ thử nghiệm trông có vẻ nhạy cảm. Công cụ bảo mật cho các hệ thống bạn sở hữu, trình phân tích log chứa nhiều chuỗi khó nhìn, trình thu thập dữ liệu, trình tạo tiểu thuyết và bộ dữ liệu kiểm thử kiểm duyệt nội dung là những loại công việc thường gây ra từ chối ở nơi khác. Giới hạn cứng vẫn được duy trì: không có nội dung tình dục liên quan đến người chưa thành niên, bao giờ cũng vậy.
Hướng dẫn thiết lập từng bước trong Cursor
1. Lấy khóa và tín dụng dùng thử
Đăng ký bằng Google, hoặc bằng email và mật khẩu. Trên trang khóa API, bạn có thể nhận $0,50 tín dụng dùng thử chỉ với một cú nhấp chuột. Nó không cần thẻ, kéo dài 7 ngày và là một lần cho mỗi người. Điều đó đủ cho vài trăm yêu cầu trò chuyện bình thường, vì vậy bạn có thể hoàn thành toàn bộ hướng dẫn này trước khi trả bất kỳ khoản tiền nào.
2. Mở cài đặt mô hình
Trong Cursor, mở Cài đặt và tìm phần Mô hình. Nhãn menu thay đổi giữa các phiên bản, vì vậy hãy tìm một trường có tên cho khóa API OpenAI và một công tắc hoặc trường có tên cho việc ghi đè URL cơ sở OpenAI. Đó là hai cài đặt quan trọng.
3. Điền ba giá trị
| Trường Cursor | Giá trị |
|---|---|
| Khóa API OpenAI | Khóa của bạn từ bảng điều khiển |
| Ghi đè URL cơ sở OpenAI | https://api.kimiapikey.com/v1 |
| Tên mô hình tùy chỉnh | uncensored |
Nhập URL cơ sở chính xác như hiển thị. Nó kết thúc bằng /v1, không có dấu gạch chéo cuối và không có /chat/completions, vì máy khách thêm đường dẫn này. Một URL dán có đường dẫn đầy đủ sẽ tạo ra lỗi 404, và thông báo lỗi hiếm khi nói tại sao.
4. Chọn mô hình và gửi tin nhắn
Mở bảng trò chuyện, chọn uncensored từ danh sách mô hình và hỏi một thứ gì đó nhỏ, chẳng hạn như "viết một hàm phân tích ngày ISO". Nếu phản hồi được truyền phát, bạn đã hoàn thành. Nếu Cursor hiển thị lỗi, đừng thay đổi cài đặt một cách ngẫu nhiên. Hãy chuyển sang phần tiếp theo và kiểm thử endpoint trực tiếp.
5. Biết hiệu ứng phụ của việc ghi đè
Việc ghi đè URL cơ sở thường áp dụng cho mọi mô hình kiểu OpenAI bạn sử dụng trong Cursor, không chỉ mô hình tùy chỉnh. Nếu bạn chuyển lại sang mô hình OpenAI tiêu chuẩn sau này, hãy tắt ghi đè trước, nếu không yêu cầu của bạn sẽ được gửi đến endpoint này với tên mô hình mà nó không cung cấp.
Kiểm thử khóa trước khi đổ lỗi cho trình soạn thảo
Hai phút với terminal tiết kiệm một giờ đoán mò. Yêu cầu này làm những gì Cursor làm: nó gửi một yêu cầu chat completion với token bearer.
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": "Reply with the word ready."}],
"max_tokens": 20
}'
Phần thân JSON có mảng choices có nghĩa là khóa, URL và tên mô hình đều chính xác. Hãy kiểm tra các tiêu đề phản hồi. X-Balance-USD hiển thị tín dụng còn lại của bạn và X-Request-Id đáng để lưu lại nếu bạn cần theo dõi một yêu cầu.
Cùng kiểm tra đó trong Python với SDK OpenAI chính thức:
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": "Reply with the word ready."}],
max_tokens=20,
)
print(resp.choices[0].message.content)
Bạn cũng có thể liệt kê các mô hình bằng GET /v1/models. Cursor và các máy khách tương tự đôi khi gọi nó khi bạn nhấn nút xác minh, vì vậy một lệnh gọi models hoạt động là một dấu hiệu tốt. Nếu curl hoạt động và Cursor không hoạt động, vấn đề nằm ở cài đặt trình soạn thảo, và bảng lỗi bên dưới bao gồm các lỗi thường gặp.
Những gì thay đổi khi mô hình viết mã trong trình soạn thảo của bạn
Trò chuyện trong bảng bên cạnh rất rẻ. Một câu hỏi ngắn với vài trăm token ngữ cảnh tốn một phần nhỏ của một xu. Các tính năng của trình soạn thảo đính kèm tệp, kết quả tìm kiếm và lịch sử hội thoại tốn nhiều hơn vì mỗi yêu cầu đều mang theo tất cả lại. Mô hình có cửa sổ 100.000 token được chia sẻ giữa prompt và câu trả lời, và Cursor sẽ sẵn sàng điền đầy một lượng lớn cửa sổ đó nếu bạn đính kèm một thư mục lớn.
Đây là một phép tính thực tế. Giả sử một yêu cầu mang 40.000 token đầu vào và mô hình viết lại 1.500 token:
- Đầu vào: 40.000 / 1.000.000 x $0,15 = $0,006
- Đầu ra: 1.500 / 1.000.000 x $0,50 = $0,00075
- Tổng cộng: $0,00675 cho mỗi yêu cầu, vì vậy 100 yêu cầu như vậy tốn $0,675
Điều đó nằm dưới một đô la cho một buổi chiều bận rộn, nhưng phía đầu vào chiếm ưu thế, vì vậy thói quen tiết kiệm tiền là đính kèm ít tệp hơn, không phải đặt câu hỏi ngắn hơn. Hãy bắt đầu một cuộc trò chuyện mới khi chủ đề thay đổi, vì lịch sử cũ được tính phí lại ở mỗi lượt.
Gọi hàm được hỗ trợ bởi API, đây là điều mà các tính năng trình soạn thảo theo kiểu agent dựa vào. Mô hình quyết định gọi một công cụ, client của bạn chạy công cụ đó và trả về kết quả dưới dạng một thông báo role: "tool". Mô hình tốt như thế nào trong việc điều khiển một agent đa bước phụ thuộc vào mô hình, vì vậy hãy thử nó trên một tác vụ nhỏ trước khi giao cho nó một nhiệm vụ tái cấu trúc. Một mô hình trọng số mở phía sau API có nghĩa là bạn nhận được một hành vi, không phải một menu để chọn.
Các tính năng Cursor chạy trên các mô hình riêng của Cursor, chẳng hạn như tự động hoàn thành bằng Tab, thường không được chuyển đổi bởi khóa tùy chỉnh. Hãy kiểm tra tài liệu hiện tại của Cursor để xem những tính năng nào chấp nhận endpoint kiểu OpenAI tùy chỉnh, vì danh sách đó thay đổi giữa các bản phát hành.
Các lỗi phổ biến và cách khắc phục chúng
| Triệu chứng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| 404 hoặc "không tìm thấy" | URL cơ sở bao gồm đường dẫn endpoint hoặc thiếu /v1 | Sử dụng chính xác https://api.kimiapikey.com/v1 |
| 401 không được ủy quyền | Khoảng trắng hoặc ký tự xuống dòng thừa trong khóa dán, hoặc khóa cũ | Sao chép lại khóa từ bảng điều khiển và dán lại |
| Không tìm thấy mô hình | Tên mô hình được gõ khác nhau | Sử dụng uncensored, chữ thường, không có gì khác |
429 với mã concurrency | Quá nhiều yêu cầu đồng thời cho khóa của bạn | Chờ các yêu cầu đang chạy hoàn tất, hoặc sử dụng khóa đầy đủ (8 yêu cầu đồng thời) |
429 với mã rate_limited | Vượt quá hạn mức mỗi phút | Giảm tốc độ; khóa dùng thử cho phép 60 yêu cầu mỗi phút, khóa đầy đủ cho phép 300 |
429 với tiêu đề Retry-After: 5 | Quá tải tạm thời | Hãy thử lại sau năm giây |
| Nút xác minh không hoạt động, curl hoạt động | Trình soạn thảo kiểm tra với tên mô hình mà nó biết | Bỏ qua bước xác minh và gửi một tin nhắn trò chuyện thực |
Lỗi về độ đồng thời cần được lưu ý vì nó gây bất ngờ cho người dùng dùng khóa dùng thử. Gói dùng thử cho phép 2 yêu cầu đồng thời, và một agent bắt đầu nhiều hoạt động song song có thể vượt quá giới hạn đó mà bạn không cần làm gì. Một phản hồi truyền phát (streaming) cũng giữ một slot cho đến khi luồng kết thúc, vì vậy một câu trả lời dài sẽ chiếm một slot trong suốt thời gian đó. Khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút, đủ thoải mái cho một nhà phát triển.
Các yêu cầu thất bại và bị từ chối không bị tính phí, vì vậy việc thử lại sau lỗi không tốn thêm chi phí. Bạn có thể đọc các giới hạn đầy đủ trên trang tài liệu.
Thanh toán khi hết tín dụng dùng thử
Không có gói đăng ký. Bạn nạp tiền tín dụng trả trước với bất kỳ số nguyên nào từ $20 đến $500, và các yêu cầu sẽ trừ tín dụng này với giá $0,15 cho mỗi 1M token đầu vào và $0,50 cho mỗi 1M token đầu ra. Tín dụng không bao giờ hết hạn, vì vậy một tháng không lập trình sẽ không tốn gì. Các khoản nạp từ $50 trở lên có thêm ưu đãi: +5% từ $50, +10% từ $100 và +15% từ $200. Bạn có thể thanh toán bằng tiền mã hóa (USDT trên TRC20, USDC trên Base). Trang giá cả có các số liệu hiện tại ở một nơi.
Sử dụng yêu cầu 40.000 token đầu vào, 1.500 token đầu ra từ trước đó, một khoản nạp $20 sẽ bao phủ khoảng 2.960 yêu cầu như vậy ($20 / $0,00675). Hầu hết các yêu cầu trình soạn thảo đều nhỏ hơn, vì vậy con số thực tế sẽ cao hơn. Các prompt của bạn không được sử dụng để huấn luyện, điều này quan trọng khi mã bạn dán thuộc về khách hàng.
Khi bạn hoàn tất thiết lập, một nhiệm vụ đầu tiên hợp lý là một nhiệm vụ nhỏ bạn có thể xem nhanh: một bài kiểm tra đơn vị cho một hàm hiện có, một biểu thức chính quy với một bình luận dài, hoặc một bản viết lại của một tệp ồn ào. Nếu kết quả phù hợp với quy trình làm việc của bạn, hãy thêm tín dụng. Nếu không, bạn đã chi vài xu tín dụng dùng thử để tìm hiểu.
Hướng dẫn khác
- Bảng giá khóa API Kimi: Chi phí của giải pháp thay thế này
- Tích hợp khóa API Kimi với SDK OpenAI và LangChain
- Khóa API Kimi: Cách hoạt động và các giải pháp thay thế là gì
Câu hỏi thường gặp
Mô hình có giống với Kimi chính thức của Moonshot không?
Không, chúng tôi lưu trữ một mô hình trọng số mở được tinh chỉnh để không kiểm duyệt. Nó không phải là GPT, Claude, Gemini, Grok, DeepSeek hoặc bất kỳ mô hình của nhà cung cấp nào khác. Đó là một mô hình riêng biệt chạy trên máy chủ của chúng tôi.
Các bạn có huấn luyện mô hình trên dữ liệu của tôi không?
Không. Các prompt và kết quả trả về của bạn không được sử dụng để huấn luyện. Chúng tôi coi trọng quyền riêng tư và sự minh bạch, vì vậy dữ liệu của bạn vẫn thuộc về bạn.
Giới hạn tốc độ là gì?
Bạn bị giới hạn ở 300 yêu cầu mỗi phút trên mỗi khóa. Kích thước tối đa của thân yêu cầu là 8 MB. Các giới hạn này được thiết kế để đảm bảo hiệu suất ổn định cho tất cả người dùng.
Chính sách nội dung là gì?
Mô hình không kiểm duyệt đối với các chủ đề người lớn, gây tranh cãi và sáng tạo. Tuy nhiên, chúng tôi chặn nội dung tình dục liên quan đến trẻ vị thành niên. Đây là giới hạn cứng luôn được áp dụng, bất kể cấp độ đăng ký của bạn là gì.
Hỏi đáp
Tôi có thể đặt khóa Moonshot hoặc Kimi vào Cursor với URL cơ sở này không?
Không. Khóa chỉ hoạt động với endpoint của nhà cung cấp đã cấp khóa cho bạn. Sử dụng khóa từ bảng điều khiển của bạn ở đây, hoặc giữ khóa khác với URL của nhà cung cấp khác.
Tôi nhập tên mô hình nào trong Cursor?
Nhập uncensored, viết thường. Đây là ID mô hình duy nhất mà API này phục vụ, và một tên khác sẽ trả về lỗi mô hình không tìm thấy.
Nó có hoạt động với chế độ agent của Cursor không?
API hỗ trợ gọi hàm, điều mà các tính năng agent cần. Mức độ đáng tin cậy của mô hình trong việc hoàn thành các nhiệm vụ nhiều bước dài thay đổi tùy trường hợp, vì vậy hãy thử nghiệm nó trên một nhiệm vụ nhỏ trước khi thực hiện một nhiệm vụ lớn.
Tại sao tôi nhận được lỗi 429 trên khóa dùng thử?
Khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút, và tiêu đề Retry-After: 5 có nghĩa là một quá tải ngắn mà bạn có thể thử lại.
Mã của tôi có được sử dụng để huấn luyện không?
Không. Các prompt gửi đến API không được dùng để huấn luyệ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.