kimiapikey.comHướng dẫn
Khóa API Kimi không hoạt động: Nguyên nhân, Khắc phục, Dự phòng
Nếu lỗi khóa API Kimi không hoạt động của bạn hiển thị dưới dạng 401, 404 hoặc 429, nguyên nhân gần như luôn là một trong năm điều sau: base URL sai, khóa không khớp, không có số dư, giới hạn tốc độ hoặc tên mô hình mà endpoint không nhận biết. Hãy xử lý chúng theo thứ tự này.
Cập nhật


Điểm chính
- Một khóa chỉ hoạt động với nhà cung cấp đã cấp nó, vì vậy base URL và khóa phải đến từ cùng một bảng điều khiển.
- 401 có nghĩa là khóa bị từ chối, 404 thường có nghĩa là đường dẫn sai, 429 có nghĩa là bạn đã chạm giới hạn hoặc dịch vụ đang bận.
- In mã trạng thái và thân phản hồi trước khi thay đổi bất cứ thứ gì khác.
- Giữ một endpoint tương thích OpenAI thứ hai được cấu hình để một lần sự cố không làm dừng ứng dụng của bạn.
Đọc mã trạng thái trước
Trước khi tạo lại bất cứ thứ gì, hãy xem máy chủ thực sự đã nói gì. Hầu hết các máy khách kiểu OpenAI đều ẩn thân phản hồi sau một ngoại lệ chung chung. Hãy in cả mã trạng thái và văn bản.
curl -i https://api.kimiapikey.com/v1/models \
-H "Authorization: Bearer $YOUR_KEY"
Dòng đầu tiên của phản hồi cho bạn biết nơi cần xem:
| Mã | Ý nghĩa thông thường | Bắt đầu với |
|---|---|---|
| 401 | Khóa bị từ chối | Sao chép khóa và URL cơ sở từ nhà cung cấp khác |
| 404 | Không tìm thấy đường dẫn hoặc mô hình | Thiếu /v1, đường dẫn bị nhân đôi, model ID sai |
| 400 | Thân yêu cầu không hợp lệ | Tên tham số, định dạng thông báo, kích thước thân |
| 429 | Đã chạm giới hạn hoặc dịch vụ bận | Tốc độ yêu cầu, lệnh gọi song song, thời gian thử lại |
| 5xx | Vấn đề phía máy chủ | Thử lại với backoff, sau đó chuyển sang phương án dự phòng |
Nếu bạn không nhận được phản hồi HTTP nào cả (thời gian chờ hoặc lỗi DNS), vấn đề nằm ở mạng hoặc tên máy chủ bạn đã nhập, không phải khóa.
Base URL và khóa phải thuộc về nhau
Đây là lý do phổ biến nhất khiến khóa mới không hoạt động. Khóa được cấp theo nhà cung cấp. Khóa từ bảng điều khiển này sẽ không được nhận diện bởi máy chủ của nhà cung cấp khác, nên nó trả về 401 dù khóa đó hoàn toàn hợp lệ tại nơi nó được tạo ra.
Kiểm tra các điểm sau:
- Khóa và base URL đến từ cùng một trang tài khoản. Nếu bạn đã sao chép khóa từ một nhà cung cấp khác và giữ nguyên base URL cũ trong cấu hình của mình, yêu cầu sẽ được gửi đến sai nơi.
- Biến môi trường không che đi mã của bạn. SDK OpenAI đọc
OPENAI_API_KEYvàOPENAI_BASE_URLkhi bạn không truyền chúng một cách rõ ràng, vì vậy một biến shell cũ có thể ghi đè những gì bạn đã viết trong tệp. - Không có khoảng trắng hoặc ký tự xuống dòng ở cuối khóa. Ký tự xuống dòng thừa từ sao chép và dán là nguyên nhân kinh điển gây ra lỗi 401.
- Tiêu đề phải chính xác là
Authorization: Bearer <key>. Một số công cụ mong đợi khóa trong một tiêu đề khác và cần bật chế độ tương thích OpenAI.
Trình chỉnh sửa và giao diện chat thêm một cạm bẫy nữa. Nhiều trong số chúng giữ một trường riêng biệt cho "base URL OpenAI" và một công tắc riêng để bật nó. Nếu công tắc tắt, ứng dụng sẽ lặng lẽ tiếp tục gọi máy chủ mặc định với khóa mới của bạn, và bạn nhận được lỗi 401 trông giống như khóa không hợp lệ. Hãy lưu cài đặt, khởi động lại ứng dụng nếu nó lưu trữ chúng, và gửi một tin nhắn kiểm tra ngắn trước khi kiểm tra bất cứ thứ gì phức tạp.
Base URL nên kết thúc ở /v1, không phải ở máy chủ và không phải ở /v1/chat/completions. SDK sẽ tự động thêm phần còn lại. Một URL đã bao gồm đầy đủ đường dẫn sẽ dẫn đến đường dẫn bị nhân đôi và lỗi 404.
Truy cập khu vực, proxy và mạng doanh nghiệp
Đôi khi khóa ổn và yêu cầu không bao giờ đến đúng máy chủ. Khả năng sẵn có của nhà cung cấp có thể phụ thuộc vào nơi bạn kết nối, và VPN, proxy doanh nghiệp hoặc quy tắc tường lửa có thể chặn hoặc ghi lại lưu lượng truy cập. Hãy xem tài liệu hoặc trang trạng thái chính thức của nhà cung cấp để biết các khu vực được hỗ trợ, và đừng giả định rằng các quy tắc giống nhau với một dịch vụ khác.
Một bài kiểm tra cô lập nhanh: chạy cùng lệnh curl từ một mạng khác, chẳng hạn như điểm phát sóng điện thoại. Nếu nó hoạt động ở đó, khóa là tốt và mạng của bạn là nguyên nhân. Nếu proxy đặt HTTPS_PROXY, hãy kiểm tra xem thư viện HTTP của bạn có thực sự tôn trọng nó không; một số công cụ bỏ qua nó và thất bại với lỗi kết nối.
Số dư, hạn ngạch và giới hạn tốc độ trông như thế nào
Một khóa có thể hợp lệ nhưng vẫn từ chối yêu cầu vì tài khoản không còn tín dụng hoặc hạn ngạch đã hết. Hãy kiểm tra bảng điều khiển trước khi gỡ lỗi mã. Nếu bạn chưa bao giờ nạp tiền, hãy nhớ rằng các khoản cho phép miễn phí thường nhỏ và có thời hạn ngắn.
Lỗi 429 là một trường hợp khác. Nó có nghĩa là máy chủ đang làm chậm bạn lại, không phải khóa không tốt. Trên endpoint được mô tả trên trang web này, 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à 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. Khi bạn vượt quá chúng, API trả về HTTP 429 với mã lỗi rate_limited (quá nhiều yêu cầu mỗi phút) hoặc concurrency (quá nhiều yêu cầu cùng lúc). Quá tải tạm thời cũng trả về 429, với tiêu đề Retry-After: 5.
Hai thói quen này khắc phục hầu hết các vấn đề này. Hãy tôn trọng Retry-After khi nó có mặt, và giới hạn số worker song song của bạn ở giới hạn độ đồng thời. Một yêu cầu truyền phát giữ vị trí của nó cho đến khi luồng kết thúc, vì vậy một luồng bị đình trệ sẽ tính vào hạn mức của bạn lâu hơn bạn mong đợi.
Tên mô hình, tham số và kích thước thân
Lỗi 404 hoặc 400 với khóa hợp lệ thường chỉ vào chính yêu cầu. Ba điều cần kiểm tra:
- ID mô hình. Mỗi nhà cung cấp đều có tên mô hình riêng. Hãy hỏi endpoint xem nó cung cấp gì bằng cách
GET /v1/modelsvà sao chép ID từ phản hồi. Trên trang web này, ID làuncensored. - Tham số. Các tên như
max_tokens,temperaturevàresponse_formatlà tiêu chuẩn, nhưng một nhà cung cấp có thể chỉ chấp nhận một tập hợp con. Hãy xóa các trường tùy chọn cho đến khi yêu cầu thành công, sau đó thêm chúng lại từng cái một. - Kích thước. Các prompt rất lớn có thể vượt giới hạn của thân yêu cầu trước khi mô hình xử lý. Tại đây, thân tối đa là 8 MB và cửa sổ ngữ cảnh là 100.000 token cho cả prompt và kết quả.
Truyền phát là một nơi khác mà một khóa hoạt động trông giống như bị hỏng. Nếu một yêu cầu thành công mà không có stream: true và thất bại khi có nó, nguyên nhân thường là proxy đệm hoặc cắt các sự kiện được gửi bởi máy chủ, không phải endpoint. Hãy tắt truyền phát để xác nhận, sau đó xem xét cài đặt proxy.
Nếu bạn chỉ thay đổi tên mô hình và lệnh gọi bị lỗi, hãy đặt lại tên cũ để xác nhận rằng phần còn lại trong thiết lập của bạn là ổn.
Chuẩn bị một endpoint dự phòng
Ngay cả một nhà cung cấp ổn định cũng có giờ kém ổn định. Nếu sản phẩm của bạn phụ thuộc vào một khóa duy nhất, một lỗi đơn lẻ sẽ trở thành thời gian ngừng hoạt động của bạn. Vì định dạng yêu cầu OpenAI được chia sẻ, bạn có thể giữ một endpoint thứ hai đã được cấu hình và chuyển đổi chỉ với vài dòng mã.
Endpoint tại trang web này tương thích OpenAI, vì vậy nó có thể được tích hợp như một nhà cung cấp thứ hai. Đây là một mô hình trọng số mở được lưu trữ độc lập, không phải dịch vụ chính thức của Moonshot, và nó sẽ trả lời khác với mô hình Kimi, vì vậy hãy kiểm tra các prompt của bạn trước khi dựa vào nó. Đây là một trình bao bọc nhỏ thử nhà cung cấp chính trước và chuyển sang dự phòng khi có lỗi:
import os
from openai import OpenAI
primary = OpenAI(base_url=os.environ["PRIMARY_BASE_URL"],
api_key=os.environ["PRIMARY_KEY"])
fallback = OpenAI(base_url="https://api.kimiapikey.com/v1",
api_key=os.environ["FALLBACK_KEY"])
def ask(messages):
try:
r = primary.chat.completions.create(
model=os.environ["PRIMARY_MODEL"], messages=messages, timeout=30)
except Exception as e:
print("primary failed:", e)
r = fallback.chat.completions.create(
model="uncensored", messages=messages, timeout=60)
return r.choices[0].message.content
print(ask([{"role": "user", "content": "Say hi in five words."}]))
Giá cả theo mức sử dụng: $0,15 cho mỗi 1 triệu token đầu vào và $0,50 cho mỗi 1 triệu token đầu ra từ tín dụng trả trước không bao giờ hết hạn. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí, nên một giải pháp dự phòng hiếm khi chạy sẽ tốn rất ít chi phí để duy trì. Nạp tiền bắt đầu từ $20; xem giá cả để biết các mức ưu đãi.
Kiểm tra phương án dự phòng trong hai phút
Người dùng mới có thể nhận $0,50 tín dụng dùng thử miễn phí chỉ với một cú nhấp chuột trên trang khóa API sau khi đăng ký. Bạn không cần cung cấp thẻ và tín dụng này có hiệu lực trong 7 ngày, đủ để bạn chạy các prompt thực tế qua endpoint một lần. Sau đó, hãy chạy bài kiểm tra smoke bên dưới.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $FALLBACK_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'
Kiểm tra tiêu đề phản hồi X-Balance-USD để xem số tín dụng còn lại của bạn. Tài liệu tham khảo đầy đủ về yêu cầu có trong tài liệu. Nếu bạn đang tích hợp tính năng này vào trình soạn thảo, hướng dẫn hiện có về cách sử dụng khóa API kiểu Kimi trong Cursor cho biết vị trí của trường URL cơ sở, còn tổng quan về khóa API Kimi giải thích mối quan hệ giữa endpoint này với mô hình bạn đang sử dụng.
Hướng dẫn khác
- Base URL API Moonshot: Định hướng mã của bạn sang nơi khác
- Sử dụng khóa API kiểu Kimi trong Cursor: Hướng dẫn thiết lập
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.
Bạn có huấn luyện 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 sao khóa mới của tôi trả về 401 ngay lập tức?
Các lý do phổ biến nhất là khóa được gửi đến base URL của nhà cung cấp khác, khoảng trắng hoặc ký tự xuống dòng thừa trong khóa đã sao chép, hoặc biến môi trường ghi đè mã của bạn. Hãy thử với curl để loại trừ SDK của bạn.
429 có giống với khóa không hợp lệ không?
Không. Mã 429 có nghĩa là bạn đã vượt quá giới hạn tốc độ, giới hạn số lượng yêu cầu đồng thời hoặc gặp quá tải tạm thời. Khóa của bạn vẫn hợp lệ. Hãy đợi giá trị Retry-After và giảm số lượng yêu cầu song song của bạn.
Các yêu cầu thất bại có tốn tiền ở đây không?
Không. Các yêu cầu thất bại hoặc bị từ chối không được tính phí trên endpoint này, vì vậy việc thử lại một lệnh gọi bị lỗi sẽ không làm cạn kiệt tín dụng của bạn.
Tôi có thể dùng endpoint này làm thay thế trực tiếp cho mô hình Kimi không?
Nó sử dụng cùng định dạng yêu cầu OpenAI, vì vậy thay đổi mã chỉ là base URL, khóa và model ID uncensored. Mô hình nền tảng khác nhau nên phản hồi sẽ không khớp; hãy kiểm tra các prompt của bạn trước.
Khóa của bạn chỉ cần điền một biểu mẫu
Tạo tài khoản, sao chép khóa, thay đổi base URL. Đó là toàn bộ thiết lập.