studioglobal
인기 있는 발견
답변게시됨8 소스

Kimi K2.6 API 호출법: Moonshot에서 모델 ID 헷갈리지 않기

Moonshot 공식 API에서 Kimi K2.6를 호출할 때는 base url을 설정하고 /chat/completions를 사용합니다. model 값은 추측하지 말고 GET /models 응답의 id를 확인해 쓰는 것이 안전합니다.

17K0
Minh họa lập trình viên cấu hình API Kimi K2.6 với endpoint Moonshot và model ID
Cách dùng Kimi K2.6 qua API Moonshot: endpoint đúng và model IDLuồng nên dùng: cấu hình endpoint Moonshot, gọi /models để xác minh model ID, rồi gửi request chat.
AI 프롬프트

Create a landscape editorial hero image for this Studio Global article: Cách dùng Kimi K2.6 qua API Moonshot: endpoint đúng và model ID. Article summary: Dùng Kimi K2.6 qua API Moonshot bằng OpenAI SDK với base url https://api.moonshot.ai/v1, rồi gọi /chat/completions; điểm cần kiểm chứng là model ID, nên gọi /models trong tài khoản thay vì đoán.. Topic tags: ai, kimi, moonshot ai, llm, api. Reference image context from search candidates: Reference image 1: visual subject "# Moonshot AI (Kimi K2.6). ## Step 1: Create a Moonshot API account. Go to and create a new Moonshot API account. ## Step 2: Set up Moonshot API account. To use the model via API," source context "Moonshot AI (Kimi K2.6)" Reference image 2: visual subject "Connect and use Kimi K2.6 from Moonshot AI with API Key - Featured image. # How to use Kimi K2.6 from Moonshot AI with API Key on TypingMind. Learn how to access and

openai.com

Moonshot 공식 API로 Kimi K2.6를 붙일 때는 “엔드포인트가 맞나?”보다 “model 문자열이 맞나?”를 먼저 확인하는 편이 좋습니다. Kimi Open Platform은 HTTP API가 OpenAI 호환이고 OpenAI SDK를 직접 사용할 수 있다고 안내하며, SDK의 base_urlhttps://api.moonshot.ai/v1로 설정하라고 설명합니다. HTTP로 직접 호출할 때의 채팅 전체 경로는 https://api.moonshot.ai/v1/chat/completions입니다. [13]

주의할 점은 모델 ID입니다. Kimi의 List Models 문서는 Kimi K2.6 출시를 알리지만, 문서 예시 응답의 idkimi-k2.5로 표시됩니다. 따라서 Kimi K2.6의 실제 model 값은 제품명으로 짐작하거나 다른 게이트웨이 문서를 복사하지 말고, 본인의 Moonshot API 키로

GET /models
를 호출해 응답의 id를 확인한 뒤 쓰는 방식이 안전합니다. [17]

Moonshot에서 확인할 핵심 엔드포인트

용도설정 또는 엔드포인트메모
OpenAI SDK 사용
base_url = https://api.moonshot.ai/v1
Kimi는 OpenAI-compatible API이며 OpenAI SDK를 직접 쓸 수 있다고 설명합니다. [13]
실시간 채팅 호출
POST https://api.moonshot.ai/v1/chat/completions
API Overview는 이 전체 경로를 제시하고, Chat API 문서는 modelmessages 구조의 요청 예시를 보여줍니다. [13][14]
모델 목록 조회
GET https://api.moonshot.ai/v1/models
응답 목록에 모델별 id 필드가 포함됩니다. 이 값을 model에 넣는 것이 핵심입니다. [17]
잔액 확인
GET https://api.moonshot.ai/v1/users/me/balance
Kimi 문서는 Bearer 토큰으로 잔액을 확인하는 예시를 제공합니다. [15]
배치 작업 생성
POST https://api.moonshot.ai/v1/batches
Batch API 문서는 배치 생성 엔드포인트를 제시합니다. [16]

