KO ▾

MiniMax API 설정: 키, 베이스 URL 및 첫 요청 요청

minimaxapikey.com의 OpenAI 호환 API를 위한 단계별 설정입니다: 계정, 키, 베이스 URL, 첫 요청. 독립적인 서비스이며, 공식 모델 벤더 API가 아닙니다.

업데이트됨

키에서 서버 랙으로 이어지는 6단계 빛나는 단계를 나타내며 API 설정 경로를 상징합니다.

주요 포인트

  • Google 또는 이메일로 회원가입하고 키 페이지에서 $0.50의 무료 체험 크레딧을 받으세요. 카드는 필요하지 않습니다.
  • 베이스 URL은 https://api.minimaxapikey.com/v1이며, 모델 ID는 uncensored입니다. 인증은 Bearer 키를 사용합니다.
  • 두 가지 방법이 있습니다: POST /v1/chat/completions과 GET /v1/models.
  • 401은 키 오류를, 429는 속도 제한 도달을 의미하므로 본문 내 오류 코드를 확인하세요.

설정할 내용

사람들은 minimax api setup을 검색하여 두 가지 중 하나를 기대합니다: 공식 MiniMax 개발자 플랫폼이거나, OpenAI 스타일의 엔드포인트입니다. 이 페이지는 두 번째를 다룹니다. minimaxapikey.com 뒤의 서비스는 독립적인 제공자가 운영하는 단일 오픈 웨이트 모델을 실행하는 호스팅 OpenAI 호환 텍스트 API입니다. MiniMax 또는 다른 모델 벤더의 공식 API가 아니며, 벤더 간 요청 라우팅도 수행하지 않습니다. 벤더 자체 플랫폼이 필요하면 해당 사이트를 사용하세요.

제공되는 것은 간단합니다. Base URL과 API 키만 변경하면 모든 OpenAI SDK 또는 클라이언트가 작동합니다. POST /v1/chat/completions와 GET /v1/models 두 가지 메서드, uncensored 하나의 모델 ID, 프롬프트와 완성을 공유하는 100,000토큰 컨텍스트 창이 있습니다. 텍스트 전용이므로 이미지, 오디오 또는 비디오 생성, 임베딩, 파인튜닝이 없으며 스트리밍, 함수 호출 및 JSON 모드가 지원됩니다.

전체 설정에는 몇 분 정도 걸립니다. 아래 단계는 순서대로 진행되며, 각 단계는 다음 단계로 넘어가기 전에 성공했는지 확인할 수 있는 확인 절차로 끝납니다.

1단계 및 2단계: 계정 생성 및 체험 크레딧 받기

  1. 키 페이지를 엽니다. API 키 페이지로 이동하여 회원가입하세요. Google 또는 이메일 주소와 비밀번호를 사용할 수 있습니다.
  2. 체험 크레딧을 받습니다. 회원가입 후 키 페이지에 $0.50 체험 크레딧 버튼이 있습니다. 클릭 한 번으로 카드가 필요 없으며, 7일 동안 유효하고 사람당 한 번만 사용할 수 있습니다.

체험 크레딧이 작은 것은 의도적입니다. 1M 입력 토큰당 $0.15, 1M 출력 토큰당 $0.50의 가격으로, $0.50은 충분한 테스트 요청을 커버합니다. 1,000토큰 프롬프트와 500토큰 답변의 경우 입력 비용은 $0.00015, 출력 비용은 $0.00025로 총 $0.0004입니다. $0.50을 이 금액으로 나누면 1,250개의 요청이 가능하므로 실험하기에 충분한 여지가 있습니다.

체험 키의 제한 사항을 참고하세요: 동시 요청 2개, 분당 60개 요청입니다. 충전 후 얻는 일반 키는 동시 요청 8개, 분당 300개를 허용합니다. 테스트 루프가 병렬로 실행되고 429 오류가 발생하면 이것이 첫 번째로 확인할 사항입니다.

3단계: 키 생성 및 안전하게 저장

같은 페이지에서 API 키를 생성하고 복사하세요. 비밀번호처럼 취급하세요. 환경 변수나 시크릿 관리자에 넣으세요. 저장소, 프론트엔드 번들 또는 스크린샷에 넣지 마세요. 키가 유출되면 제거하고 새 키를 생성하세요.

# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"

# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"

서버 측 코드는 런타임에 변수를 읽어야 합니다. 브라우저 코드는 키를 보유하지 않아야 합니다: 백엔드에서 요청을 보내세요. 브라우저로 전송되는 모든 것은 모든 방문자에게 공개되기 때문입니다.

4단계: 키 확인을 위해 모델 목록 조회

가장 저렴한 테스트 방법은 models 엔드포인트입니다. 텍스트를 생성하지 않으므로 키, URL 및 네트워크를 간단하게 확인할 수 있습니다.

