MiniMax 매개변수 및 프로토콜 차이

호환 프로토콜에서 MiniMax 모델의 매개변수 차이와 사용 방법을 알아봅니다.

MiniMax는 이 페이지에 따라 매개변수를 조정하세요. 전체 구조: Chat Completions, Responses, Messages.

대상 모델

모델	적용 범위
MiniMax-M3.1-Flash	Chat, Responses, Messages. 추론 항상 활성화, 강도 조절 가능
MiniMax-M3	Chat, Responses, Messages. 추론 전환 가능, 기본값은 프로토콜별로 다름

Chat Completions 차이

필드	차이 설명
`thinking.type`	둘 다 기본 `adaptive`. M3은 `disabled`로 끄고 M3.1-Flash는 `disabled`에 `400` 반환
`reasoning_effort`	M3.1-Flash는 `low/medium/high/xhigh/max`, 기본 `max`, `none`는 `400`. M3은 무시
`reasoning_split`	MiniMax 확장: `true`은 `reasoning_content`에 추론 분리, `false`는 `content`의 `<think>` 태그에 배치. 추론 스위치가 아니며 M3.1-Flash는 `false` 미지원
`temperature`, `top_p`	값 무시, 실제 각각 `1`, `0.95`. 단 `top_p`를 보내면 `(0,1]` 범위는 준수
`presence_penalty`, `frequency_penalty`, `logit_bias`	전달값 무시
`max_completion_tokens`	최소 `1`, 최대 `524288`, 권장 `131072`. 추론과 답변 포함, 권장값은 기본값과 다름
`service_tier`	M3은 `standard/priority`, 기본 `standard`. M3.1-Flash는 미지원
이전 assistant 메시지	도구 대화는 `reasoning_content`, `content`, `tool_calls` 포함 전체 재전송. 단순 호출은 추론 필드가 없을 수 있음

Responses 차이

필드	차이 설명
`reasoning.effort`	M3.1-Flash는 항상 추론, `low/medium/high/xhigh/max`, 기본 `max`, `none`는 `400`. M3은 기본 꺼짐, `none` 이외로 켜지만 깊이는 조절하지 않음
`temperature`, `top_p`	값 무시, 실제 각각 `1`, `0.95`. 단 `top_p`를 보내면 `(0,1]` 범위는 준수
`max_output_tokens`	추론 토큰도 예산에 포함. 작으면 `incomplete` 및 최종 답변 message 누락 가능
`tool_choice`	`auto`만 지원
`text.format.type`	현재 `text`만 정의
`store`	요청값 무시, 응답 `false` 고정
`previous_response_id`, `conversation`	요청값 무시, 응답 `null` 고정. reasoning과 도구 포함 전체 입출력 이력 재전송
`parallel_tool_calls`, `truncation`	요청값 무시, 응답 각각 `true`, `disabled` 고정
`service_tier`	M3은 `standard/priority`, 기본 `standard`. M3.1-Flash는 미지원
서버 검색	Beta 도구, `tools`에 `type: "web_search"` 사용

Messages 차이

필드	차이 설명
`thinking.type`	M3.1-Flash는 항상 켜짐, `adaptive`만, `disabled`은 `400`. M3 기본 꺼짐, `adaptive`으로 켜고 `disabled`로 끔
`output_config.effort`	M3.1-Flash는 `low/medium/high/xhigh/max`, 기본 `max`, `none`는 `400`. M3 무시
`temperature`, `top_p`	값 무시, 실제 각각 `1`, `0.95`. 단 `top_p`를 보내면 `(0,1]` 범위는 준수
`top_k`, `stop_sequences`, `mcp_servers`, `context_management`, `container`	전달값 무시
`max_tokens`	최소 `1`, 최대 `524288`, 권장 `131072`, 추론 토큰도 포함
`tool_choice.type`	`auto`만 지원
`service_tier`	M3은 `standard/priority`, 기본 `standard`. M3.1-Flash는 미지원
이전 assistant 콘텐츠 블록	thinking, text, tool_use와 서명 `signature` 모두 보존. 단순 호출에는 thinking이 없을 수 있음
서버 검색	Beta 도구, `type: "web_search_20250305"`, `name: "web_search"` 사용

캐시 차이

필드	차이 설명
자동 접두사 캐시	입력 512토큰 이상, 표시 불필요. 도구 정의, system, 이력 순으로 일치
`cache_control`	두 모델 모두 Anthropic 명시적 캐시 표시 미지원
Responses의 `prompt_cache_key`	프롬프트 캐시 라우팅 ID로 사용 가능

미디어 입력 차이

입력	프로토콜 블록	차이 설명
이미지	`image_url`	Chat: `image_url.url`은 공개 URL 또는 Base64 Data URL
동영상	`video_url`	Chat: `video_url.url`은 공개 URL, Base64 Data URL 또는 원본 `mm_file://{file_id}` 참조
이미지	`input_image`	Responses: `image_url`은 URL / Base64 문자열 또는 `url`, `detail` 객체
동영상	`input_video`	Responses: `video_url`은 URL / Base64 문자열 또는 `url`, `fps`, `detail`, `max_long_side_pixel` 객체
이미지	`image`	Messages: `source.type=url`이면 `url`, `source.type=base64`이면 `media_type`, `data`
동영상	`video`	Messages 확장: `source`은 URL, Base64, 원본 동영상 참조와 프레임 추출 옵션 지원

필드	차이 설명
`detail`	`low/default/high`, 기본 `default`. Chat은 미디어 객체, Responses는 URL 객체, Messages는 `source` 내부
`fps`	프레임 추출 빈도 `0.2～5`, 기본 `1`. Chat / Responses는 동영상 블록의 `video_url.fps`, Messages는 `source.fps`
`max_long_side_pixel`	이미지/프레임 긴 변 제한. Chat 미디어, Responses 동영상 URL 객체, Messages `source` 내부
미디어 크기	Chat / Messages: 이미지 10 MB, URL / Base64 동영상 50 MB, 본문 64 MB. 원본 Files API 동영상 업로드 512 MB

mm_file://은 MiniMax 원본 업로드 API 참조입니다. 이 페이지는 AGTCloud 업로드 API를 제공하지 않습니다.

호출 예제

MODEL_ID을 전체 ID로 바꾸고 본인 API Key를 사용하세요. 예제는 M3.1-Flash 강도 설정이며 M3은 위 표를 참고하세요.

curl 'https://api.agtcloud.ai/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "API 시간 초과 진단 방법을 세 가지로 설명하세요"}],
    "thinking": {"type": "adaptive"},
    "reasoning_effort": "low",
    "max_completion_tokens": 4096
  }'