안전한 호출 순서

  1. Moonshot API 키를 준비합니다. Kimi API 예시는
    Authorization: Bearer ...
    헤더를 사용하고, TypingMind 문서도 Moonshot API 계정 생성, 잔액 충전, API 키 발급 흐름을 설명합니다. [2][15][17]
  2. 클라이언트를 OpenAI 호환 방식으로 설정합니다. OpenAI SDK를 쓴다면 base_urlhttps://api.moonshot.ai/v1로 바꾸는 것이 핵심입니다. [13]
  3. 실제 요청 전에 /models를 호출합니다. List Models 엔드포인트는 현재 모델 목록과 id를 반환하므로, 여기서 받은 값을 model 파라미터로 쓰는 것이 안전합니다. [17]
  4. 채팅 요청은 modelmessages로 보냅니다. Kimi의 Chat API 문서는 modelmessages를 포함한 요청 형태를 보여주고, API Overview는 /chat/completions 경로를 안내합니다. [13][14]
  5. 결제나 대량 처리도 미리 점검합니다. 잔액 확인은 /users/me/balance, 배치 생성은 /batches 엔드포인트를 사용할 수 있습니다. [15][16]

Python: OpenAI SDK로 호출하기

아래 예시는 Kimi 문서가 안내한 Moonshot base_url을 사용합니다. [13] KIMI_MODEL_ID에는

GET /models
응답에서 확인한 id를 넣어야 하며, 제품명이나 다른 서비스의 모델명을 임의로 넣지 않는 것이 좋습니다. [17]

python
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: 모델 ID 확인 후 채팅 요청

먼저 인증한 계정에서 모델 목록을 조회합니다. 이 엔드포인트는 모델 목록과 각 모델의 id를 반환합니다. [17]

bash
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 문서에서 확인됩니다. [13][14]

bash
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 토큰을 사용하는 예시를 제공합니다. [15]

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

AIMLAPI·OpenRouter의 모델 ID를 그대로 가져오지 말 것

Kimi K2.6을 제공하는 중개 게이트웨이는 각자 다른 모델 ID를 쓸 수 있습니다. AIMLAPI 문서는 https://api.aimlapi.com/v1/chat/completions에서 moonshot/kimi-k2-6model로 쓰는 예시를 제공합니다. [1] OpenRouter의 Kimi K2.6 API 페이지에는 moonshotai/kimi-k2.6 모델명이 표시됩니다. [5]

이 값들은 해당 게이트웨이를 통해 호출할 때의 ID입니다. 공식 Moonshot 엔드포인트인 https://api.moonshot.ai/v1/chat/completions로 호출할 때는

GET https://api.moonshot.ai/v1/models
를 실행해 Moonshot이 반환한 id를 사용하는 것이 가장 덜 위험합니다. [13][17]

결론

실무 흐름은 간단합니다. Moonshot API 키를 준비하고, OpenAI SDK의 base_urlhttps://api.moonshot.ai/v1로 맞춘 뒤, 먼저 /models에서 Kimi K2.6의 실제 id를 확인합니다. 그다음 /chat/completionsmodelmessages를 담아 보내면 됩니다. 이 과정을 따르면 Kimi의 OpenAI 호환 문서에 맞춰 구현하면서도 AIMLAPI나 OpenRouter의 게이트웨이 전용 모델 ID를 공식 Moonshot API에 잘못 넣는 실수를 줄일 수 있습니다. [1][5][13][14][17]

Studio Global AI

Search, cite, and publish your own answer

Use this topic as a starting point for a fresh source-backed answer, then compare citations before you share it.

Studio Global AI로 검색 및 팩트체크

주요 시사점

  • Moonshot 공식 API에서 Kimi K2.6를 호출할 때는 base url을 https://api.moonshot.ai/v1로 설정하고 /chat/completions를 사용합니다.
  • model 값은 추측하지 말고 GET /models 응답의 id를 확인해 쓰는 것이 안전합니다.
  • AIMLAPI나 OpenRouter의 모델 ID는 각 게이트웨이 전용일 수 있으므로 Moonshot 공식 엔드포인트에 그대로 넣지 않는 편이 좋습니다.

사람들은 또한 묻습니다.

"Kimi K2.6 API 호출법: Moonshot에서 모델 ID 헷갈리지 않기"에 대한 짧은 대답은 무엇입니까?

Moonshot 공식 API에서 Kimi K2.6를 호출할 때는 base url을 https://api.moonshot.ai/v1로 설정하고 /chat/completions를 사용합니다.

먼저 검증할 핵심 포인트는 무엇인가요?

