Với Kimi K2.6, lỗi dễ gặp nhất không phải là URL gọi API mà là nhầm model giữa Moonshot và các nhà cung cấp trung gian. Kimi Open Platform cho biết API HTTP của họ tương thích OpenAI, có thể dùng OpenAI SDK trực tiếp, và khi dùng SDK cần đặt base_url là https://api.moonshot.ai/v1; nếu gọi HTTP trực tiếp, endpoint chat đầy đủ là https://api.moonshot.ai/v1/chat/completions. ^[13]

Điểm cần thận trọng: trang List Models thông báo Kimi K2.6 đã được phát hành, nhưng mẫu phản hồi được cung cấp trong tài liệu vẫn minh họa id là kimi-k2.5. Vì vậy, cách an toàn là gọi

GET /models

[17]

Endpoint Moonshot cần dùng

Nhu cầu	Cấu hình hoặc endpoint	Ghi chú
Dùng OpenAI SDK	base_url = https://api.moonshot.ai/v1	Kimi mô tả API là OpenAI-compatible và cho phép dùng OpenAI SDK trực tiếp. [13]
Gọi chat realtime	POST https://api.moonshot.ai/v1/chat/completions	API overview nêu full path này; tài liệu Chat API dùng request theo kiểu model và messages. [13][14]
Liệt kê model	GET https://api.moonshot.ai/v1/models	Endpoint trả danh sách model và mẫu phản hồi có trường id. [17]
Kiểm tra số dư	GET https://api.moonshot.ai/v1/users/me/balance	Tài liệu Check Balance dùng header Authorization: Bearer . [15]
Tạo batch	POST https://api.moonshot.ai/v1/batches	Tài liệu Batch API có endpoint tạo batch. [16]

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][15][17]
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. ^[13]
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. ^[17]
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. ^[13][14]
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. ^[15][16]

Ví dụ Python với OpenAI SDK

Đoạn dưới dùng đúng base_url do Kimi công bố cho OpenAI SDK. ^[13] Biến KIMI_MODEL_ID phải là id lấy từ

GET /models

[17]

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. ^[17]

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. ^[13][14]

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. ^[15]

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. ^[1] OpenRouter hiển thị model moonshotai/kimi-k2.6 trên trang API của họ. ^[5]

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

[13]

[17]

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. ^{[1][5][13][14][17]}