VI ▾
Lấy khóa API

kimiapikey.comHướng dẫn

URL cơ sở API Moonshot: Định hướng mã của bạn sang nơi khác

URL cơ sở API moonshot chỉ là một chuỗi trong client kiểu OpenAI của bạn, và việc thay đổi nó là cách bạn cấu hình để cùng một mã nguồn nhắm đến một nhà cung cấp khác. Trang này chỉ ra vị trí của chuỗi đó trong Python, Node, curl và các công cụ phổ biến, cùng cách trỏ nó đến một endpoint thay thế.

Cập nhật

Một cáp được di chuyển giữa hai ổ trên bảng chuyển mạch, minh họa việc thay đổi URL cơ sở API
Minh họa đẳng hướng của một trình soạn thảo mã được nối bằng cáp phát sáng với máy chủ API

Điểm chính

  • URL cơ sở là một cài đặt đơn lẻ; thân yêu cầu vẫn giữ định dạng chat OpenAI.
  • Thay đổi ba thứ khi chuyển đổi: URL cơ sở, khóa API, ID mô hình.
  • Endpoint của chúng tôi là https://api.kimiapikey.com/v1 và ID mô hình là uncensored.
  • Đây là một mô hình được lưu trữ độc lập, không phải dịch vụ chính thức của Moonshot, vì vậy hãy kiểm tra lại các prompt của bạn.

URL cơ sở thực sự hoạt động như thế nào

Các client tương thích OpenAI xây dựng mọi yêu cầu từ hai phần: URL cơ sở và đường dẫn. SDK nối chúng lại, nên một lệnh gọi chat.completions.create trở thành một lệnh POST đến <base_url>/chat/completions. Các nhà cung cấp tuân theo định dạng này, bao gồm Moonshot, đều công bố URL cơ sở riêng trong tài liệu của họ. Hãy tra cứu tại đó thay vì sao chép từ một bài đăng trên diễn đàn, vì đó là giá trị duy nhất bạn không thể đoán được.

Do đó, việc chuyển đổi nhà cung cấp chỉ cần ba chỉnh sửa và không gì khác:

  1. URL cơ sở, quyết định nơi yêu cầu được gửi đến.
  2. Khóa API, được cấp cho từng nhà cung cấp và chỉ hoạt động trên máy chủ của nhà cung cấp đó.
  3. ID mô hình, vì mỗi nhà cung cấp đặt tên cho các mô hình của họ khác nhau.

Tin nhắn, vai trò, truyền phát, công cụ và chế độ JSON giữ nguyên cấu trúc, đó là lý do bản di chuyển diễn ra nhanh chóng. Bất kỳ thứ gì phụ thuộc vào tính năng cụ thể của nhà cung cấp, như công cụ tìm kiếm web tích hợp, sẽ cần xử lý riêng.

Bạn cũng nên giữ ba giá trị này cùng nhau trong một khối cấu hình hoặc một tệp môi trường cho mỗi nhà cung cấp. Khi base URL, khóa và model ID nằm cạnh nhau, việc chuyển lại chỉ là một dòng thay đổi, và bạn tránh được trạng thái chuyển đổi dang dở nơi khóa mới được ghép với base URL cũ.

Python: gói openai

Trong Python, bạn đặt URL cơ sở khi tạo client. Ví dụ này kết nối với endpoint trên trang web này:

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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)

Nếu bạn muốn giữ mã không chứa cài đặt, hãy sử dụng biến môi trường. SDK đọc OPENAI_BASE_URL và OPENAI_API_KEY khi bạn gọi OpenAI() không truyền đối số, nên một bản triển khai có thể chuyển đổi nhà cung cấp mà không cần thay đổi mã. Hãy lưu ý rằng điều này cũng có nghĩa là một biến còn sót lại trong shell của bạn có thể ghi đè giá trị bạn đã viết trong tệp.

Node và curl

Gói JavaScript chính thức sử dụng cùng tên tùy chọn, viết bằng camel case:

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: "Hello" }],
  stream: false,
});
console.log(resp.choices[0].message.content);