Moonshot 공식 API에서 Kimi K2.6를 호출할 때는 base url을 https://api.moonshot.ai/v1로 설정하고 /chat/completions를 사용합니다. model 값은 추측하지 말고 GET /models 응답의 id를 확인해 쓰는 것이 안전합니다.

실무에서는 다음으로 무엇을 해야 합니까?

AIMLAPI나 OpenRouter의 모델 ID는 각 게이트웨이 전용일 수 있으므로 Moonshot 공식 엔드포인트에 그대로 넣지 않는 편이 좋습니다.

다음에는 어떤 관련 주제를 탐구해야 할까요?

다른 각도와 추가 인용을 보려면 "Claude Security 공개 베타: 앤트로픽의 AI 코드 취약점 스캐너가 하는 일"으로 계속하세요.

관련 페이지 열기

이것을 무엇과 비교해야 합니까?

"Grok 4.3 API 분석: 100만 토큰과 낮은 단가, xAI의 다음 승부수"에 대해 이 답변을 대조 확인하세요.

관련 페이지 열기

연구를 계속하세요

연구 대화

당신

연구문제

Tìm kiếm và kiểm chứng thông tin: Cách dùng Kimi K2.6 qua API như thế nào?

Studio Global AI19 소스

인용 답변

Có thể dùng Kimi K2.6 qua API theo cách gần giống OpenAI API, nhưng từ bằng chứng hiện có, phần chắc chắn nhất là cách kết nối vào nền tảng Kimi/Moonshot và các endpoint chính; còn ví dụ payload đầy đủ riêng cho đúng model ID của Kimi K2.6 thì bằng chứng hiện tại chưa hiển thị rõ. [3][7][8]

Cách dùng qua API chính thức của Kimi/Moonshot

  • Kimi Open Platform cung cấp HTTP API tương thích OpenAI, nên có thể dùng trực tiếp OpenAI SDK. [3]
  • Khi dùng SDK, cần đặt base_urlhttps://api.moonshot.ai/v1. [3]
  • Nếu gọi HTTP trực tiếp, endpoint gốc cũng là https://api.moonshot.ai/v1. [3]
  • API chat có tài liệu “Basic Information”, cho thấy cách gọi theo kiểu chat.completions.create(...) với modelmessages, tức cùng kiểu request body như OpenAI Chat Completions. [4]
  • Có endpoint kiểm tra số dư tại
    GET https://api.moonshot.ai/v1/users/me/balance
    và xác thực bằng header
    Authorization: Bearer ...
    . [5]
  • Có endpoint liệt kê model tại
    GET https://api.moonshot.ai/v1/models
    , và tài liệu model list xác nhận Kimi K2.6 đã được phát hành. [8]
  • Ngoài gọi realtime, nền tảng còn có Batch API tại
    POST https://api.moonshot.ai/v1/batches
    . [6]

Các bước thực tế nên làm

  1. Tạo tài khoản API và lấy API key. [2]
  2. Nạp số dư vào tài khoản nếu muốn dùng model qua API. [2]
  3. Cấu hình client/SDK với
    base_url = https://api.moonshot.ai/v1
    . [3]
  4. Gọi API chat theo chuẩn OpenAI-compatible, truyền modelmessages. [3][4]
  5. Nếu chưa chắc model ID chính xác của Kimi K2.6, gọi endpoint /models để kiểm tra danh sách model khả dụng trước. [8]

Mẫu gọi API tối thiểu

Ví dụ theo đúng hướng dẫn tổng quan của Kimi là dùng OpenAI SDK với base_url của Moonshot. [3]

python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_KIMI_API_KEY",
    base_url="https://api.moonshot.ai/v1"
)

resp = client.chat.completions.create(
    model="KIMI_K2_6_MODEL_ID",
    messages=[
        {"role": "user", "content": "Xin chào, hãy tự giới thiệu."}
    ]
)
print(resp)
  • Phần model="KIMI_K2_6_MODEL_ID" ở trên chỉ là chỗ điền model ID thực tế; trong bằng chứng hiện có, tôi không thấy snippet nào hiển thị trực tiếp tên model ID chính xác của Kimi K2.6 trong request mẫu. [7][8]
  • Nếu cần kiểm tra khả năng truy cập và billing trước, có thể gọi endpoint balance bằng Bearer token. [5]

