Cách dùng Kimi K2.6 qua Moonshot API mà không nhầm model ID

Quy trình an toàn để gọi Kimi K2.6

1. Chuẩn bị API key Moonshot. Các ví dụ API của Kimi dùng xác thực bằng header Authorization: Bearer ...; tài liệu tích hợp của TypingMind cũng mô tả luồng tạo tài khoản Moonshot API, nạp balance và lấy API key.
2. Cấu hình client theo chuẩn OpenAI-compatible. Nếu dùng OpenAI SDK, điểm quan trọng là đổi base_url sang https://api.moonshot.ai/v1.
3. Gọi /models trước khi gửi request thật. Endpoint List Models được thiết kế để liệt kê các model hiện có và mẫu phản hồi có trường id; đây là giá trị nên truyền vào tham số model.
4. Gửi request chat với model và messages. Tài liệu Chat API thể hiện request theo cấu trúc có model và messages, còn API overview nêu endpoint /chat/completions.
5. Kiểm tra số dư hoặc dùng batch khi cần. Kimi có endpoint balance để kiểm tra tài khoản và endpoint batch để tạo batch job.

Ví dụ Python với OpenAI SDK

Đoạn dưới dùng đúng base_url do Kimi công bố cho OpenAI SDK. Biến KIMI_MODEL_ID phải là id lấy từ GET /models, không phải model ID đoán từ tên sản phẩm hoặc copy từ gateway khác.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.ai/v1",
)

response = client.chat.completions.create(
    model=os.environ["KIMI_MODEL_ID"],
    messages=[
        {"role": "user", "content": "Xin chào, hãy tự giới thiệu ngắn gọn."}
    ],
)

print(response)

Ví dụ cURL: lấy model ID rồi gọi chat

Bước đầu tiên nên là liệt kê model trong tài khoản Moonshot/Kimi của bạn, vì endpoint này trả danh sách model cùng trường id.

curl -sS https://api.moonshot.ai/v1/models \
  -H "Authorization: Bearer $MOONSHOT_API_KEY"

Sau khi chọn đúng id từ phản hồi, gửi request tới Chat Completions. Full path /chat/completions và cấu trúc request model + messages đều được mô tả trong tài liệu Kimi.

curl -sS https://api.moonshot.ai/v1/chat/completions \
  -H "Authorization: Bearer $MOONSHOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "PASTE_MODEL_ID_FROM_MODELS",
    "messages": [
      {"role": "user", "content": "Viết một đoạn giới thiệu ngắn về Kimi K2.6."}
    ]
  }'

Kiểm tra số dư API

Nếu request lỗi do billing hoặc bạn muốn kiểm tra tài khoản trước khi tích hợp, Kimi có endpoint balance tại /users/me/balance và ví dụ tài liệu dùng Bearer token.

curl -sS https://api.moonshot.ai/v1/users/me/balance \
  -H "Authorization: Bearer $MOONSHOT_API_KEY"

Đừng trộn model ID giữa Moonshot và gateway trung gian

Một số nhà cung cấp trung gian đặt model ID riêng cho Kimi K2.6. AIMLAPI dùng endpoint https://api.aimlapi.com/v1/chat/completions với model moonshot/kimi-k2-6. OpenRouter hiển thị model moonshotai/kimi-k2.6 trên trang API của họ.

Các ID đó chỉ nên dùng khi bạn gọi qua đúng gateway tương ứng. Khi gọi endpoint chính thức https://api.moonshot.ai/v1/chat/completions, cách ít rủi ro nhất là gọi GET https://api.moonshot.ai/v1/models và dùng đúng id mà Moonshot trả về cho tài khoản của bạn.

Kết luận

Luồng triển khai gọn nhất là: lấy API key, đặt OpenAI SDK base_url thành https://api.moonshot.ai/v1, gọi /models để xác minh model ID Kimi K2.6, rồi gửi request tới /chat/completions với model và messages. Cách này bám sát tài liệu OpenAI-compatible của Kimi và tránh lỗi phổ biến là copy model ID của AIMLAPI hoặc OpenRouter sang endpoint Moonshot chính thức.