MiniMax Chat Completions

BeatAPI 키 하나로 OpenAI Chat Completions 엔드포인트에서 MiniMax M3와 M3.1 Flash를 호출합니다.

• 현재 모든 MiniMax 모델이 엔드포인트 POST /v1/chat/completions 하나를 사용합니다. model만 바꿔 전환하세요.
• 스트리밍과 함수 호출, 1M 토큰 컨텍스트 창. MiniMax-M3는 프롬프트가 512,000토큰을 넘으면 요금이 두 배가 되고, MiniMax-M3.1-Flash는 프롬프트 길이와 관계없이 같은 요금입니다.
• OpenAI SDK와 호환됩니다. 기본 URL을 바꾸고 BeatAPI 키를 사용하세요.
• 같은 모델이 OpenAI Responses와 Anthropic Messages에서도 응답합니다.

API Explorer에서 이 엔드포인트를 엽니다. BeatAPI API 키를 입력하고 전송하세요. 실제 호출이며 본인 잔액에서 과금됩니다.

모델

model에 다음 ID 중 하나를 보내세요. 각각 별개의 모델이며, 서로의 별칭으로 취급하지 마세요.

• 가격은 할인이 적용된 기본 등급입니다. 롱 컨텍스트 등급, 캐시 입력 요금, 캐시 쓰기는 이 표에 없습니다. 가격표를 참고하세요.
• —는 카탈로그에서 해당 수치를 공개하지 않는다는 뜻입니다.

빠른 시작

서버에 openai 패키지를 설치하고 키는 BEATAPI_API_KEY에 보관하세요. 브라우저 코드에는 절대 넣지 마세요. 아래는 요청 예시이며 실제로 기록된 모델 출력이 아닙니다.

choices[0].message.content에서 답변을 읽은 다음 finish_reason과 usage를 확인하세요. HTTP 200만으로는 답변이 작업 요구를 충족한다고 볼 수 없으니 애플리케이션에서 검증하세요. 텍스트 요청은 바로 반환되므로 /v1/tasks를 폴링하지 마세요.

curl --request POST \
  --url https://direct.beatapi.io/v1/chat/completions \
  --header "Authorization: Bearer $BEATAPI_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "MiniMax-M3",
  "max_tokens": 2000,
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'

엔드포인트와 인증

POST https://direct.beatapi.io/v1/chat/completions

요청 파라미터

표준 OpenAI Chat Completions 필드를 받습니다. 요청 형식이 호환된다고 해서 모든 모델별 옵션이 지원되는 것은 아니므로, 사용하는 옵션은 직접 테스트하세요.

롱 컨텍스트 가격

MiniMax-M3는 프롬프트가 512,000토큰을 넘으면 상위 요금으로 바뀌며, 상위 요금은 요청 전체에 적용되어 입력, 캐시 입력, 출력이 모두 두 배가 됩니다. 점진적으로 오르지 않고 계단식으로 바뀌므로, 기준을 한 토큰만 넘어도 요청 전체가 상위 요금으로 과금됩니다.

위 모델 표와 가격표의 MiniMax-M3 가격은 기준 미만 프롬프트에 적용되는 기본 요금입니다. 긴 대화 기록을 보내기 전에 전체 프롬프트 크기를 추정하세요.

MiniMax-M3.1-Flash에는 롱 컨텍스트 등급이 없습니다. 모델 표의 입력·출력 가격이 1,000,000토큰 컨텍스트 창까지 프롬프트 길이와 관계없이 적용됩니다. 캐시 입력은 1M 토큰당 $0.006입니다.

응답

스트리밍하지 않는 호출은 JSON 객체 하나를 반환합니다. 아래는 축약한 예시입니다.

{
  "id": "chatcmpl-example",
  "object": "chat.completion",
  "created": 1791993600,
  "model": "MiniMax-M3",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Retry with exponential backoff and jitter, and make every handler idempotent."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 19,
    "completion_tokens": 16,
    "total_tokens": 35
  }
}

응답 필드

스트리밍

"stream": true를 설정하세요. 답변은 chat.completion.chunk 이벤트로 도착하고 data: [DONE]로 끝납니다.

• 응답은 text/event-stream이며, 스트리밍하지 않으면 application/json입니다.
• 텍스트는 choices[0].delta.content로 도착합니다. 추론 모델은 delta.reasoning_content로 추론을 먼저 보냅니다.
• 모델 호출 전에 발생한 실패는 스트림 이벤트가 아니라 HTTP 상태와 함께 일반 JSON 오류로 반환됩니다.
• 명시적인 시간 제한을 설정하고, 스트리밍 응답은 안전하게 다시 연결하세요.

data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":"Retry"},"finish_reason":null}]}
data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":" with backoff"},"finish_reason":null}]}
data: {"id":"chatcmpl-example","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}
data: [DONE]

오류

HTTP 오류 요약

인증, 라우팅, 요청 속도 제한, 알 수 없는 모델 실패는 모델 호출 전에 BeatAPI 오류 형식(error.code, error.message, retryable, request_id)으로 응답합니다. 그 밖의 모든 실패는 OpenAI SDK 형식 {"error": {"message", "type", "code"}}를 유지하며, 코드는 error.code에 있고 요청 id는 message로 끝납니다. 오류를 참고하세요.

전체 코드 표와 재시도 정책: 오류.

참고

• MiniMax는 OpenAI Responses와 Anthropic Messages에서도 응답합니다.
• 이 페이지는 MiniMax 텍스트 모델을 다룹니다. MiniMax H3 영상 모델은 영상 API를 사용합니다.
• low부터 high까지의 reasoning_effort는 MiniMax-M3.1-Flash에서 추론 토큰을 생성하는 것으로 확인되었습니다. 추론 토큰은 출력으로 과금되므로, max_tokens는 답변뿐 아니라 추론까지 고려해 잡으세요.
• MiniMax-M3.1-Flash에 이미지를 보내려면 image_url 콘텐츠 파트에 base64 데이터 URL로 인라인 포함하세요.
• API 키는 신뢰할 수 있는 서버에 두고, 응답의 요청 ID를 기록하며, 429, 500, 503만 재시도하세요.