Mimo API 기본 URL 및 클라이언트 구성 방법

복사할 값

mimo api base url을 찾는 모든 사람은 세 가지 값이 필요하며, 나머지 모든 것은 구성 중인 도구의 세부 사항입니다.

설정	내용
기본 URL	https://api.mimoapi.top/v1
모델 ID	uncensored
인증 헤더	Authorization: Bearer YOUR_KEY
채팅 엔드포인트	POST /v1/chat/completions
모델 목록	GET /v1/models

이 서비스는 OpenAI 호환이므로 OpenAI 기본 URL과 키를 변경할 수 있는 모든 클라이언트에서 작동합니다. 독립 제공업체의 오픈 웨이트 모델 하나를 실행하는 호스팅 텍스트 API입니다. 어떤 모델 벤더의 공식 API도 아닙니다. 텍스트 전용: 이미지, 오디오 또는 비디오 생성, 임베딩, 파인튜닝이 없으므로 이러한 엔드포인트를 기대하는 클라이언트는 해당 엔드포인트를 찾을 수 없습니다. 키가 아직 없다면 키 페이지에서 1분이면 완료됩니다.

기본 URL과 전체 엔드포인트

가장 흔한 혼동은 기본 URL과 엔드포인트 URL 사이의 것입니다. 기본 URL은 /v1에서 끝납니다. 엔드포인트는 기본 URL에 경로를 추가한 것입니다. 공식 OpenAI SDK와 이를 기반으로 한 대부분의 도구는 두 가지를 자동으로 연결합니다.

• 기본 URL: https://api.mimoapi.top/v1
• 채팅 엔드포인트: https://api.mimoapi.top/v1/chat/completions
• 모델 엔드포인트: https://api.mimoapi.top/v1/models

설정 화면에서 "base URL", "API base", "endpoint" 또는 "host"를 요청할 때 플레이스홀더를 읽으세요. 플레이스홀더가 /v1로 끝나면 기본 URL을 붙여넣으세요. /chat/completions로 끝나면 전체 채팅 엔드포인트를 붙여넣으세요. 기본 URL이 필요한 필드에 전체 엔드포인트를 붙여넣으면 /chat/completions/chat/completions이 생성되어 존재하지 않습니다. 기본 URL이 필요한 필드에 도메인만 붙여넣으면 /chat/completions이 생성되어 /v1 없이 실패합니다.

호스트도 확인하십시오. API는 api 서브도메인에서 실행됩니다. 일반 사이트 도메인은 웹 페이지를 제공하므로 API 경로와 함께 요청하면 모델에 도달하지 않습니다.

Python 및 Node

공식 SDK를 사용할 때는 클라이언트를 생성할 때 한 번만 기본 URL을 설정하면 됩니다. pip install openai 또는 npm install openai로 설치하십시오.

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.mimoapi.top/v1",
    api_key="YOUR_KEY",
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Name three uses for a base URL."}],
    max_tokens=150,
)
print(resp.choices[0].message.content)

Copyimport OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.mimoapi.top/v1",
  apiKey: process.env.LLM_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Name three uses for a base URL." }],
  max_tokens: 150,
});
console.log(resp.choices[0].message.content);

Python 및 Node OpenAI SDK는 코드에서 값을 전달하지 않을 때 환경 변수 OPENAI_BASE_URL 및 OPENAI_API_KEY도 읽습니다. 이를 통해 기존 스크립트를 수정하지 않고도 접속 대상을 바꿀 수 있습니다. 두 변수를 export하고 스크립트가 이 API와 통신하도록 하세요. 스크립트가 GPT 이름과 같은 모델을 하드코딩하지 않았는지 확인하고 uncensored로 교체하세요.

빠른 테스트용 curl

순수 HTTP 호출은 다른 모든 변수를 제거하므로 가장 좋은 첫 번째 확인 방법입니다. 첫 번째 명령은 모델을 나열하고 키를 확인합니다. 두 번째 명령은 채팅 요청을 보냅니다.

Copyexport LLM_API_KEY="YOUR_KEY"

curl -s https://api.mimoapi.top/v1/models \
  -H "Authorization: Bearer $LLM_API_KEY"

curl -s https://api.mimoapi.top/v1/chat/completions \
  -H "Authorization: Bearer $LLM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":20}' -i

-i 플래그는 응답 헤더를 출력합니다. X-Request-Id(지원팀 문의 시 인용), X-Balance-USD(남은 크레딧), 그리고 두 속도 제한 헤더 X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency을 확인하세요. 스트리밍의 경우 바디에 "stream": true를 추가하고 curl에 -N을 추가하여 출력 버퍼링을 방지하세요. 5분 빠른 시작 가이드는 스트리밍과 함수 호출을 다룹니다.

