5단계로 키 생성하기
이 서비스용 Mimo API 키를 얻으려면 다음 단계를 따르세요. 카드나 전화가 필요한 항목은 없습니다.
- 회원가입하기. Google을 사용하거나 이메일 주소와 비밀번호로 등록하세요.
- 키 페이지 열기. 회원가입 후 API 키 페이지로 이동하세요. 키가 거기에 표시됩니다.
- 체험 크레딧 청구하기. 신규 사용자는 해당 페이지에서 한 번의 클릭으로 $0.50 체험 크레딧을 청구할 수 있습니다. 크레딧은 7일 동안 유효하며 카드가 필요 없고 한 명당 하나만 청구할 수 있습니다.
- 키를 복사하여 비밀번호 관리자나 환경 변수 등 안전한 곳에 저장하세요.
- 테스트 요청 보내기 다음 섹션의 curl 명령어를 사용하세요.
이 서비스는 호스팅된 OpenAI 호환 텍스트 API입니다. 독립적인 공급업체의 오픈 웨이트 모델 하나를 실행하며, 합법적인 성인 사용에 대해 콘텐츠 거부 없이 답변하도록 조정되었습니다. 어떤 모델 벤더의 공식 API도 아닙니다. 귀하의 키는 ID가 uncensored인 해당 모델과 base URL https://api.mimoapi.top/v1에서 작동합니다.
요청 하나로 키 테스트하기
앱에 키를 연결하기 전에 터미널에서 테스트하세요. 여기서 실패하면 문제가 키나 계정 관련이므로 자체 코드에서 검색할 필요가 없습니다.
export LLM_API_KEY="paste-your-key-here"
curl -i 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": "Write one sentence about keys."}],
"max_tokens": 60
}'
좋은 결과는 200 상태 코드와 choices 배열을 포함한 JSON 바디입니다. 헤더에는 X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency이 포함됩니다. 잔액 헤더는 요청 비용을 빠르게 확인하는 방법입니다: 두 번 실행하여 비교하세요. 키만 확인하고 비용을 쓰지 않으려면 동일한 헤더로 GET /v1/models을 호출하세요.
공식 OpenAI 패키지를 사용한 Python의 동일한 요청:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.mimoapi.top/v1",
api_key=os.environ["LLM_API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write one sentence about keys."}],
max_tokens=60,
)
print(resp.choices[0].message.content)체험 키로 할 수 있는 것과 할 수 없는 것
체험판은 테스트용이며 프로덕션이 아닙니다. 체험 키는 동시 요청 2개, 분당 60개의 요청을 허용하며 수명은 7일입니다. 크레딧을 추가하면 얻는 전체 키는 동시 요청 8개, 분당 300개의 요청을 허용합니다. 둘 다 동일한 모델, 동일한 100,000 토큰 컨텍스트 창 및 동일한 기능(SSE 스트리밍, 함수 호출, JSON 모드 및 일반적인 샘플링 매개변수)을 공유합니다.
$0.50으로 얼마나 할 수 있나요? 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50의 가격으로, 입력 토큰 1,000개와 출력 토큰 300개로 구성된 요청의 비용은 입력의 경우 1,000 x $0.15 / 1,000,000 = $0.00015, 출력의 경우 300 x $0.50 / 1,000,000 = $0.00015로, 총 $0.0003입니다. 체험 크레딧은 해당 크기의 요청 약 1,666개를 커버합니다($0.50 / $0.0003). 이는 프롬프트 테스트, 프로토타입 제작, 스트리밍이나 도구 사용 시험에 충분합니다.
측정을 위해 체험 크레딧을 사용하세요. 앱에서 가장 자주 보낼 5개의 프롬프트를 선택하고 각각 몇 번 실행한 후 잔액 변화를 기록하세요. 일주일 후에는 실제 요청당 비용과 모델이 귀하의 데이터에서 어떻게 작동하는지 파악할 수 있습니다. 실패하거나 거부된 요청에는 요금이 부과되지 않습니다.
키를 비공개로 유지하기
API 키는 돈을 쓰는 비밀번호입니다. 키를 가진 사람은 누구나 귀하의 잔액으로 요청을 실행할 수 있습니다. 대부분의 유출을 방지하기 위한 몇 가지 규칙은 다음과 같습니다:
- 소스 파일이 아닌 환경 변수.
os.environ또는process.env로 키를 읽으세요. 로컬 작업의 경우.gitignore에 나열된.env파일이면 충분합니다. - 서버 측에서만 사용. 브라우저 JavaScript나 모바일 앱에서 API를 호출하지 마세요. 누구나 페이지나 앱 패키지에서 키를 읽을 수 있습니다. 프론트 엔드와 API 사이에 작은 서버를 두세요.
- 키당 한 곳의 위치. 키를 하나의 secrets store에 보관하고 해당 위치에서 각 배포 환경에 복사하여 항상 키의 위치를 파악하세요.
- 채팅, 티켓 또는 스크린샷에 키 넣지 마세요. 도움을 요청할 때 키가 아닌 응답의
X-Request-Id을 공유하세요. - 의심 시 교체. 키가 유출되었다고 생각되면 사용을 중지하고 지원팀에 연락하여 교체하세요.
X-Balance-USD 헤더도 확인하세요. 앱이 대기 상태일 때 잔액이 감소하면 다른 사람이 귀하의 키를 사용하고 있다는 첫 번째 신호입니다.
체험을 넘어 충전 및 결제하기
체험 크레딧이 소진되면 크레딧을 추가하세요. $20부터 $500까지의 정수 금액 모두 유효합니다. 보너스는 자동으로 추가됩니다: $50부터 5%, $100부터 10%, $200부터 15%. 따라서 $100 충전 시 $110의 크레딧이, $200 충전 시 $230의 크레딧이 제공됩니다. 암호화폐(TRC20 기반 USDT, Base 기반 USDC)로 결제할 수 있습니다.
구독은 없습니다. 잔액에서 토큰당 요금을 지불하며 크레딧은 만료되지 않습니다. 이는 불규칙한 트래픽이 있는 프로젝트에 적합합니다. 전체 가격 목록은 가격 책정 페이지에서 확인할 수 있습니다. API를 통해 전송된 프롬프트는 학습에 사용되지 않습니다.
합리적인 첫 번째 충전 금액은 $20입니다. 이 페이지의 이전 섹션에서 사용된 채팅 크기 요청($0.0003/회)의 경우 약 66,000개의 요청을 커버할 수 있습니다. 며칠 후 자신의 평균을 확인하고 조정하세요.
작동하지 않는 키의 문제 해결
대부분의 키 문제는 간단한 원인을 가집니다.
- 즉시 인증 오류. 복사할 때 문자가 누락되거나 추가되었습니다. 선행 또는 후행 공백이나 줄 바꿈을 확인하세요. 헤더가
Authorization: Bearer뒤에 키가 오는지 확인하세요. - curl에서는 작동하지만 앱에서는 작동하지 않음. 앱이 환경 변수를 읽지 않는 것 같습니다. 전체 키가 아닌 앱이 인식하는 값의 처음 네 문자를 출력하세요.
- 찾을 수 없음. Base URL이 잘못되었습니다.
https://api.mimoapi.top/v1이어야 하며,api서브도메인이어야 합니다. 빠른 시작 가이드에는 클라이언트별 목록이 있습니다. - HTTP 429.
concurrency코드는 동시에 너무 많은 요청이 있음을 의미하며,rate_limited은 분당 너무 많은 요청이 있음을 의미합니다. 체험 키는 더 빨리 이 제한에 도달합니다(동시 2개, 분당 60개).Retry-After: 5이 포함된 429는 짧은 과부하를 의미하며 5초 동안 기다리세요. - 체험 크레딧 누락. 체험은 키 페이지에서 클릭하여 청구하며 사람당 하나입니다. 7일 후 만료됩니다.
위의 방법으로 해결되지 않으면 실패한 응답에서 X-Request-Id 값을 수집하여 지원팀에 연락하세요. 해당 ID는 키를 보내지 않아도 문제를 추적할 수 있게 해줍니다.
먼저 무엇을 구축할까?
유효한 키를 사용하여 나중에 필요할 기능들을 사용하는 작은 프로젝트를 선택하세요. 명령줄 채팅 루프는 메시지 기록을 가르쳐 줍니다. response_format을 사용하여 JSON 객체를 반환하는 스크립트는 구조화된 출력을 가르쳐 줍니다. 모델이 호출할 수 있는 함수는 도구 사용법을 가르쳐 줍니다. 각각 1시간도 걸리지 않으며, 모두 체험 잔액으로 실행됩니다. 이 서비스를 다른 호스팅 모델과 비교 중이라면 Mistral API 대안의 비교 목록에서 결정하기 전에 물어볼 만한 질문들을 확인하세요.
합법적인 범위에서 성인에 한해 사용하세요. 모델은 콘텐츠 거부 없이 답변하도록 조정되었으며 이는 픽션, 롤플레이 및 연구를 위한 기능이지만 규칙을 깨도 된다는 의미는 아닙니다: 미성년자가 관련된 성적 콘텐츠는 절대 허용되지 않습니다.
