소개
MiniMax M3.1 Flash API는 코딩 에이전트에 1,000,000토큰 입력과 이미지·영상 이해 기능을 제공하며 reasoning_effort로 모델 변경 없이 사고 깊이를 조절합니다. M3.1 Flash는 텍스트와 함께 image_url 및 video_url을 읽고 텍스트로 답하며 이 엔드포인트는 오디오를 받지 않고 영상은 플랫폼 합계 14MB 제한 안에서 인라인으로 전달해야 합니다.
핵심 기능 및 하이라이트
M3.1 Flash 추론은 항상 활성화되며 low, medium, high, xhigh, max 중 기본은 max이고 이 엔드포인트는 temperature, top_p, none을 허용하지 않습니다. M3.1 Flash max_tokens는 사고와 표시 답변의 합계 예산으로 기본 4,096과 상한 524,288을 가지며 stop은 각각 최대 32자의 시퀀스 4개까지 받습니다. M3.1 Flash 요청에는 메시지 최대 256개와 도구 정의 128개를 담고 이미지도 입력 토큰을 사용하므로 긴 대화와 미디어가 입력 예산을 공유합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
messages | 예 | M3.1 Flash 이력은 미디어와 이전 어시스턴트·도구 응답 전체를 순서대로 포함하며 영상은 14MB 이내 인라인으로 보내고 이 엔드포인트에는 오디오를 넣지 않습니다. 1개 이상 · 256개 이하 |
max_tokens | 아니요 | M3.1 Flash 사고와 표시 답변의 합계 상한이며 기본은 4,096, 최대는 524,288이고 너무 작으면 본문 전에 사고로 예산을 소진할 수 있습니다. |
reasoning_effort | 아니요 | M3.1 Flash는 low, medium, high, xhigh 또는 기본 max를 선택하며 추론을 끌 수 없고 높은 노력은 출력 토큰과 시간을 더 사용할 수 있습니다. |
stop | 아니요 | M3.1 Flash 답변은 일치하는 중단 시퀀스 앞에서 끝나고 해당 시퀀스는 반환하지 않으며 문자열 하나 또는 각각 최대 32자의 문자열 4개까지 지정합니다. 1자 이상 · 1개 이상 · 4개 이하 |
tools | 아니요 | M3.1 Flash에 OpenAI 형식 함수 정의를 최대 128개 제시하며 실행은 애플리케이션이 담당하므로 인자 스키마를 명확하게 작성해야 합니다. 128개 이하 |
parallel_tool_calls | 아니요 | M3.1 Flash가 독립적인 도구 호출을 함께 제안하도록 허용하며 개별 실행 결과를 반환할 때 각 호출 ID를 보존해야 합니다. 기본값: |
tool_choice | 아니요 | M3.1 Flash 도구 선택은 auto, none, required 또는 함수명이며 이 필드의 none은 도구 선택만 끄고 모델 추론은 끄지 않습니다. |
response_format | 아니요 | M3.1 Flash 결과를 텍스트나 구조화 JSON으로 요청하며 진단 기록 또는 실행용 입력으로 쓰기 전에 반환 객체를 검증해야 합니다. |
요금
입력 $0.15 / 출력 $0.60 100만 토큰당
활용 사례
이 M3.1 Flash 예제는 다음 진단 도구 호출을 요청하므로 각 제안이 제공한 문제 증거에서 도출되는지 확인해야 합니다. M3.1 Flash 도구 반복에서는 추론 내용과 도구 호출을 포함한 어시스턴트 응답 전체를 보존하고 일치하는 tool_call_id로 실행 결과를 반환하며 인자 검증과 실행은 애플리케이션이 담당합니다.
프롬프트 가이드 및 실전 팁
M3.1 Flash 사용량은 입력, 캐시 입력, 출력을 구분하며 이미지와 영상 처리는 입력 토큰으로, 사고는 출력 예산으로 계산하고 현재 요율은 이 페이지에서 확인합니다. SpicyAPI는 M3.1 Flash에 별도 콘텐츠 필터를 추가하지 않으며 모델이 응답을 결정하므로 미디어 입력이나 높은 사고 단계로 NSFW 출력을 보장하지 않습니다.
minimax/m3.1-flash/chat
API 빠른 시작
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "minimax/m3.1-flash/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