LangChain, 채팅 프론트엔드 및 기타 도구

타사 도구는 자체 레이블을 사용하지만 모두 동일한 세 가지 값이 필요합니다. 다음과 같은 패턴을 볼 수 있습니다:

• LangChain (Python): ChatOpenAI(model="uncensored", base_url="https://api.mimoapi.top/v1", api_key="YOUR_KEY"). 이 클래스는 모든 OpenAI 호환 서버에서 작동합니다.
• SillyTavern 및 유사한 역할극 프론트엔드: 사용자 지정 또는 일반 OpenAI 호환 채팅 소스를 선택하고 Base URL을 붙여넣은 후 키를 추가하세요. 목록이 자동으로 채워지지 않으면 모델 이름으로 uncensored를 입력하세요.
• Open WebUI 및 기타 자체 호스팅 채팅 UI: 설정에서 동일한 Base URL과 키를 사용하여 OpenAI 호환 연결을 추가하세요.
• 편집기 플러그인 및 스크립트: 플러그인 설정에서 "custom OpenAI endpoint" 또는 "override base URL"을 찾아보세요.

각 도구의 메뉴 이름은 버전 간에 변경되므로 정확한 레이블보다는 필드의 목적을 따르십시오. 도구가 고정 제공업체에 대해 키를 확인하도록 강요하면 사용자 지정 엔드포인트와 호환되지 않으며 다른 도구가 해결책입니다.

도구에서 모델 드롭다운을 제공하는 경우, 일반적으로 GET /v1/models 호출로 채웁니다. 드롭다운이 비어 있으면 모델 ID를 직접 입력하세요. 도구가 알 수 없는 모델 이름을 거부하면 "custom model"이라는 옵션을 찾으세요.

일반적인 구성 오류 수정

요청이 실패하면 상태 코드와 정확한 URL이 원인을 빠르게 좁힙니다. 이 목록을 따라 진행하십시오.

1. 인증 오류. 키가 누락되었거나 잘렸거나 끝에 공백이나 개행이 있습니다. 다시 붙여넣고 헤더가 Bearer, 공백, 그 다음 키로 읽히는지 확인하세요.
2. 찾을 수 없음. 경로가 잘못되었습니다. 클라이언트가 생성한 최종 URL을 출력하세요. 정확히 https://api.mimoapi.top/v1/chat/completions이어야 합니다. /v1 누락, 경로 중복 또는 잘못된 호스트를 확인하세요.
3. 알 수 없는 모델. 다른 제공업체의 남아 있는 모델 이름입니다. 모델을 uncensored로 설정하세요.
4. rate_limited 또는 concurrency가 포함된 HTTP 429. 분당 300개 이상의 요청 또는 동시에 8개(시험 키의 경우 60개 및 2개)를 초과했습니다. 요청 속도를 줄이거나 큐에 추가하세요. Retry-After: 5 헤더가 있는 429는 일시적 과부하를 의미하며, 5초를 기다린 후 다시 시도하세요.
5. 요청 크기 초과. 바디 제한은 8 MB이며 컨텍스트 창은 프롬프트 및 완료 토큰 합계 100,000개입니다. 기록을 줄이세요.
6. curl에서는 작동하지만 브라우저에서는 실패. 프론트엔드 JavaScript에서 API를 직접 호출하면 키가 모든 방문자에게 노출됩니다. 요청을 자체 서버로 라우팅하세요.

키를 공개 저장소나 클라이언트 측 번들에 넣지 마십시오. 환경 변수에 저장하고 스크린샷 및 지원 티켓에서 제외하십시오.

첫 번째 성공적인 호출 후 다음 단계

Base URL이 작동하면 몇 가지 설정을 아는 것이 좋습니다. SSE를 통한 스트리밍은 stream: true로 활성화됩니다. 함수 호출은 tools 및 tool_choice를 사용하며, 결과는 role: "tool" 메시지로 반환됩니다. JSON 모드는 response_format: {"type": "json_object"}입니다. temperature, top_p, stop, seed 및 페널티와 같은 샘플링 제어는 전달됩니다.

결제 측면에서는 선불 크레딧에서 1M 입력 토큰당 $0.15, 1M 출력 토큰당 $0.50이 청구됩니다. 가격 책정 페이지에서 충전 금액과 보너스 정보를 확인할 수 있습니다. 이 모델은 합법적인 성인 사용자를 위해 콘텐츠 거부 없이 답변하도록 조정되었으며, 미성년자가 관련된 성 콘텐츠는 절대 허용되지 않습니다. 프롬프트는 학습에 사용되지 않습니다.

더 많은 가이드

• Mimo API 가격 책정: 선불 토큰별 요금
• Mimo API 키: 생성 및 요청 수행
• Mistral API 대안: 무검열 LLM 옵션 비교