curl -s https://api.minimaxapikey.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_KEY"

uncensored가 포함된 JSON 목록을 받아야 합니다. 401이 발생하면 키가 잘못되었거나 불필요한 공백이나 따옴표가 있을 수 있습니다. 연결이 실패하면 URL이 /v1로 끝나는지, https를 사용했는지 확인하세요.

5단계: 첫 채팅 요청 보내기

이제 실제 완성 텍스트를 얻습니다. 본문은 표준 채팅 완성 형태입니다.

curl -s https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $UNCENSORED_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "user", "content": "Explain what an API key is in two sentences."}
    ],
    "temperature": 0.7
  }'

응답에는 choices[0].message.content와 프롬프트 및 완성 토큰 수가 포함된 usage 블록이 포함됩니다. curl -i로 응답 헤더도 확인하세요. 지원팀에서 요청을 찾을 수 있는 X-Request-Id, 남은 크레딧을 나타내는 X-Balance-USD, 그리고 속도 제한 헤더 X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency이 표시됩니다.

temperature, top_p, stop, seed 및 페널티와 같은 매개변수가 전달됩니다. max_tokens은 선택 사항입니다. 이를 생략하면 완성이 컨텍스트 창의 남은 부분을 모두 사용할 수 있습니다.

6단계: SDK에서 동일한 호출

curl이 작동하면 실제로 사용할 언어로 이동하세요. 기본 OpenAI 설정과 비교하여 변경되는 인수는 두 가지뿐입니다.

from openai import OpenAI
import os

client = OpenAI(
    base_url="https://api.minimaxapikey.com/v1",
    api_key=os.environ["UNCENSORED_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.minimaxapikey.com/v1",
  apiKey: process.env.UNCENSORED_KEY,
});

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);

스트리밍의 경우 stream: true를 추가하고 서버 전송 이벤트를 읽으세요. 사용량 숫자는 스트림의 끝에 도착합니다. 문서 페이지에는 스트리밍, 함수 호출 및 response_format: {"type":"json_object"} JSON 모드에 대해 설명되어 있습니다.

기존 OpenAI 프로젝트 이동

대부분의 경우 연결하려는 프로젝트는 이미 OpenAI 클라이언트 라이브러리와 함께 작동합니다. 그런 경우 코드를 거의 수정하지 않아도 됩니다. 공식 SDK는 인수를 전달하지 않을 때 환경 변수 OPENAI_API_KEY 및 OPENAI_BASE_URL를 읽으므로 배포 변경만으로 충분할 수 있습니다.

export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"

남은 수정 사항은 모델 이름입니다. OpenAI 모델 ID와 같은 문자열은 여기에는 존재하지 않으므로 uncensored로 바꾸세요. 가능하면 구성 값을 통해 변경하여 다시 전환할 수 있도록 하세요. 그런 다음 서비스에서 제공하지 않는 기능을 위해 코드를 읽어보세요. 이미지 생성, 오디오, 임베딩 및 파인튜닝은 사용할 수 없습니다. 이는 텍스트 전용 채팅 API이기 때문입니다. 앱이 검색을 위해 임베딩을 호출하는 경우 해당 부분에 대해 다른 공급자가 필요하며 채팅은 이 공급자에서 유지할 수 있습니다.

모델에 대해 아는 것도 도움이 됩니다. 이 모델은 합법적인 성인용도로 콘텐츠 거부 없이 답변하도록 튜닝된 단일 오픈 웨이트 모델이며, 설정과 관계없이 하나의 엄격한 제한 사항이 적용됩니다: 미성년자가 등장하는 성적 콘텐츠는 허용되지 않습니다. 다른 모델용으로 작성된 프롬프트는 시스템 프롬프트에 대한 각 모델의 반응이 다르므로 작은 조정이 필요할 수 있습니다. 실제 트래픽을 전환하기 전에 자체 테스트 프롬프트를 병렬로 실행하세요.

첫날에 선택할 만한 설정

몇 가지 결정은 출시 후보다 설정 시 더 쉽게 내릴 수 있습니다. 모두 어렵지 않지만, 각각 나중에 예상치 못한 문제를 방지합니다.

  • 시스템 프롬프트. 톤, 형식 및 역할에 대한 지시사항을 system 메시지에 넣으세요. 모든 요청이 이를 입력 토큰으로 반복하므로 짧고 구체적으로 유지하세요.
  • 토큰 제한. max_tokens은 선택 사항이지만 제한은 저렴한 안전장치입니다. 없으면 단일 답변이 100,000토큰 컨텍스트 창의 나머지를 모두 사용할 수 있습니다.
  • 대화형 사용을 위한 스트리밍. 사람이 응답을 기다리고 있다면 stream: true를 설정하세요. 배치 작업의 경우 일반 요청이 더 간단합니다.
  • 429에 대한 재시도 규칙. 429를 실패가 아니라 기다리라는 신호로 처리하세요. 응답에 Retry-After: 5이 포함된 경우 해당 시간만큼 대기했다가 재시도하는 것이 올바른 조치입니다.
  • 요청 크기. 본문 제한은 8 MB입니다. 이는 일반 프롬프트가 필요로 하는 것보다 훨씬 많지만 붙여넣은 로그나 문서가 여기에 도달할 수 있습니다.

