API Kimi K2.7 Code cung cấp cho bạn mô hình tỷ tham số được điều chỉnh cho mã hóa của Moonshot thông qua một điểm cuối tương thích với OpenAI. Nếu bạn có thể gọi API OpenAI, bạn cũng có thể gọi API này; chỉ cần thay đổi URL cơ sở, đặt ID mô hình và bạn đã hoàn tất. Ngoài ra còn có một điểm cuối tương thích với Anthropic để nó có thể tích hợp trực tiếp vào Claude Code.
Hướng dẫn này bao gồm cả hai cách truy cập, URL cơ sở và ID mô hình chính xác, mã hoạt động trong curl, Python và Node, giá cả và cách kiểm tra toàn bộ trong Apidog trước khi bạn triển khai.
TÓM LƯỢC
- URL cơ sở:
https://api.moonshot.ai/v1(tương thích OpenAI). Đối với Claude Code, sử dụnghttps://api.moonshot.ai/anthropic. - ID mô hình:
kimi-k2.7-codetrên API Moonshot thanh toán theo token;kimi-for-codingtrên gói đăng ký Kimi Code. - Giá: 0.95 USD cho mỗi triệu token đầu vào, 4.00 USD cho mỗi triệu token đầu ra, 0.19 USD cho mỗi triệu lượt truy cập bộ nhớ đệm.
- Lấy khóa tại bảng điều khiển nền tảng Kimi, sau đó gọi nó như bất kỳ điểm cuối OpenAI nào.
- Mô hình luôn suy luận (tư duy luôn được bật), vì vậy hãy mong đợi các token suy luận trong mỗi phản hồi.
Hai cách truy cập mô hình
Chọn con đường phù hợp với cách bạn sẽ sử dụng nó.
API dành cho nhà phát triển thanh toán theo token. Thanh toán tiêu chuẩn dựa trên mức sử dụng thông qua API Moonshot. ID mô hình kimi-k2.7-code, URL cơ sở https://api.moonshot.ai/v1. Đây là lựa chọn bạn muốn cho lưu lượng truy cập sản phẩm, script và mọi thứ liên quan đến lập trình.
Gói đăng ký Kimi Code. Một gói cước cố định gắn liền với Kimi Code CLI và bảng điều khiển. Khóa từ bảng điều khiển Kimi Code sử dụng ID mô hình kimi-for-coding và thanh toán dựa trên một hạn ngạch được làm mới sau mỗi 7 ngày thay vì tính theo token. Tốt hơn cho việc mã hóa tương tác nặng, nơi chi phí theo token có thể tăng cao.
Phần còn lại của hướng dẫn này sử dụng API thanh toán theo token, vì đây là API bạn sẽ gọi từ mã của riêng mình.
Bước 1: Lấy khóa API
- Đăng nhập tại bảng điều khiển nền tảng Kimi.
- Tạo và sao chép khóa. Bạn sẽ không thấy nó nữa, vì vậy hãy lưu trữ nó trong trình quản lý bí mật hoặc biến môi trường.
- Xuất nó cục bộ:
export MOONSHOT_API_KEY="sk-your-key-here"
Hãy coi khóa như một mật khẩu. Không đưa nó vào commit, và không dán nó vào mã phía client.
Bước 2: Thực hiện yêu cầu đầu tiên của bạn
Điểm cuối này tương tự như hoàn thành cuộc trò chuyện của OpenAI, vì vậy một lệnh curl đơn giản sẽ hoạt động:
curl https://api.moonshot.ai/v1/chat/completions \
-H "Authorization: Bearer $MOONSHOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "kimi-k2.7-code",
"messages": [
{"role": "system", "content": "You are a careful senior engineer."},
{"role": "user", "content": "Write a Python function that validates an email and returns a clear error message."}
]
}'
Bạn sẽ nhận được một phản hồi tiêu chuẩn theo định dạng OpenAI: một mảng choices chứa thông báo, cùng với một đối tượng usage hiển thị số lượng token đầu vào, đầu ra và suy luận.
Bước 3: Gọi từ Python
Vì nó tương thích với OpenAI, SDK openai chính thức hoạt động bằng cách thay đổi URL cơ sở:
from openai import OpenAI
client = OpenAI(
api_key=os.environ["MOONSHOT_API_KEY"],
base_url="https://api.moonshot.ai/v1",
)
resp = client.chat.completions.create(
model="kimi-k2.7-code",
messages=[
{"role": "user", "content": "Refactor this loop for readability and explain why."},
],
)
print(resp.choices[0].message.content)
print(resp.usage)
Không cần client mới, không cần lớp HTTP tùy chỉnh. Cùng một mã giao tiếp với GPT giờ đây có thể giao tiếp với Kimi.
Bước 4: Gọi từ Node
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.MOONSHOT_API_KEY,
baseURL: "https://api.moonshot.ai/v1",
});
const resp = await client.chat.completions.create({
model: "kimi-k2.7-code",
messages: [
{ role: "user", content: "Write a Jest test for an empty-input edge case." },
],
});
console.log(resp.choices[0].message.content);
Những điều cần biết về hành vi của mô hình
Một vài đặc điểm riêng biệt định hình cách bạn gọi nó.
Suy luận luôn được bật. K2.7 Code buộc phải suy luận và duy trì nó qua các lượt. Mỗi phản hồi đều mang các token suy luận, mà bạn phải trả tiền cho chúng như đầu ra. Ưu điểm là nó suy luận hiệu quả hơn khoảng 30% so với K2.6, do đó hóa đơn sẽ nhẹ hơn so với thế hệ trước cho cùng một công việc.
Gọi công cụ hoạt động theo cách của OpenAI. Truyền một mảng tools với các lược đồ hàm và mô hình sẽ trả về các đối tượng gọi công cụ mà bạn thực thi và phản hồi lại. Nó được điều chỉnh cho việc sử dụng công cụ nhiều bước, vì vậy nó xử lý các chuỗi dài mà không bị mất dấu.
Nó đa phương thức. Bạn có thể gửi nội dung hình ảnh trong mảng messages cho các tác vụ như đọc ảnh chụp màn hình của giao diện người dùng bị lỗi hoặc một sơ đồ.
Giá cả và giới hạn tỷ lệ
Mức giá thanh toán theo token:
| Loại token | Giá mỗi triệu |
|---|---|
| Đầu vào | $0.95 |
| Đầu ra (bao gồm suy luận) | $4.00 |
| Lượt truy cập bộ đệm | $0.19 |
Hai điều giúp giảm chi phí. Lượt truy cập bộ nhớ đệm được tính với một phần nhỏ giá đầu vào, vì vậy các lời nhắc hệ thống lặp lại và ngữ cảnh chia sẻ sẽ trở nên rẻ hơn. Và ngân sách suy luận giảm có nghĩa là ít token đầu ra hơn cho mỗi tác vụ so với K2.6. Để biết thêm chiến thuật, hãy xem hướng dẫn của chúng tôi về giảm chi phí token tác nhân. Nếu bạn muốn số liệu của thế hệ cũ để so sánh, hướng dẫn API Kimi K2.6 và hướng dẫn API DeepSeek V4 của chúng tôi đề cập đến những điều đó.
Sử dụng nó trong Claude Code, Cline hoặc Cursor
Bạn không cần phải viết một client để đưa K2.7 Code vào hoạt động trong trình soạn thảo của mình.
Claude Code. Trỏ nó đến điểm cuối tương thích với Anthropic:
export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="$MOONSHOT_API_KEY"
export ANTHROPIC_MODEL="kimi-k2.7-code"
Cline và RooCode. Chọn Moonshot làm nhà cung cấp, chọn điểm cuối api.moonshot.ai, dán khóa của bạn và chọn kimi-k2.7-code làm mô hình. Tắt công cụ trình duyệt để hoạt động trơn tru nhất.
Cursor. Thêm mô hình thông qua một điểm cuối tùy chỉnh tương thích với OpenAI với cùng URL cơ sở và khóa. Thiết lập này tương tự như hướng dẫn Kimi-trong-Cursor của chúng tôi; chỉ ID mô hình thay đổi.
Kiểm tra và gỡ lỗi API trong Apidog
Trước khi bạn kết nối API vào một tác nhân, hãy xác nhận chính xác những gì nó trả về. Apidog cung cấp cho bạn một không gian làm việc trực quan để gửi yêu cầu, kiểm tra phản hồi và khóa các bài kiểm tra.
- Tạo một yêu cầu
POSTtớihttps://api.moonshot.ai/v1/chat/completions. - Thêm tiêu đề
Authorization: Bearer {{MOONSHOT_API_KEY}}, lưu trữ khóa dưới dạng biến môi trường Apidog để nó không bao giờ ở dạng văn bản thuần túy. - Gửi một nội dung theo kiểu OpenAI với
"model": "kimi-k2.7-code"vàmessagescủa bạn. - Chạy nó. Apidog định dạng JSON, hiển thị số lượng token
usagevà lưu cuộc gọi. - Biến cuộc gọi thành một bài kiểm tra: xác nhận trạng thái là
200, rằngchoices[0].message.contentkhông trống vàusage.completion_tokensnằm trong ngân sách bạn đã đặt.
Giờ đây bạn có một bài kiểm tra hồi quy mà bạn có thể chạy lại mỗi khi mô hình được cập nhật. Nếu bạn đang thực hiện các cuộc gọi công cụ của mô hình thông qua MCP, sách hướng dẫn kiểm thử máy chủ MCP của chúng tôi sẽ chỉ ra các xác nhận để phát hiện các hợp đồng công cụ bị hỏng. Tải Apidog để thiết lập.
Câu hỏi thường gặp
URL cơ sở của API là gì? https://api.moonshot.ai/v1 cho các cuộc gọi tương thích OpenAI, https://api.moonshot.ai/anthropic cho Claude Code.
Tôi sử dụng ID mô hình nào? kimi-k2.7-code trên API thanh toán theo token. Gói đăng ký Kimi Code sử dụng kimi-for-coding.
Nó có tương thích với OpenAI không? Có. Định dạng yêu cầu và phản hồi khớp với hoàn thành cuộc trò chuyện của OpenAI, vì vậy các SDK hiện có hoạt động bằng cách thay đổi URL cơ sở. Ngoài ra còn có một điểm cuối tương thích với Anthropic.
Nó có giá bao nhiêu? 0.95 USD cho mỗi triệu token đầu vào, 4.00 USD cho mỗi triệu token đầu ra và 0.19 USD cho mỗi triệu lượt truy cập bộ nhớ đệm.
Tôi luôn phải trả tiền cho các token suy luận? Có. Suy luận luôn được bật, vì vậy mỗi phản hồi bao gồm các token suy luận được tính theo tỷ lệ đầu ra. Nó vẫn sử dụng ít hơn khoảng 30% so với K2.6.
Tôi có thể gửi hình ảnh không? Có. Mô hình là đa phương thức, vì vậy nội dung hình ảnh trong mảng tin nhắn được hỗ trợ.
Tóm tắt
API Kimi K2.7 Code chỉ cách một thao tác thay đổi URL cơ sở so với bất kỳ client tương thích OpenAI nào: truy cập https://api.moonshot.ai/v1, sử dụng ID mô hình kimi-k2.7-code, và trả 0.95 USD/4.00 USD cho mỗi triệu token. Đối với mã hóa tương tác, gói đăng ký Kimi Code cố định với kimi-for-coding có thể có chi phí thấp hơn. Nó kết nối với Claude Code, Cline, RooCode và Cursor chỉ bằng một thay đổi cấu hình, và bạn có thể xác thực toàn bộ điều này trong Apidog trước khi tin cậy nó trong môi trường sản xuất. Lấy một khóa, gửi lệnh curl ở trên và kiểm tra mức sử dụng token để xem chi phí sẽ ra sao cho khối lượng công việc của bạn.