| Catatan |
|---|
Authorization: Bearer ...base_url ke https://api.moonshot.ai/v1. /models lebih dulu. Endpoint List Models memang dibuat untuk menampilkan model yang tersedia dan responsnya memuat field id; nilai inilah yang sebaiknya Anda kirim sebagai parameter model. model dan messages. Dokumentasi Chat API menunjukkan pola request dengan model dan messages, sementara API overview mencantumkan endpoint /chat/completions. Contoh berikut memakai base_url resmi yang disebutkan Kimi untuk OpenAI SDK. Variabel
KIMI_MODEL_ID harus diisi dari nilai id hasil GET /models
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': 'Halo, perkenalkan diri secara singkat.'}
],
)
print(response)Langkah pertama yang paling aman adalah melihat daftar model di akun Moonshot/Kimi Anda, karena endpoint ini mengembalikan daftar model beserta field id.
curl -sS https://api.moonshot.ai/v1/models -H 'Authorization: Bearer YOUR_MOONSHOT_API_KEY'Setelah memilih id yang sesuai dari respons, kirim request ke Chat Completions. Full path /chat/completions dan struktur request model plus messages sama-sama disebutkan dalam dokumentasi Kimi.
curl -sS https://api.moonshot.ai/v1/chat/completions \
-H 'Authorization: Bearer YOUR_MOONSHOT_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "PASTE_MODEL_ID_FROM_MODELS",
"messages": [
{"role": "user", "content": "Tulis pengantar singkat tentang Kimi K2.6."}
]
}'Jika request gagal karena billing, atau Anda ingin memastikan akun siap sebelum integrasi, Kimi menyediakan endpoint balance di /users/me/balance dan contoh dokumentasinya memakai Bearer token.
curl -sS https://api.moonshot.ai/v1/users/me/balance -H 'Authorization: Bearer YOUR_MOONSHOT_API_KEY'Beberapa penyedia perantara punya model ID sendiri untuk Kimi K2.6. AIMLAPI, misalnya, memakai endpoint https://api.aimlapi.com/v1/chat/completions dengan model moonshot/kimi-k2-6. OpenRouter menampilkan model
moonshotai/kimi-k2.6 pada halaman API mereka.
ID tersebut hanya aman dipakai jika Anda memang memanggil gateway yang bersangkutan. Jika request dikirim ke endpoint resmi https://api.moonshot.ai/v1/chat/completions, cara yang paling minim risiko adalah memanggil GET https://api.moonshot.ai/v1/modelsid yang dikembalikan Moonshot untuk akun Anda.
Alur implementasi yang rapi adalah: ambil API key, setel OpenAI SDK dengan base_url https://api.moonshot.ai/v1, panggil /models untuk memverifikasi model ID Kimi K2.6, lalu kirim request ke /chat/completions dengan model dan messages. Dengan cara ini, Anda mengikuti dokumentasi OpenAI-compatible milik Kimi sekaligus menghindari kesalahan umum: menyalin model ID dari AIMLAPI atau OpenRouter ke endpoint Moonshot resmi.