MiniMax-M2.5 - 전체 API 레퍼런스

curl --request POST \
  --url https://direct.evolink.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-M2.5",
  "messages": [
    {
      "role": "user",
      "content": "자기소개를 해주세요"
    }
  ]
}
'

{
  "id": "cmpl-04ea926191a14749b7f2c7a48a68abc6",
  "model": "MiniMax-M2.5",
  "object": "chat.completion",
  "created": 1698999496,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "안녕하세요! 무엇을 도와드릴까요?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 292,
    "total_tokens": 300
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error",
    "param": "model"
  }
}

{
  "error": {
    "code": 404,
    "message": "Specified model not found",
    "type": "not_found_error",
    "param": "model",
    "fallback_suggestion": "MiniMax-M2.5"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Upstream AI service unavailable",
    "type": "upstream_error",
    "fallback_suggestion": "try different model"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

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-M2.5",
  "messages": [
    {
      "role": "user",
      "content": "자기소개를 해주세요"
    }
  ]
}
'

{
  "id": "cmpl-04ea926191a14749b7f2c7a48a68abc6",
  "model": "MiniMax-M2.5",
  "object": "chat.completion",
  "created": 1698999496,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "안녕하세요! 무엇을 도와드릴까요?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 292,
    "total_tokens": 300
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/billing"
  }
}

{
  "error": {
    "code": 403,
    "message": "Access denied for this model",
    "type": "permission_error",
    "param": "model"
  }
}

{
  "error": {
    "code": 404,
    "message": "Specified model not found",
    "type": "not_found_error",
    "param": "model",
    "fallback_suggestion": "MiniMax-M2.5"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 502,
    "message": "Upstream AI service unavailable",
    "type": "upstream_error",
    "fallback_suggestion": "try different model"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

BaseURL: 기본 BaseURL은 https://direct.evolink.ai이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. https://api.evolink.ai는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다.

인증

Authorization

string

header

필수

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

API 키 받기:

API 키 관리 페이지를 방문하여 API 키를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

enum<string>

필수

채팅 모델 이름

사용 가능한 옵션:

MiniMax-M2.5

예시:

"MiniMax-M2.5"

messages

object[]

필수

대화 메시지 목록, 다중 턴 대화 지원

Minimum array length: 1

Show child attributes

max_tokens

integer

생성 콘텐츠의 최대 토큰 수, 상한은 2048

참고:

상한을 초과하는 콘텐츠는 잘립니다
length 이유로 생성이 중단된 경우 이 값을 높여보세요

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

예시:

2048

stream

boolean

스트리밍 모드로 응답을 반환할지 여부

true: 스트리밍 응답, 실시간으로 청크 단위로 콘텐츠 반환
false: 완전한 응답을 기다린 후 반환

예시:

false

temperature

number

샘플링 온도, 출력의 무작위성 제어

참고:

낮은 값(예: 0.1): 더 확정적이고 집중된 출력
높은 값(예: 0.9): 더 무작위적이고 창의적인 출력
범위: (0, 1], 0 제외

필수 범위: x <= 1

예시:

0.7

top_p

number

Nucleus Sampling 매개변수

참고:

누적 확률에서 토큰 샘플링 제어
예: 0.9는 누적 확률 90%에 도달하는 토큰에서 선택을 의미
범위: (0, 1], 0 제외

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

필수 범위: x <= 1

예시:

0.9

enable_search

boolean

웹 검색 활성화 여부

true: 웹 검색 활성화, 모델이 필요에 따라 인터넷에서 최신 정보를 검색합니다
false: 웹 검색 비활성화

예시:

true

search_options

object

웹 검색 옵션, enable_search: true 필요

Show child attributes

응답

채팅 완성 성공

string

채팅 완성의 고유 식별자

예시:

"cmpl-04ea926191a14749b7f2c7a48a68abc6"

model

string

실제 사용된 모델 이름

예시:

"MiniMax-M2.5"

object

enum<string>

응답 유형

사용 가능한 옵션:

chat.completion

예시:

"chat.completion"

created

integer

생성 타임스탬프

예시:

1698999496

choices

object[]

채팅 완성 선택 목록

Show child attributes

usage

object

토큰 사용 통계

Show child attributes

MiniMax-M3 - Anthropic 호환 API GLM-5.2 - OpenAI 호환 API

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

MiniMax-M2.5 - 전체 API 레퍼런스

인증

본문

응답