Không có SDK, URL cơ sở chỉ là phần đầu của địa chỉ:

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":"Hello"}]}'

Endpoint tương tự cũng chấp nhận POST /v1/responses, và GET /v1/models liệt kê những gì nó cung cấp. Xác thực là một token bearer trong tiêu đề Authorization trong mọi trường hợp.

Trình soạn thảo và giao diện chat

Các công cụ GUI hiển thị URL cơ sở dưới các nhãn khác nhau: "API base", "Override OpenAI Base URL", "Custom endpoint" hoặc "Provider URL". Giá trị bạn dán là cùng chuỗi như trong mã ở trên, kết thúc ở /v1. Không dán đầy đủ địa chỉ /chat/completions trừ khi công cụ yêu cầu URL đầy đủ.

Sau khi lưu, hãy thêm ID mô hình bằng tay nếu công cụ không tự lấy danh sách. Một số trình soạn thảo xác thực khóa với một nhà cung cấp cố định và từ chối các giá trị tùy chỉnh, trong trường hợp đó hãy tìm cài đặt bật chế độ tùy chỉnh hoặc tương thích OpenAI trước. Bài viết về cách sử dụng khóa API kiểu Kimi trong Cursor hướng dẫn chi tiết về một công cụ như vậy.

Những gì thay đổi khi bạn chuyển đổi nhà cung cấp

Một định dạng phù hợp không có nghĩa là hành vi phù hợp. Trước khi chuyển lưu lượng sản xuất, hãy kiểm tra các điểm sau từng cái một:

  • Phong cách đầu ra. Một mô hình khác sẽ viết khác đi. Hãy chạy các prompt thực tế của bạn, không phải ví dụ minh họa.
  • Cỡ ngữ cảnh. Endpoint ở đây có cửa sổ 100.000 token cho prompt cộng với completion. Nếu thiết lập hiện tại của bạn gửi các prompt dài hơn, hãy cắt ngắn chúng trước.
  • Giới hạn. Khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 mỗi phút. Vượt quá bất kỳ giới hạn nào, bạn sẽ nhận được HTTP 429, với rate_limited hoặc concurrency làm mã.
  • Tính năng. Truyền phát qua SSE, gọi công cụ và chế độ JSON được hỗ trợ. Tạo hình ảnh, âm thanh và video, embedding và fine-tuning không được hỗ trợ; đây là API chỉ dành cho văn bản.
  • Đặt tên. Dịch vụ chạy một mô hình trọng số mở được chọn để trả lời mà không từ chối nội dung cho việc sử dụng hợp pháp của người trưởng thành. Nó không phải là API chính thức của Moonshot và không phải là bộ định tuyến giữa các nhà cung cấp.

Một cách trung lập để so sánh là ghi lại cùng mười prompt thông qua cả hai endpoint và đọc câu trả lời cạnh nhau. Việc đó mất vài phút và tiết kiệm công đoán mò.

Lỗi URL cơ sở và biểu hiện của chúng

Hầu hết các lỗi sau khi chuyển đổi đến từ địa chỉ, không phải khóa. Dưới đây là cách mỗi lỗi xuất hiện và cách sửa chữa nó.

LỗiTriệu chứngCách khắc phục
Chỉ host, không có /v1Lỗi 404 trên mọi lệnh gọiThêm /v1 vào cuối
Đường dẫn đầy đủ bị dán vàoLỗi 404 với đường dẫn bị lặp trong thông báo lỗiCắt địa chỉ trở lại /v1
Dấu gạch chéo cuối cùng cộng với nối đường dẫn thủ côngDấu gạch chéo kép trong URLĐể SDK nối đường dẫn
Khóa cũ, URL mới401Sử dụng khóa do nhà cung cấp mới cấp
URL cũ, khóa mớiLỗi 401 từ nhà cung cấp cũTìm kiếm repo và shell để tìm địa chỉ cũ
http:// thay vì https://Lỗi chuyển hướng hoặc kết nốiSử dụng https ở mọi nơi