Nếu dùng bên trung gian thay vì API chính thức

  • Có tài liệu bên thứ ba từ AIMLAPI cho model kimi-k2-6, và ví dụ của họ gọi
    POST https://api.aimlapi.com/v1/chat/completions
    . [1]
  • Điều này cho thấy Kimi K2.6 cũng có thể được truy cập qua nhà cung cấp trung gian, nhưng đây không phải endpoint chính thức của Kimi/Moonshot. [1][3]

Điều đã kiểm chứng được và điều chưa chắc

  • Đã kiểm chứng được rằng Kimi API là OpenAI-compatible và dùng base URL https://api.moonshot.ai/v1. [3]
  • Đã kiểm chứng được rằng có tài liệu riêng cho Kimi K2.6 và tài liệu model list xác nhận Kimi K2.6 đã phát hành. [7][8]
  • Đã kiểm chứng được rằng nền tảng có các endpoint cho chat, list models, balance, và batch. [4][5][6][8]
  • Chưa kiểm chứng được từ bằng chứng hiện có tên model ID chính xác cần điền khi gọi Kimi K2.6 trong request body. Insufficient evidence. [7][8]

Nếu bạn muốn, tôi có thể viết tiếp cho bạn một mẫu hoàn chỉnh bằng curl, Python, hoặc JavaScript theo đúng kiểu OpenAI-compatible, với chỗ nào chưa xác minh được tôi sẽ đánh dấu rõ.

출처

  • [1] kimi-k2-6 | AI/ML API Documentationdocs.aimlapi.com

    import requests import requests import json for getting a structured output with indentation import json for getting a structured output with indentation response = requests.post( response = requests.post( " " headers={ headers={ Insert your AIML API Key in...

  • [2] Moonshot AI (Kimi K2.6) - TypingMind Docsdocs.typingmind.com

    Moonshot AI (Kimi K2.6). Step 1: Create a Moonshot API account. Go to and create a new Moonshot API account. Step 2: Set up Moonshot API account. To use the model via API, you’ll need to add balance to your account. Step 3: Get your Moonshot API key. Be sur...

  • [5] MoonshotAI: Kimi K2.6 – API Quickstart | OpenRouteropenrouter.ai

    MoonshotAI: Kimi K2.6. moonshotai/kimi-k2.6. Kimi K2.6 is Moonshot AI's next-generation multimodal model, designed for long-horizon coding, coding-driven UI/UX generation, and multi-agent orchestration. It handles complex end-to-end coding tasks across Pyth...

  • [13] API Overview - Kimi API Platformplatform.kimi.ai

    Using the API. API Reference. Batch API. API Overview. Kimi Open Platform provides OpenAI-compatible HTTP APIs. You can use the OpenAI SDK directly. When using SDKs, set base url to When calling HTTP endpoints directly, use the full path such as ​ OpenAI Co...

  • [14] Basic Information - Kimi API Platformplatform.kimi.ai

    create( model = "kimi-k2.5", model = "kimi-k2.5", messages = [ messages = [ {"role": "system", "content": "You are Kimi, an AI assistant provided by Moonshot AI. {{ "id": "cmpl-04ea926191a14749b7f2c7a48a68abc6", "id": "cmpl-04ea926191a14749b7f2c7a48a68abc6"...

  • [15] Check Balance - Kimi API Platformplatform.kimi.ai

    Kimi API Platform home pagelight logodark logo. Using the API. API Reference. Batch API. curl --request GET \ curl --request GET \ --url \ --url \ --header 'Authorization: Bearer ' --header 'Authorization: Bearer '. {{ "code": 123, "code": 123, "data": { "d...

  • [16] Create Batch - Kimi API Platformplatform.kimi.ai

    curl --request POST \ curl --request POST \ --url \ --url \ --header 'Authorization: Bearer ' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --header 'Content-Type: application/json' \ --data ' --data '{{ "input file id":...

  • [17] List Models - Kimi API Platformplatform.kimi.ai

    🎉 Kimi K2.6 has been released with improved long-context coding stability. Top-up bonus event in progress 🔗. Kimi API Platform home pagelight logodark logo. Using the API. Capabilities. API Reference. Files. Batch API. curl --request GET \ --url \ --heade...