Cara memakai Kimi K2.6 lewat Moonshot API tanpa salah model ID

Endpoint yang perlu diingat

Alur aman sebelum mengirim request produksi

1. Siapkan API key Moonshot. Contoh API Kimi memakai header Authorization: Bearer ...; dokumentasi TypingMind untuk Kimi K2.6 juga menggambarkan alur membuat akun Moonshot API, mengisi balance, dan mengambil API key.
2. Setel client seperti API OpenAI. Jika memakai OpenAI SDK, bagian pentingnya adalah mengganti base_url ke https://api.moonshot.ai/v1.
3. Panggil /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.
4. Kirim request chat dengan model dan messages. Dokumentasi Chat API menunjukkan pola request dengan model dan messages, sementara API overview mencantumkan endpoint /chat/completions.
5. Cek saldo atau pakai batch bila perlu. Kimi menyediakan endpoint balance untuk mengecek akun dan endpoint batch untuk membuat batch job.

Contoh Python dengan OpenAI SDK

Contoh berikut memakai base_url resmi yang disebutkan Kimi untuk OpenAI SDK. Variabel KIMI_MODEL_ID harus diisi dari nilai id hasil GET /models, bukan dari tebakan nama produk atau salinan model ID milik gateway lain.

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)

Contoh cURL: ambil model ID, lalu panggil chat

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

Cek saldo API

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'

Jangan campur model ID Moonshot dengan gateway lain

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/models dan memakai id yang dikembalikan Moonshot untuk akun Anda.

Ringkasnya

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.