API 시작 가이드
등록 과정은 단 몇 분이면 충분합니다. 공식 플랫폼인 platform.moonshot.ai에 방문하여 이메일 인증으로 계정을 생성한 뒤 API 키 섹션으로 이동하면 됩니다. 플랫폼에서는 일반적인 통합 패턴을 다루는 코드 예제와 함께 상세한 문서를 제공하고 있습니다.
- platform.moonshot.ai 사이트에 접속하여 이메일 주소로 회원 가입을 진행합니다.
- 개발자 대시보드의 API 키 관리 섹션으로 이동합니다.
- 첫 번째 API 키를 생성하고 보안을 위해 안전한 곳에 별도로 저장합니다.
- OpenAI Python SDK를 설치하거나 cURL 명령어를 사용하여 요청을 전송합니다.
from openai import OpenAI
client = OpenAI(
api_key="your_moonshot_api_key",
base_url="https://api.moonshot.cn/v1"
)
response = client.chat.completions.create(
model="kimi-k2.5",
messages=[
{"role": "system", "content": "도움을 주는 보조 개발자입니다."},
{"role": "user", "content": "MoE 아키텍처의 원리를 설명해 주세요."}
],
temperature=0.7
)
print(response.choices[0].message.content)제시된 코드는 OpenAI API 호출 방식과 동일하게 동작합니다. 기존에 GPT 모델을 사용 중이었다면 베이스 URL과 API 키 매개변수만 교체하면 됩니다. 기존에 구축한 에러 처리, 재시도 로직, 스트리밍 구현체 및 응답 파싱 코드를 수정 없이 그대로 사용할 수 있다는 것이 장점입니다.
