호스트와 인증
종량제 OpenAI 요청은 https://api.xiaomimimo.com/v1과 api-key 헤더를 사용합니다. Token Plan은 전용 호스트와 tp-xxxxx 자격 증명을 사용합니다.
한국어
MIMO 2.5 PRO API
MiMo 2.5 Pro API 연결을 필드별로 고치기
정상 요청에는 Xiaomi의 올바른 호스트, api-key 헤더, 정확한 모델 ID, MiMo가 받는 요청 본문이 필요합니다. 먼저 증상을 확인하고 thinking, streaming, 컨텍스트, 공급자 라우팅을 순서대로 점검하세요.
공식 문서 확인일: 2026-08-27. 현재 Tabbit 모델 선택기에 MiMo-V2.5-Pro가 없으므로 지원 모델을 사용하는 별도 경로로 설명합니다.
공식 문서의 내용
대부분의 실패는 계약 필드 불일치입니다
Xiaomi는 두 종류의 Base URL, 모델 ID, OpenAI와 Anthropic 호환 형식을 문서화합니다. 커뮤니티 검색에는 공급자 거부와 입력 토큰만 소모하고 유용한 출력을 내지 않는 사례도 있지만 서비스 보장은 아닙니다.
모델과 본문
공식 예제는 mimo-v2.5-pro와 /chat/completions를 사용합니다. 샘플링이나 에이전트 필드를 바꾸기 전에 messages를 확인하세요.
추론도 상태입니다
Deep Thinking은 reasoning_content를 반환합니다. 도구 호출 멀티턴에서는 이후 assistant 메시지에 전체 필드를 돌려보내야 하며, 빠지면 400이 날 수 있습니다.
최소 정상 요청
SDK 조정 전에 curl로 확인하기
공식 OpenAI 호환 형식을 경로 확인에 필요한 필드로 줄였습니다. 키는 셸 환경 변수에 두고 저장소에 커밋하지 마세요.
복사 가능한 기준 요청
curl --location --request POST 'https://api.xiaomimimo.com/v1/chat/completions' \
--header "api-key: $MIMO_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{"model":"mimo-v2.5-pro","messages":[{"role":"user","content":"Hello"}],"max_completion_tokens":1024,"stream":false}'공식 예제에는 max_completion_tokens, temperature 1.0, top_p 0.95, stream false와 penalty 필드도 있습니다. 깊은 추론에서는 권장값이 적용될 수 있습니다.
- 01
계정 경로 선택
종량제는 https://api.xiaomimimo.com/v1을 사용합니다. Token Plan은 구독 후 표시되는 전용 Base URL로 바꿉니다.
- 02
Xiaomi 인증 전송
api-key: $MIMO_API_KEY와 Content-Type: application/json을 사용하세요. 모든 OpenAI 클라이언트가 Authorization을 문서의 헤더로 바꾸는 것은 아닙니다.
- 03
정확한 ID 사용
model을 mimo-v2.5-pro로 설정합니다. 게이트웨이는 다른 slug를 쓸 수 있으니 현재 카탈로그에서 복사하세요.
- 04
사용자 한 턴부터
user 메시지 하나로 시작합니다. completion이 반환된 뒤 tools, thinking, stream을 추가하세요.
추론, 스트리밍, 컨텍스트
응답 모양을 바꾸는 세 가지 제어
API 동작을 테스트 기준으로 삼으세요. 최종 답이 비어 있으면 클라이언트가 content만 읽고 reasoning_content를 놓쳤거나, 추론이 예산을 소진했을 수 있습니다.
thinking.type
{"type":"enabled"} 또는 {"type":"disabled"}를 보냅니다. Xiaomi는 mimo-v2.5-pro와 mimo-v2.5를 기본 활성화로 설명합니다. Python SDK에서는 extra_body에 넣습니다.
stream과 종료
스트리밍에서는 reasoning_content 청크가 먼저 오고 content 청크가 뒤따릅니다. 둘 다 누적하고 finish_reason에서 종료하며 [DONE] 전 usage 청크를 처리하세요.
컨텍스트와 예산
문서에 없는 context window 수치를 추측하지 마세요. 전체 messages를 현재 모델과 계정 제한 안에 두세요. max_completion_tokens는 추론과 최종 답변을 함께 포함합니다.
Xiaomi는 깊은 추론에서 사용자 지정 temperature와 top_p가 적용되지 않으며 권장값은 1.0과 0.95라고 설명합니다. 실제 서버 응답을 확인하세요.
경로 차이
공식 API, Token Plan, 게이트웨이는 같은 계약이 아닙니다
OpenAI 호환은 요청 방식만 설명합니다. 요금, 별칭, 헤더, 쿼터, 검열, 스트리밍 동작까지 같다는 뜻은 아닙니다. 실패마다 호스트와 공급자를 기록하세요.
| 확인 | Xiaomi 공식 | 게이트웨이 또는 공급자 |
|---|---|---|
| OpenAI Base | https://api.xiaomimimo.com/v1 | 공급자의 현재 Base URL 사용 |
| Token Plan | https://token-plan-cn.xiaomimimo.com/v1 및 tp-xxxxx | 종량제 키와 보통 교환할 수 없음 |
| model 필드 | mimo-v2.5-pro | 카탈로그의 정확한 slug 복사 |
| 인증 | api-key: MIMO_API_KEY | 공급자 헤더와 키 형식 확인 |
| 제한과 정책 | Xiaomi 사용량과 API 콘솔 확인 | 쿼터, 검열, RPM, TPM, 동시성 확인 |
상태 코드 체크리스트
응답 코드로 범위를 좁히기
한 번에 변수 하나만 바꾸세요. 재시도 전에 호스트, 모델, 응답 본문, 시간을 저장합니다.
잘못된 본문, 지원하지 않는 필드, 잘못된 messages, reasoning_content가 빠진 도구 기록.
최소 요청을 재생하고 JSON, model, messages, thinking 위치, reasoning_content 전체 전달을 확인하세요.
키가 없거나 만료되었고 접두사 또는 헤더가 틀림.
환경 변수에서 키를 읽어 문서의 api-key 헤더를 사용하세요. 비밀을 출력하지 마세요.
계정이나 경로에 권한이 없거나 게이트웨이 정책이 거부함.
계정, 플랜 호스트, 모델 권한, 공급자 정책, 검열 결과를 확인하세요.
호스트 경로나 모델 별칭이 존재하지 않음.
/v1/chat/completions, Base URL과 모델 카탈로그를 확인하고 /v1을 두 번 붙이지 마세요.
속도, 토큰, 동시성 또는 계정 쿼터 초과.
현재 제한을 확인하고 jitter backoff를 사용하며 병렬 호출을 줄이세요.
빠르게 반환되지만 content가 비어 있거나 스트림이 멈춘 것처럼 보임.
각 delta, reasoning_content, finish_reason을 기록하세요. max_completion_tokens를 늘리고 파서를 확인한 뒤 thinking disabled를 시험하세요.
API가 필요 없을 때의 브라우저 경로
자격 증명 배관이 아니라 페이지 작업에 Tabbit 사용
현재 Tabbit 선택기에 MiMo-V2.5-Pro가 없습니다. 원클릭 통합을 약속할 수 없습니다. 페이지 조사나 답변 비교가 목적이면 실제로 표시된 지원 모델을 선택하고 API 진단과 분리하세요.
01
목록에 있는 모델 선택
새 탭의 선택기에서 사용 가능한 모델을 고릅니다. Xiaomi 키나 Base URL을 만들 필요가 없습니다.
02
웹 컨텍스트 가져오기
현재 페이지에 질문하거나 브라우저 입력창에서 페이지와 파일을 참조합니다. 원시 API 요청과는 다른 문제를 해결합니다.
03
답변 비교
지원 모델 답변을 나란히 보고 Deep Research로 출처와 실행 단계를 모을 수 있습니다.
어떤 경로인가
API 제어와 브라우저 컨텍스트
직접 통합을 운영한다면 Xiaomi의 MiMo API가 맞습니다. 페이지를 읽고 지원 모델로 작업하려면 Tabbit 경로가 짧습니다.
| 필요 | MiMo API | Tabbit |
|---|---|---|
| 자격 증명 | Xiaomi 또는 공급자 키 생성 및 보호 | 선택기에 있는 모델 사용 |
| 요청 제어 | 호스트, 모델, 본문, 추론, 도구, stream 선택 | 브라우저 컨텍스트에서 질문 |
| 도구 상태 | assistant reasoning_content 보존 | API 메시지 수동 재전송 불필요 |
| 웹 조사 | 검색, fetch, 인용 파이프라인 구축 | 페이지와 Deep Research 사용 |
MIMO API FAQ
첫 실패 뒤에 자주 묻는 질문
MiMo 2.5 Pro 공식 엔드포인트는 무엇인가요?+
종량제 OpenAI 호환에서는 https://api.xiaomimimo.com/v1과 /chat/completions를 사용합니다. Token Plan은 별도 Base URL입니다.
Xiaomi가 문서화한 API Key 헤더는 무엇인가요?+
공식 curl은 api-key: $MIMO_API_KEY를 사용합니다. 키를 환경 변수에 두고 게이트웨이가 다른 헤더를 요구하는지 확인하세요.
어떤 모델 ID를 보내나요?+
Xiaomi 예제는 mimo-v2.5-pro를 사용합니다. 게이트웨이는 다른 별칭을 공개할 수 있으므로 해당 카탈로그의 정확한 ID를 사용하세요.
깊은 추론을 켜고 끄는 방법은?+
thinking.type에 enabled 또는 disabled를 보냅니다. OpenAI Python SDK에서는 extra_body에 넣습니다. Xiaomi는 두 V2.5 모델이 기본 활성화라고 합니다.
최종 답이 비어 있거나 느린 이유는?+
추론은 예산을 소모하고 지연을 늘립니다. 스트리밍에서 reasoning_content가 content보다 먼저 옵니다. 둘 다 누적하고 finish_reason을 확인하세요.
후속 도구 호출이 400을 반환하는 이유는?+
추론과 도구를 함께 쓸 때 Xiaomi는 다음 assistant 메시지에 이전 reasoning_content 전체를 다시 보내라고 합니다. 빠지면 컨텍스트가 불완전합니다.
MiMo에 복사해서 쓸 고정 컨텍스트 창이 있나요?+
확인되지 않은 숫자를 제3자 페이지에서 복사하지 마세요. 현재 모델과 계정 제한을 확인하고 추론과 답변 공간을 남기세요.
MiMo-V2.5-Pro를 Tabbit에서 바로 쓸 수 있나요?+
현재 Tabbit 선택기에 없습니다. API에는 Xiaomi나 게이트웨이를 사용하고 브라우저 조사에는 Tabbit에 나열된 모델을 사용하세요.
다음 400을 더 이상 추측하지 않을 준비가 됐나요?
Xiaomi 최소 요청을 재생한 뒤 thinking, tools, streaming을 하나씩 추가하세요. 페이지 작업에는 API 키 없이 Tabbit 지원 모델을 사용하세요.
모델 접근성과 공급자 제한은 바뀔 수 있습니다. 배포 전에 공식 문서를 다시 확인하세요.