curl --request POST \
  --url https://direct.evolink.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-M3.1-Flash",
  "messages": [
    {
      "role": "user",
      "content": "Please introduce yourself."
    }
  ],
  "max_completion_tokens": 131072
}
'

{
  "id": "072514edea627212c7e226a55bcf4e2e",
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "0.05",
        "role": "assistant",
        "name": "MiniMax AI",
        "audio_content": "",
        "reasoning_content": "Let the ball cost x. Then 2x + 1 = 1.10, so x = 0.05."
      }
    }
  ],
  "created": 1792401901,
  "model": "MiniMax-M3.1-Flash",
  "object": "chat.completion",
  "usage": {
    "total_tokens": 281,
    "total_characters": 0,
    "prompt_tokens": 229,
    "completion_tokens": 52,
    "completion_tokens_details": {
      "reasoning_tokens": 49
    },
    "prompt_tokens_details": {
      "cached_tokens": 187
    }
  },
  "input_sensitive": false,
  "output_sensitive": false,
  "input_sensitive_type": 0,
  "output_sensitive_type": 0,
  "output_sensitive_int": 0,
  "base_resp": {
    "status_code": 0,
    "status_msg": ""
  }
}

Chat Completions API

MiniMax-M3.1-Flash - OpenAI 호환 API

OpenAI Chat Completions 프로토콜로 MiniMax-M3.1-Flash 모델을 호출합니다
멀티턴 대화: 컨텍스트를 활용한 단일 턴 및 멀티턴 대화를 지원합니다
시스템 프롬프트: role=system 메시지로 AI의 역할과 동작을 설정합니다
멀티모달 입력: content에 텍스트, 이미지, 비디오를 함께 전달할 수 있습니다
추론 모드: 항상 활성화되며 reasoning_effort로 추론 깊이를 조절합니다. 추론 내용은 reasoning_content로 반환되고 content에는 최종 답변만 포함됩니다
스트리밍: SSE 스트리밍 응답을 지원합니다
도구 호출: Function Calling을 지원합니다

스트리밍 응답: stream=true이면 Server-Sent Events로 응답합니다. 각 메시지는 data: {JSON} 형식이며 data: [DONE]으로 종료됩니다. choices[].delta에서 먼저 reasoning_content를 증분 반환한 뒤 content / tool_calls를 증분 반환합니다. stream_options.include_usage=true이면 종료 전에 usage가 포함된 청크를 추가로 반환합니다.

POST

chat

completions

curl --request POST \
  --url https://direct.evolink.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-M3.1-Flash",
  "messages": [
    {
      "role": "user",
      "content": "Please introduce yourself."
    }
  ],
  "max_completion_tokens": 131072
}
'

{
  "id": "072514edea627212c7e226a55bcf4e2e",
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "0.05",
        "role": "assistant",
        "name": "MiniMax AI",
        "audio_content": "",
        "reasoning_content": "Let the ball cost x. Then 2x + 1 = 1.10, so x = 0.05."
      }
    }
  ],
  "created": 1792401901,
  "model": "MiniMax-M3.1-Flash",
  "object": "chat.completion",
  "usage": {
    "total_tokens": 281,
    "total_characters": 0,
    "prompt_tokens": 229,
    "completion_tokens": 52,
    "completion_tokens_details": {
      "reasoning_tokens": 49
    },
    "prompt_tokens_details": {
      "cached_tokens": 187
    }
  },
  "input_sensitive": false,
  "output_sensitive": false,
  "input_sensitive_type": 0,
  "output_sensitive_type": 0,
  "output_sensitive_int": 0,
  "base_resp": {
    "status_code": 0,
    "status_msg": ""
  }
}

BaseURL: 기본 BaseURL은 https://direct.evolink.ai이며, 텍스트 모델과 장시간 연결을 더 잘 지원합니다. https://api.evolink.ai는 멀티모달 서비스의 기본 엔드포인트이자 텍스트 모델의 대체 주소 역할을 합니다.

인증

Authorization

string

header

필수

모든 API에는 Bearer Token 인증이 필요합니다

API Key 발급:

API Key 관리 페이지에서 API Key를 발급받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

enum<string>

필수

대화 모델 이름

사용 가능한 옵션:

MiniMax-M3.1-Flash

예시:

"MiniMax-M3.1-Flash"

messages

(System Message · object | User Message · object | Assistant Message · object | Tool Message · object)[]

필수

대화 메시지 목록, 멀티턴 대화 지원

역할마다 메시지의 필드 구조가 다르므로 해당 역할을 선택하여 확인하세요

Minimum array length: 1

