MiniMax M3

요청 ID MiniMax-M3

프로토콜

POST /v1/chat/completions · Chat Completions 예시
POST /v1/messages · Anthropic Messages 예시
POST /v1/messages/count_tokens · Count Tokens 예시

인증

요청에는 API 키 관리의 API 키가 필요합니다. JSON 요청은 Content-Type: application/json을 지정하세요.

Authorization: Bearer YOUR_API_KEY
Anthropic Messages · x-api-key: YOUR_API_KEY

요청 매개변수

`POST /v1/chat/completions`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `MiniMax-M3`로 설정하세요.
`messages`	`object[]`	필수	대화 순서대로 메시지를 보냅니다. 각 메시지에는 `role`과 `content`가 들어갑니다.
`messages[].content`	`string / object[]`	조건부	메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다.
`stream`	`boolean`	선택	`true`는 SSE 스트리밍, `false`는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다.
`max_completion_tokens`	`integer`	조건부	해당하는 추론 토큰을 포함한 생성 토큰 수의 상한입니다. 이 필드를 지원하는 엔드포인트에서 사용하세요.
`max_tokens`	`integer`	조건부	출력 토큰 제한을 위한 호환 필드입니다. 엔드포인트에 따라 이 필드와 `max_completion_tokens` 중 하나를 사용하세요.
`temperature`	`number`	조건부	샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다.
`top_p`	`number`	조건부	누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요.
`response_format`	`object`	조건부	구조화된 출력에는 `type: json_object`를 사용하거나, 스키마를 지원할 때 `type: json_schema`와 `json_schema`를 함께 지정하세요.
`tools`	`object[]`	조건부	모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다.
`tool_choice`	`string / object`	조건부	도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요.

`POST /v1/messages`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `MiniMax-M3`로 설정하세요.
`messages`	`object[]`	필수	`user`와 `assistant` 메시지를 순서대로 보내세요. 시스템 지침은 최상위 `system`에 넣습니다.
`messages[].content`	`string / object[]`	필수	메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다.
`system`	`string / object[]`	선택	시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다.
`max_tokens`	`integer`	필수	출력 토큰 수의 상한입니다. 허용 범위는 모델과 엔드포인트에 따라 다릅니다.
`stream`	`boolean`	선택	`true`는 SSE 스트리밍, `false`는 일반 JSON 응답을 요청합니다. 지원 모드는 엔드포인트에 따라 다릅니다.
`temperature`	`number`	조건부	샘플링의 무작위성을 조절합니다. 허용값과 적용 여부는 모델 및 엔드포인트에 따라 다릅니다.
`top_p`	`number`	조건부	누적 확률로 샘플링 후보를 제한합니다. 모델과 엔드포인트에서 지원할 때 사용하세요.
`tools`	`object[]`	조건부	모델이 호출할 수 있는 도구 정의입니다. 도구 유형과 매개변수 형식은 프로토콜과 엔드포인트에 따라 다릅니다.
`tool_choice`	`object`	조건부	도구 선택을 제어합니다. 강제 호출이나 이름 지정은 해당 기능을 지원하는 엔드포인트에서만 사용하세요.

`POST /v1/messages/count_tokens`

필드	유형	필수 여부	설명
`model`	`string`	필수	모델 ID를 `MiniMax-M3`로 설정하세요.
`messages`	`object[]`	필수	`user`와 `assistant` 메시지를 순서대로 보내세요. 시스템 지침은 최상위 `system`에 넣습니다.
`messages[].content`	`string / object[]`	필수	메시지 본문입니다. 일반 텍스트 또는 프로토콜에서 정의한 콘텐츠 블록 배열을 사용합니다.
`system`	`string / object[]`	선택	시스템 지침입니다. 텍스트 또는 텍스트 블록 배열로 전달합니다.
`tools`	`object[]`	조건부	입력 토큰 계산에 포함할 도구 정의입니다. 실제 Messages 요청과 같은 도구를 전달하세요.

요청 예시

API Key를 로컬 환경 변수 ICODEEASY_API_KEY에 설정하고 직접 HTTP 호출을 허용하는 엔드포인트를 선택하세요. 특정 클라이언트가 필요한 경우 해당 설정 가이드를 따르세요.

Chat Completions

bash

curl -sS 'https://api.icodeeasy.cc/v1/chat/completions' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "MiniMax-M3",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ],
  "stream": false
}'

Anthropic Messages

bash

curl -sS 'https://api.icodeeasy.cc/v1/messages' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "MiniMax-M3",
  "max_tokens": 256,
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

Count Tokens

bash

curl -sS 'https://api.icodeeasy.cc/v1/messages/count_tokens' \
  -H "x-api-key: $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'anthropic-version: 2023-06-01' \
  --data '{
  "model": "MiniMax-M3",
  "messages": [
    {
      "role": "user",
      "content": "Explain how a rainbow forms in one sentence."
    }
  ]
}'

응답 읽기

Chat Completions · choices[].message.content에서 텍스트를 읽으세요. SSE 스트림에서는 choices[].delta로 새 출력이 전송됩니다. JSON · SSE
Anthropic Messages · content[]에서 유형이 text인 블록을 읽으세요. 스트리밍 시 SSE 콘텐츠 블록 이벤트를 순서대로 처리하세요. JSON · SSE
Count Tokens · input_tokens에서 입력 토큰 수를 읽으세요.

전체 연동 가이드

기능 및 제한

streaming · 지원
tool_calling · 조건부 지원 — 호환 프로토콜과 요청 형식에 따라 달라집니다
image_input · 공개되지 않음
video_input · 미지원

모델 기능 카탈로그 · 가격 보기

MiniMax 설정

Claude 호환 클라이언트에서 MiniMax 모델, Base URL과 API 키를 구성하고 연결 테스트와 일반적인 문제 진단을 수행합니다.

Chat Completions

OpenAI Chat 형식으로 대화를 보냅니다. 요청 전에 모델과 선택한 엔드포인트가 Chat을 지원하는지 확인하세요.

Anthropic Messages

Anthropic Messages 형식으로 HTTP 요청을 보냅니다. Claude Code 설정은 관련 가이드를 참고하세요.

가입하고 API Key 받기