Kalau Anda sudah terbiasa dengan OpenAI SDK, integrasi Kimi K2.6 lewat API resmi Moonshot relatif lurus. Yang perlu dijaga justru bukan URL-nya, melainkan nilai model yang dikirim. Kimi Open Platform menyebut API HTTP mereka kompatibel dengan OpenAI, dapat dipanggil memakai OpenAI SDK, dan untuk SDK cukup mengubah base_url ke https://api.moonshot.ai/v1; jika HTTP langsung, path chat lengkapnya adalah https://api.moonshot.ai/v1/chat/completions. ^[13]

Masalahnya, halaman List Models sudah mengumumkan Kimi K2.6, tetapi contoh respons dokumentasinya masih menampilkan id kimi-k2.5. Jadi, untuk integrasi produksi, jangan menebak nama model. Panggil

GET /models

[17]

Endpoint yang perlu diingat

Kebutuhan	Konfigurasi atau endpoint	Catatan
Memakai OpenAI SDK	base_url = https://api.moonshot.ai/v1	Kimi menyebut API-nya OpenAI-compatible dan SDK OpenAI bisa dipakai langsung. [13]
Chat completions	POST https://api.moonshot.ai/v1/chat/completions	API overview memberi full path ini; dokumentasi Chat API memakai struktur model dan messages. [13][14]
Daftar model	GET https://api.moonshot.ai/v1/models	Endpoint ini mengembalikan daftar model; contoh respons memiliki field id. [17]
Cek saldo	GET https://api.moonshot.ai/v1/users/me/balance	Dokumentasi balance memakai header Authorization: Bearer . [15]
Batch job	POST https://api.moonshot.ai/v1/batches	Dokumentasi Batch API menyediakan endpoint untuk membuat batch. [16]

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][15][17]
2. Setel client seperti API OpenAI. Jika memakai OpenAI SDK, bagian pentingnya adalah mengganti base_url ke https://api.moonshot.ai/v1. ^[13]
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. ^[17]
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. ^[13][14]
5. Cek saldo atau pakai batch bila perlu. Kimi menyediakan endpoint balance untuk mengecek akun dan endpoint batch untuk membuat batch job. ^[15][16]

Contoh Python dengan OpenAI SDK

Contoh berikut memakai base_url resmi yang disebutkan Kimi untuk OpenAI SDK. ^[13] Variabel KIMI_MODEL_ID harus diisi dari nilai id hasil

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

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

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

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. ^[1] OpenRouter menampilkan model moonshotai/kimi-k2.6 pada halaman API mereka. ^[5]

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

[13]

[17]

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