AIHubMix에서 Xiaomi MiMo v2.6 Pro 사용하는 방법: 설정 가이드

업데이트 (2026년 10월 23일): mimo-v2.5-pro는 2026년 10월 21일에 서비스가 종료되었으며, AIHubMix는 더 이상 해당 모델에 대한 요청을 받지 않습니다. 가격이 동일한 mimo-v2.6-pro를 사용하세요.

요약: 공식 openai Python SDK의 대상 주소를 https://aihubmix.com/v1로 설정하고, 모델 ID mimo-v2.6-pro를 사용한 뒤 AIHubMix 키로 인증하면 됩니다. API는 OpenAI와 호환되므로(OpenAI와 같은 형식으로 호출 가능) 특별한 클라이언트가 필요하지 않습니다. 설정에는 약 5분이 걸립니다.

핵심 요점

• OpenAI 호환 API — base_url만 변경하면 됩니다
• 유료 mimo-v2.6-pro · 무료 xiaomi-mimo-v2.6-pro-free [1] [2]
• 입력 $0.48/M · 출력 $0.96/M [1]
• 무료 티어 분당 5회 요청 · 하루 100회 · 하루 1M 토큰 [2]
• 컨텍스트 1.05M 토큰 · 최대 출력 131K 토큰 [1]
• 요구 사항: Python 3.9 이상, AIHubMix API 키

주요 정보

v2.6 Pro와 v2.5 Pro 중 어떤 모델을 사용해야 할까요?

v2.6 Pro를 사용하세요. 가격은 같고 더 다양한 입력을 지원합니다.

Xiaomi의 출시 노트에 따르면 V2.6은 "V2.5 시리즈와 동일한 API 가격을 적용"하며, V2.6-Pro는 Artificial Analysis Intelligence Index에서 46점을 기록했습니다. 이는 작성 시점 기준 오픈소스 모델 중 최고 점수로, Kimi K3와 Qwen3.8 Max보다 높고 Claude Fable 5.1 및 GPT-6 Astra보다는 낮습니다 [4]. 출시 노트에서 세대 간 차이를 가장 명확히 언급한 부분은 저렴한 모델에 관한 내용입니다. V2.6-Flash "는 MiMo-V2.5-Pro를 전반적으로 능가했습니다" [4].

유의할 점은 두 가지입니다. Xiaomi는 V2.6-Pro와 V2.5-Pro를 직접 비교한 벤치마크 표를 공개하지 않았으므로, 위 비교는 사양과 가격을 기준으로 합니다. 또한 mimo-v2.5-pro는 2026년 10월 21일에 서비스가 종료될 예정이며, 마이그레이션 대상 모델로 mimo-v2.6-pro가 지정되어 있습니다 [5]. 따라서 v2.5를 기반으로 새로 구축한 것은 거의 즉시 이전해야 합니다.

AIHubMix를 선택해야 하는 이유

• base_url만 변경하면 됩니다. 게이트웨이가 OpenAI Chat Completions 형식으로 작동하므로 공식 SDK를 수정 없이 사용할 수 있습니다. 동일한 키로 Anthropic 형식의 /v1/messages (베타) 및 기본 Gemini 호출도 이용할 수 있습니다 [6].
• 하나의 키로 여러 제공업체를 이용할 수 있습니다. 설정 당일에는 GET /v1/models에서 416개의 모델 ID가 반환되었으며, 그중 21개는 MiMo 변형 모델이었습니다 [3]. 모델을 바꾸려면 스크립트에서 문자열 하나만 변경하면 됩니다.
• 먼저 무료로 테스트할 수 있습니다. xiaomi-mimo-v2.6-pro-free 는 분당 5회, 하루 100회, 하루 1M 토큰 한도 내에서 무료로 사용할 수 있습니다 [2]. 비용을 들이기 전에 설정이 제대로 작동하는지 확인하기에 충분합니다.
• 구독이 필요 없습니다. 멤버십이나 월 이용료 없이 사용량만큼 결제하며 [6], 유료 MiMo 요금은 모델 페이지의 가격과 동일하게 입력 $0.48/M, 출력 $0.96/M입니다 [1].
• 문제 해결이 더 빠릅니다. 호출에 실패하면 같은 스크립트에서 다른 제공업체의 모델을 지정해 보세요. 해당 모델에서 성공하면 키, URL, 요청 형식은 올바르고 문제는 해당 모델에 있다는 뜻입니다. 반나절을 들이는 대신 한 번의 호출로 확인할 수 있습니다.