System Message
User Message
Assistant Message
Tool Message

Show child attributes

reasoning_effort

enum<string>

기본값:max

추론 깊이입니다. 기본값은 max이며, 높은 단계일수록 일반적으로 추론 토큰 사용량과 응답 시간이 증가합니다.

사용 가능한 옵션:

low,

medium,

high,

xhigh,

max

예시:

"high"

thinking

object

추론 모드입니다. MiniMax-M3.1-Flash는 항상 추론을 수행합니다. adaptive만 지원하며 생략할 수 있습니다.

Show child attributes

reasoning_split

enum<boolean>

기본값:true

추론 내용을 별도로 반환할지 여부입니다. true만 지원하며 추론 내용은 reasoning_content로 반환됩니다. 생략할 수 있습니다.

사용 가능한 옵션:

true

temperature

number

기본값:1

출력의 무작위성을 제어하는 샘플링 온도입니다

설명:

범위: [0, 2], 기본값: 1
값이 낮을수록 출력이 더 결정적이고, 높을수록 더 다양해집니다

권장 사항: temperature와 top_p를 동시에 조정하지 마세요

필수 범위: 0 <= x <= 2

예시:

1

top_p

number

기본값:0.95

누적 확률 샘플링 (Nucleus Sampling) 파라미터입니다

설명:

지정한 누적 확률에 도달하는 토큰 집합에서 샘플링합니다
예를 들어 0.95이면 누적 확률이 95%에 도달하는 토큰 집합에서 선택합니다
범위: [0, 1], 기본값: 0.95

권장 사항: temperature와 top_p를 동시에 조정하지 마세요

필수 범위: 0 <= x <= 1

예시:

0.95

max_completion_tokens

integer

생성할 토큰의 최대 수로, 추론과 답변을 모두 포함합니다

설명:

권장: 131,072 (128K), 최대: 524,288 (512K)
값이 너무 작으면 추론 단계에서 한도에 도달하여 finish_reason=length와 비어 있는 content가 반환될 수 있습니다

필수 범위: 1 <= x <= 524288

예시:

131072

stream

boolean

기본값:false

응답을 스트리밍 방식으로 반환할지 여부

true: 스트리밍 반환, SSE(Server-Sent Events)를 통해 내용을 청크 단위로 실시간 반환
false: 완전한 응답을 기다린 후 한 번에 반환(기본값)

예시:

false

stream_options

object

스트리밍 응답 옵션

stream=true일 때만 유효합니다

Show child attributes

tools

object[]

Function Calling을 위한 도구 정의 목록

각 도구는 이름, 설명, 파라미터 schema를 정의해야 합니다

Show child attributes

tool_choice

enum<string>

기본값:auto

도구 선택 전략입니다. 모델이 도구 호출 여부를 결정하는 auto만 지원합니다.

사용 가능한 옵션:

auto

max_tokens

integer

지원 중단

구버전 생성 길이 제한 파라미터

설명: 더 이상 사용되지 않으므로 max_completion_tokens를 사용하세요

필수 범위: x >= 1

enum<integer>

기본값:1

생성할 응답 수입니다. 1만 지원합니다.

사용 가능한 옵션:

1

응답

대화 생성 성공

string

대화 완료의 고유 식별자

예시:

"0668a381bdc3c0ded310e27c9a46d16e7"

model

string

실제 사용된 모델 이름

예시:

"MiniMax-M3.1-Flash"

object

enum<string>

응답 유형

사용 가능한 옵션:

chat.completion

예시:

"chat.completion"

created

integer

생성 타임스탬프(Unix 초)

예시:

1777026807

choices

object[]

대화 생성 선택 목록

Show child attributes

usage

object

Token 사용 통계 정보

Show child attributes

input_sensitive

boolean

입력 내용이 민감어 필터에 걸렸는지 여부. 입력이 심각하게 위반될 경우 인터페이스는 콘텐츠 위반 오류를 반환하며 응답 내용은 비어 있습니다

input_sensitive_type

integer

입력이 걸린 민감어 유형(input_sensitive가 true일 때 반환): 1 심각한 위반; 2 음란; 3 광고; 4 금지; 5 욕설; 6 폭력·테러; 7 기타

output_sensitive

boolean

출력 내용이 민감어 필터에 걸렸는지 여부

output_sensitive_type

integer

출력이 걸린 민감어 유형

base_resp

object

상태 코드 및 오류 상세

Show child attributes

output_sensitive_int

integer

출력에서 감지된 민감어 유형의 숫자 식별자입니다.

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

MiniMax-M3.1-Flash - OpenAI 호환 API

인증

본문

응답