अगर आप Kimi K2.6 को Moonshot के official API से जोड़ रहे हैं, तो पहली बात साफ रखें: endpoint लगभग OpenAI जैसा है, असली फिसलन model value में आती है। Kimi Open Platform कहता है कि उसके HTTP API OpenAI-compatible हैं, OpenAI SDK सीधे इस्तेमाल किया जा सकता है, SDK में base_url को https://api.moonshot.ai/v1 रखना होता है; direct HTTP call में chat का full endpoint https://api.moonshot.ai/v1/chat/completions है। ^[13]

सावधानी यह है कि List Models पेज Kimi K2.6 release होने की सूचना देता है, लेकिन उसी documentation के sample response में id अभी kimi-k2.5 दिखता है। इसलिए नाम देखकर model ID न गढ़ें—अपने Moonshot account में

GET /models

[17]

कौन सा Moonshot endpoint इस्तेमाल करें?

जरूरत	configuration या endpoint	नोट
OpenAI SDK से call	base_url = https://api.moonshot.ai/v1	Kimi अपने API को OpenAI-compatible बताता है और OpenAI SDK सीधे इस्तेमाल करने देता है। [13]
Realtime chat	POST https://api.moonshot.ai/v1/chat/completions	API overview में यही full path दिया गया है; Chat API request में model और messages structure दिखता है। [13][14]
Model list देखना	GET https://api.moonshot.ai/v1/models	यह endpoint available models की सूची देता है और response में id field होती है। [17]
Balance check	GET https://api.moonshot.ai/v1/users/me/balance	Kimi के balance docs में Bearer token header के साथ यही endpoint है। [15]
Batch job बनाना	POST https://api.moonshot.ai/v1/batches	Batch API में batch create करने के लिए यह endpoint दिया गया है। [16]

सुरक्षित workflow

1. Moonshot API key तैयार करें। Kimi के API examples में

   Authorization: Bearer ...

   header इस्तेमाल होता है; TypingMind की integration docs भी Moonshot API account बनाकर balance जोड़ने और API key लेने का flow बताती हैं। ^[2][15][17]
2. Client को OpenAI-compatible mode में set करें। OpenAI SDK इस्तेमाल कर रहे हैं तो मुख्य बदलाव base_url को https://api.moonshot.ai/v1 करना है। ^[13]
3. पहले /models call करें। List Models endpoint current models की सूची और उनका id लौटाता है; यही value model parameter में जानी चाहिए। ^[17]
4. Chat request भेजें। Chat API request structure में model और messages आते हैं, और API overview /chat/completions full path बताता है। ^[13][14]
5. Billing या scale की जरूरत हो तो extra endpoint देखें। Balance के लिए /users/me/balance और batch processing के लिए /batches endpoint उपलब्ध हैं। ^[15][16]

Python example: OpenAI SDK के साथ

नीचे example में वही base_url है जो Kimi ने OpenAI SDK के लिए बताया है। ^[13] ध्यान रखें: KIMI_MODEL_ID में वही id रखें जो आपके account में

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': 'नमस्ते, अपना संक्षिप्त परिचय दें।'}
    ],
)

print(response)

cURL example: पहले model ID लें, फिर chat call करें

सबसे पहले अपने Moonshot/Kimi account में model list देखें, क्योंकि इसी response में model का id मिलता है। ^[17]

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

अब response से सही id चुनकर Chat Completions endpoint पर request भेजें। Full path /chat/completions और request का model + messages format Kimi docs में बताया गया है। ^[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":"Kimi K2.6 पर छोटा परिचय लिखें।"}]}'

API balance कैसे check करें

अगर request billing की वजह से fail हो रही है, या integration शुरू करने से पहले account status देखना है, तो Kimi का balance endpoint /users/me/balance इस्तेमाल करें। Documentation में इसे Bearer token के साथ दिखाया गया है। ^[15]

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

Gateway-specific model ID को Moonshot पर मत मिलाएँ

कुछ intermediary providers Kimi K2.6 के लिए अपना अलग model ID देते हैं। AIMLAPI अपने endpoint https://api.aimlapi.com/v1/chat/completions के साथ model moonshot/kimi-k2-6 दिखाता है। ^[1] OpenRouter अपने API पेज पर moonshotai/kimi-k2.6 model दिखाता है। ^[5]

ये ID उन्हीं gateways के लिए हैं। अगर आप official Moonshot endpoint https://api.moonshot.ai/v1/chat/completions call कर रहे हैं, तो सबसे कम risk वाला तरीका है:

GET https://api.moonshot.ai/v1/models

[13]

[17]

निचोड़

Kimi K2.6 को Moonshot API से जोड़ने का साफ रास्ता है: API key लें, OpenAI SDK में base_url को https://api.moonshot.ai/v1 set करें, /models से actual model ID verify करें, और फिर /chat/completions पर model और messages के साथ request भेजें। इससे documentation के OpenAI-compatible flow का पालन होता है और AIMLAPI या OpenRouter जैसे gateways के model ID को official Moonshot endpoint पर गलती से इस्तेमाल करने का जोखिम घटता है। ^{[1][5][13][14][17]}