프롬프트는 학습에 사용되지 않습니다. 이는 내부 문서나 사용자 메시지를 전송할 계획이라면 중요합니다. 전송하는 내용에 대한 책임은 여전히 귀하에게 있으므로 모델에 필요하지 않은 비밀을 프롬프트에 넣지 마세요.

체험 후 충전

체험은 모든 것이 작동하는지 확인하기 위한 것입니다. 빌드할 준비가 되면 선불 크레딧을 추가하세요. 구독은 없습니다: 토큰 사용량에 따라 지불하며, 1M 입력 토큰당 $0.15, 1M 출력 토큰당 $0.50이며, 크레딧은 만료되지 않으므로 미사용 잔액은 월 말에 사라지지 않습니다.

$20부터 $500까지의 정수 금액이면 어떤 금액이든 가능합니다. $50 충전 시 5% 보너스, $100 시 10%, $200 시 15%가 추가됩니다. 간단한 예로, 10% 보너스가 포함된 $100 충전은 $110의 크레딧을 제공합니다. 2단계의 1,000토큰 프롬프트와 500토큰 답변 기준으로 각 요청 비용은 $0.0004이므로 $110은 275,000개의 요청을 커버합니다. 실제 프롬프트는 일반적으로 더 길므로 이 수치를 자신의 평균에 맞게 조정하세요.

일반 설정 오류 해결

증상잠재적 원인해결 방법
모든 호출에서 401 오류누락, 오타 또는 취소된 키Authorization: Bearer <key>를 추가 따옴표 없이 보내세요
404 또는 HTML 응답잘못된 경로, 보통 /v1 누락/v1로 끝나는 전체 Base URL 사용
모델을 찾을 수 없음다른 제공자에서 복사한 모델 이름uncensored 사용
rate_limited과 함께 429분당 요청 수 제한 초과속도를 줄이거나 충전하여 체험 제한에서 일반 제한으로 이동하세요.
concurrency 관련 429너무 많은 동시 요청동시 호출을 8개로 제한하세요 (체험 키는 2개)
429 및 Retry-After: 5일시적 과부하5초 대기 후 재시도
413 또는 본문 거부요청이 8 MB를 초과함프롬프트를 줄이거나 작업을 분할하세요

체험을 넘어 더 많은 크레딧이 필요할 때 가격 책정 페이지에는 충전 옵션이 나열되어 있습니다: $20부터 $500까지 정수 금액, 암호화폐(TRC20의 USDT, Base의 USDC)로 결제, $50부터 5% 보너스, $100부터 10%, $200부터 15% 보너스. 실패하거나 거부된 요청은 청구되지 않으며 프롬프트는 학습에 사용되지 않습니다.

질문과 답변

이것이 공식 MiniMax API입니까?

아니요. 이 서비스는 독립적으로 호스팅되는 OpenAI 호환 API로, 한 가지 오픈 웨이트 모델만 제공합니다. 합법적인 성인 사용자를 위해 콘텐츠 거부 없이 답변하도록 조정되었습니다. 이 서비스는 어떤 모델 벤더의 공식 API가 아니며, 여러 벤더를 라우팅하는 서비스도 아닙니다.

시도하려면 신용카드가 필요한가요?

아니요. 회원가입 후 API 키 페이지에서 한 번의 클릭으로 $0.50의 무료 체험 크레딧을 받을 수 있습니다. 이 크레딧은 7일 동안 유효하며, 사람당 한 번만 받을 수 있습니다.

요청에 사용할 모델 이름은 무엇인가요?

uncensored를 사용하세요. 이 서비스는 이 단일 모델 ID만 제공하며, GET /v1/models 요청을 보내면 해당 모델 ID를 확인할 수 있습니다.

나중에 크레딧을 더 추가하려면 어떻게 하나요?

$20부터 $500까지 원하는 금액으로 충전하세요. 보너스는 $50(+5%), $100(+10%), $200(+15%)부터 적용되며 크레딧은 만료되지 않습니다.

OpenAI SDK를 사용할 수 있나요?

네. base_url을 https://api.minimaxapikey.com/v1로 설정하고 키를 사용하며 모델로 uncensored를 지정하세요. 코드에 다른 변경 사항은 필요하지 않습니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.

API 키 받기