| OpenAI SDK 사용 |
|
| Kimi는 OpenAI-compatible API이며 OpenAI SDK를 직접 쓸 수 있다고 설명합니다. |
| 실시간 채팅 호출 | | API Overview는 이 전체 경로를 제시하고, Chat API 문서는 model과 messages 구조의 요청 예시를 보여줍니다. |
| 모델 목록 조회 | | 응답 목록에 모델별 id 필드가 포함됩니다. 이 값을 model에 넣는 것이 핵심입니다. |
| 잔액 확인 | | Kimi 문서는 Bearer 토큰으로 잔액을 확인하는 예시를 제공합니다. |
| 배치 작업 생성 | | Batch API 문서는 배치 생성 엔드포인트를 제시합니다. |
Authorization: Bearer ...base_url만 https://api.moonshot.ai/v1로 바꾸는 것이 핵심입니다. /models를 호출합니다. List Models 엔드포인트는 현재 모델 목록과 id를 반환하므로, 여기서 받은 값을 model 파라미터로 쓰는 것이 안전합니다. model과 messages로 보냅니다. Kimi의 Chat API 문서는 model과 messages를 포함한 요청 형태를 보여주고, API Overview는 /chat/completions 경로를 안내합니다. /users/me/balance, 배치 생성은 /batches 엔드포인트를 사용할 수 있습니다. 아래 예시는 Kimi 문서가 안내한 Moonshot base_url을 사용합니다.
KIMI_MODEL_ID에는 GET /modelsid를 넣어야 하며, 제품명이나 다른 서비스의 모델명을 임의로 넣지 않는 것이 좋습니다.
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 -sS https://api.moonshot.ai/v1/models -H 'Authorization: Bearer $MOONSHOT_API_KEY'응답에서 Kimi K2.6에 해당하는 id를 확인한 뒤, 그 값을 Chat Completions 요청의 model에 넣습니다. /chat/completions 전체 경로와 model + messages 요청 구조는 Kimi 문서에서 확인됩니다.
curl -sS -X POST 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을 한 문단으로 소개해 주세요."}]}'요청이 결제 문제로 실패하거나 연동 전에 계정 상태를 확인하려면 /users/me/balance를 호출하면 됩니다. Kimi의 잔액 확인 문서는 Bearer 토큰을 사용하는 예시를 제공합니다.
curl -sS https://api.moonshot.ai/v1/users/me/balance -H 'Authorization: Bearer $MOONSHOT_API_KEY'Kimi K2.6을 제공하는 중개 게이트웨이는 각자 다른 모델 ID를 쓸 수 있습니다. AIMLAPI 문서는 https://api.aimlapi.com/v1/chat/completions에서 moonshot/kimi-k2-6을 model로 쓰는 예시를 제공합니다. OpenRouter의 Kimi K2.6 API 페이지에는
moonshotai/kimi-k2.6 모델명이 표시됩니다.
이 값들은 해당 게이트웨이를 통해 호출할 때의 ID입니다. 공식 Moonshot 엔드포인트인 https://api.moonshot.ai/v1/chat/completions로 호출할 때는 GET https://api.moonshot.ai/v1/modelsid를 사용하는 것이 가장 덜 위험합니다.