curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-M3.1-Flash",
  "max_tokens": 131072,
  "messages": [
    {
      "role": "user",
      "content": "Hello! How can you help me?"
    }
  ]
}
'

{
  "id": "072514f09a86ce2abb0c5c3930f924fb",
  "type": "message",
  "role": "assistant",
  "model": "MiniMax-M3.1-Flash",
  "content": [
    {
      "thinking": "Let the ball cost x. Then 2x + 1 = 1.10, so x = 0.05.",
      "signature": "84eddf556420e0cc237f8f50212216543e8add2ddd931c9a271d2a5a95689333",
      "type": "thinking"
    },
    {
      "text": "0.05",
      "type": "text"
    }
  ],
  "usage": {
    "input_tokens": 55,
    "output_tokens": 66,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 174,
    "output_tokens_details": {
      "thinking_tokens": 63
    }
  },
  "stop_reason": "end_turn",
  "base_resp": {
    "status_code": 0,
    "status_msg": ""
  }
}

Messages API

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

Anthropic Messages 프로토콜로 MiniMax-M3.1-Flash 모델을 호출합니다
요청 및 응답 구조가 Anthropic API와 호환됩니다
멀티모달 대화: content에 텍스트, 이미지, 비디오 콘텐츠 블록을 전달할 수 있습니다
시스템 프롬프트: 최상위 system 필드로 전달합니다
추론 모드: 항상 활성화되며 output_config.effort로 추론 깊이를 조절합니다. 추론 내용은 content[type=thinking] 블록으로 반환됩니다
스트리밍: SSE 이벤트 스트림을 지원합니다
도구 호출: Anthropic tool_use / tool_result 흐름과 호환됩니다

스트리밍 이벤트: message_start → content_block_start → content_block_delta (thinking_delta / signature_delta / text_delta / input_json_delta) → content_block_stop → message_delta → message_stop 순서이며 중간에 ping이 포함될 수 있습니다. 최종 사용량은 message_delta 이벤트의 usage를 기준으로 합니다.

POST

messages

curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-M3.1-Flash",
  "max_tokens": 131072,
  "messages": [
    {
      "role": "user",
      "content": "Hello! How can you help me?"
    }
  ]
}
'

{
  "id": "072514f09a86ce2abb0c5c3930f924fb",
  "type": "message",
  "role": "assistant",
  "model": "MiniMax-M3.1-Flash",
  "content": [
    {
      "thinking": "Let the ball cost x. Then 2x + 1 = 1.10, so x = 0.05.",
      "signature": "84eddf556420e0cc237f8f50212216543e8add2ddd931c9a271d2a5a95689333",
      "type": "thinking"
    },
    {
      "text": "0.05",
      "type": "text"
    }
  ],
  "usage": {
    "input_tokens": 55,
    "output_tokens": 66,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 174,
    "output_tokens_details": {
      "thinking_tokens": 63
    }
  },
  "stop_reason": "end_turn",
  "base_resp": {
    "status_code": 0,
    "status_msg": ""
  }
}

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

인증

Authorization

string

header

필수

모든 인터페이스는 Bearer Token 인증이 필요합니다

API Key 발급:

API Key 관리 페이지에 방문하여 API Key를 발급받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

참고: EvoLink는 /v1/messages에 대해 Bearer Token 인증을 통일적으로 사용합니다.

본문

application/json

model

enum<string>

필수

호출할 모델

사용 가능한 옵션:

MiniMax-M3.1-Flash

예시:

"MiniMax-M3.1-Flash"

messages

object[]

필수

대화 메시지 목록, 턴마다 user / assistant 교대

설명:

최소 1개의 메시지를 포함해야 함
마지막 메시지는 일반적으로 role=user

Minimum array length: 1

Show child attributes

max_tokens

integer

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

설명:

권장: 131,072 (128K), 최대: 524,288 (512K)
값이 너무 작으면 추론 단계에서 한도에 도달하여 text 내용 없이 stop_reason=max_tokens가 반환될 수 있습니다

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

예시:

131072

system

AI의 역할과 동작을 설정하는 시스템 프롬프트입니다. 문자열 또는 텍스트 콘텐츠 블록 배열을 지원하며 최상위 system 필드로 전달합니다.

예시:

"You are a helpful assistant."

temperature

number

기본값:1

샘플링 온도입니다

설명:

범위: [0, 2], 기본값: 1
값이 높을수록 출력이 다양해지고, 낮을수록 더 결정적입니다
temperature와 top_p를 동시에 조정하지 않는 것을 권장합니다

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

예시:

1

top_p

number

기본값:0.95

누적 확률 샘플링 임계값입니다

설명:

범위: [0, 1], 기본값: 0.95
temperature와 top_p를 동시에 조정하지 않는 것을 권장합니다

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

예시:

0.95

stream

boolean

기본값:false

SSE 스트리밍으로 반환할지 여부

true: Server-Sent Events 스트리밍 반환
false: 완전한 응답 후 한 번에 반환(기본값)

예시:

false

thinking

object

추론 모드입니다. MiniMax-M3.1-Flash는 항상 추론을 수행합니다. adaptive만 지원하며 생략할 수 있습니다. 추론 내용은 type="thinking" 블록으로 반환되며 출력 토큰 요금이 적용됩니다.

Show child attributes

output_config

object

출력 설정

Show child attributes

tools

object[]

도구 정의 목록

설명:

Anthropic tool 정의 규범을 따름
input_schema는 JSON Schema 객체를 사용

Show child attributes

tool_choice

object

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

Show child attributes

metadata

object

요청 메타데이터

Show child attributes

응답

메시지 객체

Anthropic 스타일의 메시지 응답

string

메시지 고유 ID

type

enum<string>

응답 객체 유형

사용 가능한 옵션:

message

role

enum<string>

사용 가능한 옵션:

assistant

model

string

실제 사용된 모델

예시:

"MiniMax-M3.1-Flash"

content

object[]

응답 콘텐츠 블록 목록입니다

포함될 수 있는 블록 유형:

thinking: 추론 과정 (간단한 질문에서는 생성되지 않을 수 있습니다)
text: 최종 답변 텍스트
tool_use: 모델이 시작한 도구 호출

Show child attributes

stop_reason

enum<string>

정지 사유

end_turn: 자연스러운 종료
max_tokens: max_tokens 상한 도달
tool_use: 모델이 도구 호출을 트리거

사용 가능한 옵션:

end_turn,

max_tokens,

tool_use

usage

object

Token 사용 통계(Anthropic 규범)

Show child attributes

base_resp

object

상태 코드 및 오류 상세

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

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

인증

본문

응답