설정 방법

1. 프로젝트 만들기

mkdir mimo-demo && cd mimo-demo
python3 -m venv .venv
.venv/bin/pip install "openai>=1.40" "python-dotenv>=1.0"

2. 키 저장하기

printf 'AIHUBMIX_API_KEY=your_key_here\n' > .env
chmod 600 .env
printf '.env\n.venv/\n__pycache__/\n' > .gitignore

스크립트에 키를 하드코딩하지 말고, .env를 커밋하지 마세요.

3. 클라이언트 만들기

chat.py라는 이름으로 저장하세요:

import os
import sys

from dotenv import load_dotenv
from openai import OpenAI

load_dotenv()

client = OpenAI(
    api_key=os.environ["AIHUBMIX_API_KEY"],
    base_url="https://aihubmix.com/v1",
)

prompt = sys.argv[1] if len(sys.argv) > 1 else "Introduce yourself in one sentence."

stream = client.chat.completions.create(
    model="mimo-v2.6-pro",
    messages=[{"role": "user", "content": prompt}],
    max_tokens=1024,
    stream=True,
)

for chunk in stream:
    if not chunk.choices:
        continue
    piece = chunk.choices[0].delta.content
    if piece:
        print(piece, end="", flush=True)
print()

두 가지 검사를 모두 루프 안에 두세요. 일부 청크는 choices 배열이 비어 있는 상태로 도착하는데, 이를 인덱싱하면 IndexError가 발생합니다. 첫 번째와 마지막 프레임에서는 delta.content가 None이므로, 검사 없이 print하면 문자 그대로 None이 출력됩니다.

4. 실행하기

.venv/bin/python chat.py "Introduce yourself in one sentence."

저는 Xiaomi LLM Core Team이 개발한 대규모 언어 모델 MiMo입니다. 질문에 답하고 글을 작성하는 등 다양한 유용한 작업을 도와드리겠습니다.

첫 토큰이 나오기까지 약 6초가 걸릴 것으로 예상됩니다. 모델 페이지에 기재된 시간은 6.4초입니다 [1].

5. 필요에 따라 조정하기

스트리밍을 사용하지 않으려면 stream=True를 제거하고 response.choices[0].message.content를 읽으세요. 모델을 바꾸려면 model 인수를 변경하면 됩니다. 더 긴 출력을 원하면 max_tokens를 늘리세요. 위 예시의 기본값 1024는 모델 한도보다 훨씬 낮습니다 [1].

체크리스트

• [ ] 가상 환경을 만들고 openai 및 python-dotenv 설치
• [ ] .env에 실제 키를 입력하고 chmod 600 실행
• [ ] .env를 .gitignore에 추가
• [ ] base_url이 https://aihubmix.com/v1로 설정되어 있음 — /v1은 필수입니다
• [ ] 모델 ID가 mimo-v2.6-pro (유료) 또는 xiaomi-mimo-v2.6-pro-free (무료)로 설정되어 있음
• [ ] 스트리밍 루프에서 chunk.choices 및 delta.content를 검사함
• [ ] 테스트 호출에서 텍스트가 반환됨

자주 묻는 질문

API가 정말 OpenAI와 호환되나요? 네. 표준 Chat Completions를 지원합니다. 어떤 OpenAI 호환 클라이언트든 base URL을 https://aihubmix.com/v1로 설정하고 AIHubMix 키를 bearer 토큰으로 전달하면 사용할 수 있습니다. AIHubMix 문서에 따르면 coding-xiaomi-mimo-v2.6-flash는 OpenAI 호환 형식만 지원합니다 [3].

어떤 모델 ID를 사용해야 하나요? 유료 모델은 mimo-v2.6-pro, 무료 모델은 xiaomi-mimo-v2.6-pro-free입니다. 두 티어는 모델 이름 규칙이 서로 다릅니다. 무료 모델에는 xiaomi- 접두사가 붙고 유료 모델에는 붙지 않으므로 실수하기 쉽습니다.