Một cách nhanh để tìm các giá trị còn sót lại là tìm kiếm dự án và cài đặt triển khai của bạn theo tên máy chủ cũ. Hãy tìm trong các tệp .env, biến CI, tệp Docker compose và bất kỳ cài đặt trình soạn thảo nào, vì một bản sao bị lãng quên là đủ để gửi một số lưu lượng đến nhà cung cấp cũ.

Truyền phát và công cụ sau khi chuyển đổi

Đặt stream: true và phản hồi sẽ đến dưới dạng các sự kiện do máy chủ gửi (SSE), với việc báo cáo việc sử dụng token ở cuối. Gọi công cụ sử dụng các trường tools và tool_choice thông thường, truyền phát tool_calls và kết quả được gửi lại dưới dạng tin nhắn với role: "tool". Nếu mã của bạn đã xử lý những điều này cho nhà cung cấp cũ, nó sẽ tiếp tục hoạt động; hãy xác nhận bằng cách chạy một lệnh gọi stream và một lệnh gọi tool trước khi chuyển đổi hoàn toàn. Hãy nhớ rằng một yêu cầu stream giữ slot đồng thời của nó cho đến khi stream kết thúc.

Kiểm tra chi phí trước khi chuyển đổi

Chi phí ở đây tính theo token: $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 có gói đăng ký. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí, và tín dụng không hết hạn. Đối với mức giá của nhà cung cấp khác, hãy kiểm tra trang giá hiện tại của họ, vì những mức giá đó có thể thay đổi.

Một ví dụ cụ thể. Giả sử một yêu cầu có 2.000 token đầu vào và 500 token đầu ra:

  • Đầu vào: 2.000 / 1.000.000 x $0,15 = $0,0003
  • Đầu ra: 500 / 1.000.000 x $0,50 = $0,00025
  • Tổng cộng: $0,00055 cho mỗi yêu cầu, vậy 1.000 yêu cầu tốn $0,55

Số tiền nạp tối thiểu là $20, và các khoản lớn hơn sẽ được cộng thêm bonus: +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). Chi tiết đầy đủ có trên trang giá cả, và bảng giá chi tiết tập trung vào Kimi có trong giá khóa API Kimi.

Lấy khóa và thực hiện cuộc gọi đầu tiên

Đăng ký bằng Google hoặc bằng email và mật khẩu, sau đó mở trang khóa API. Người dùng mới có thể nhận $0,50 tín dụng dùng thử chỉ với một cú nhấp chuột, mỗi người một lần, có hiệu lực trong 7 ngày và không cần thẻ. Khóa dùng thử giới hạn ở 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút, đủ cho một lần chạy thử.

Dán khóa vào đoạn mã Python ở trên, chạy nó và xác nhận bạn nhận lại văn bản. tài liệu liệt kê mọi tham số, và các tiêu đề phản hồi X-Request-Id và X-Balance-USD hỗ trợ gỡ lỗi và theo dõi số dư. Các prompt gửi đến dịch vụ không được dùng để huấn luyện.

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à completion 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 người chưa 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ì.

Câu hỏi và câu trả lời

Tôi có cần thay đổi mã của mình khi thay đổi base URL không?

Thường chỉ có ba giá trị: base URL, khóa API và model ID. Định dạng tin nhắn, streaming và gọi hàm vẫn giữ nguyên miễn là nhà cung cấp mới hỗ trợ chúng.

Base URL có nên kết thúc bằng /v1 không?

Đúng cho endpoint này: https://api.kimiapikey.com/v1. SDK tự thêm /chat/completions, vì vậy không bao gồm nó.

Đây có phải là API chính thức của Moonshot không?

Không. Đây là một mô hình trọng số mở được lưu trữ độc lập thông qua API tương thích OpenAI. Nó không phải là dịch vụ của Moonshot và không phải là bộ định tuyến giữa các nhà cung cấp.

Tôi tìm model ID ở đâu?

Gọi GET /v1/models với khóa của bạn. Trên endpoint này, model ID là uncensored.

Khóa của bạn chỉ cách một bước

Tạo tài khoản, sao chép khóa, thay đổi URL cơ sở. Đó là toàn bộ thiết lập.

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