다른 변형 모델은 무엇이 있나요? mimo-v2.6-pro-ultraspeed, mimo-v2.6-flash, mimo-v2.5-pro와 coding-xiaomi-mimo-v2.6-pro 같은 코딩 특화 ID가 있습니다 [3]. API에서 다음과 같이 목록을 확인할 수 있습니다:

curl -s https://aihubmix.com/v1/models \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  | python -c "
import json,sys
for i in sorted(m['id'] for m in json.load(sys.stdin)['data']):
    if 'mimo' in i: print(i)
"

429 오류가 발생합니다. 무슨 뜻인가요? 메시지에 따라 의미가 다르며, 두 경우에는 서로 다른 조치가 필요합니다. "rate limited by provider"는 분당 요청 제한에 걸렸다는 뜻이므로 잠시 기다렸다가 다시 시도하세요. "reached the limit of the free model quota"는 계정의 무료 할당량을 모두 사용했다는 뜻이며 무료 모델 간에 공유됩니다. 다시 시도해도 해결되지 않으니 mimo-v2.6-pro로 전환하세요.

400 오류와 "cannot be served at the moment" 메시지가 표시됩니다. 먼저 API에서 ID를 확인하세요:

curl -s https://aihubmix.com/v1/models \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  | python -c "import json,sys; print('mimo-v2.6-pro' in [m['id'] for m in json.load(sys.stdin)['data']])"

결과가 True로 표시되면 curl로 채팅 호출을 반복하고 "code": "no_available_channel"이 있는지 확인하세요. 이는 모델이 목록에 있지만 해당 시점에 업스트림 용량이 없다는 뜻입니다. 제공업체 측 문제이므로 로컬에서 변경해도 해결되지 않습니다. 기다리거나 응답에 포함된 요청 ID를 첨부해 AIHubMix 지원팀에 문의하세요.

문제가 내 쪽인지 제공업체 쪽인지 어떻게 알 수 있나요? 같은 키와 스크립트로 다른 제공업체의 모델을 호출해 보세요. 예를 들면 gpt-4o-mini를 사용할 수 있습니다. 성공하면 키, base URL, 요청 형식은 올바르며 문제는 해당 모델에 있는 것입니다. 해당 호출도 실패하면 키와 결제 정보를 확인하세요.

출력이 문장 중간에 끊기는 이유가 무엇인가요? 모델 한도에 도달한 것이 아니라 max_tokens에 도달한 것입니다. 값을 늘리세요.

계정 상태를 확인하려면 어떻게 하나요?

curl -s https://aihubmix.com/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

has_payment_method와 한도 필드를 확인하세요.

다음 단계

위 스크립트는 바로 사용할 수 있는 기본 예제입니다. MiMo v2.6 Pro는 도구 호출, 구조화된 출력, 이미지 및 오디오 입력, 프롬프트 캐싱을 지원한다고 명시되어 있습니다 [1]. 이 모든 기능은 동일한 OpenAI 호환 인터페이스를 통해 사용할 수 있으므로, 표준 매개변수를 추가하는 것만으로 클라이언트를 확장할 수 있습니다. 무료 티어로 설정을 확인한 다음 일반적으로 사용할 때는 모델 ID를 mimo-v2.6-pro로 바꾸세요.

출처

• [1] AIHubMix 모델 페이지, mimo-v2.6-pro: https://aihubmix.com/model/mimo-v2.6-pro (2026년 9월 28일 확인)
• [2] AIHubMix 모델 페이지, xiaomi-mimo-v2.6-pro-free: https://aihubmix.com/model/xiaomi-mimo-v2.6-pro-free (2026년 9월 28일 확인)
• [3] GET /v1/models 엔드포인트 및 AIHubMix 모델 페이지의 변형 모델 ID와 형식 관련 참고 사항 (2026년 9월 28일 확인)
• [4] Xiaomi MiMo 출시 노트, V2.6 시리즈: https://mimo.mi.com/docs/en-US/news/latest/v2-6 (2026년 9월 28일 확인)
• [5] AIHubMix 모델 페이지, mimo-v2.5-pro: https://aihubmix.com/model/mimo-v2.5-pro (2026년 9월 28일 확인)
• [6] AIHubMix 제품 문서: https://docs.aihubmix.com/en (2026년 9월 28일 확인)