curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-M3.1-Flash",
  "input": "Explain recursion in one sentence.",
  "max_output_tokens": 131072
}
'

{
  "id": "0725233a85e23431681447327cbcd9d2",
  "object": "response",
  "created_at": 1792405562,
  "model": "MiniMax-M3.1-Flash",
  "status": "completed",
  "output": [
    {
      "id": "0725233a85e23431681447327cbcd9d2_rs",
      "type": "reasoning",
      "status": "completed",
      "summary": [],
      "content": [
        {
          "type": "reasoning_text",
          "text": "We need solve CRT. Need only n. Compute. n=3 mod7, 5 mod11,7 mod13. Product 1001. Let's solve.\n\nUse n=3+7a. mod11: 3+7a=5 =>7a=2 mod11. inverse7=8 (56=1), a=16=5 mod11. a=5+11b. n=38+77b. mod13: 38+77b = 12+12b mod13 (77=12,38=12) equals7 =>12b=-5=8 mod13. inverse12=12, b=96 mod13 =5? 91 remainder5. n=38+385=423. Check 423 mod7 3 (420), mod11 5 (418), mod13 7 (416). Smallest positive 423. Only n."
        }
      ],
      "encrypted_content": "Ahlub3JtYWwtcmVhc29uaW5nLTIwMjYxMDExjehfvIf2rUinmic9ZiAutly0DD3lHqWEni9ENDziUw0nX-F6VPZLM7x1NbRWbytJNcLH9XQIa-KLYgd-it6XmXzYLvck3xOPOG9wtDdxUnjdBhuuj9dkWrkx0kbK8MFT5UreZ7EcxoRZybrs3oELf2BK_WtDUFOm_FbZXKwNbg76pTCFDoRke0Er0GMWjmi5L8GE7hGnvvBQjHXrwQ88G0L2p6STay-n1FJ5prqz6Q4LEF-xu7FqGjDmh9haliI638ivcQ9XGo9_DLUrtKMh1K4UYN87j2H7vbjbJPJaw6oJ61ZF8Ngk1FSuHUvLB540QKwBJKnClMcvw-ih3CdKRdSTPRfIYlsYOkNCwEWrLwHarLTHG5HzeakMO_5usxOAvzXVDUKRIX7W62x9xKCnVl_Gp0E91dLtlU3U8j_ZZvYCj9pMvd_n_Ba82OUpFxvoXv2R2H1H8bfzztGg5E88fH6OMwoMS5OYa45nCoRFA11Bw7G8OEVqBiPzS48EY1JPjPTC5lBco0CUoeUAHPXeD7jmO-D3LhIL1-3erJ_mxP0ZeiCWUckYaFE2EliolooAHqkoVBmy5Q"
    },
    {
      "id": "0725233a85e23431681447327cbcd9d2_msg",
      "type": "message",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "423",
          "annotations": []
        }
      ]
    }
  ],
  "output_text": "423",
  "usage": {
    "input_tokens": 239,
    "output_tokens": 190,
    "total_tokens": 429,
    "input_tokens_details": {
      "cached_tokens": 174
    },
    "output_tokens_details": {
      "reasoning_tokens": 189
    }
  },
  "error": null,
  "incomplete_details": null,
  "instructions": null,
  "metadata": {},
  "tools": null,
  "tool_choice": "auto",
  "temperature": 1,
  "top_p": 0.95,
  "text": {
    "format": {
      "type": "text"
    }
  },
  "reasoning": {
    "effort": "medium",
    "summary": null
  },
  "max_output_tokens": 2048,
  "max_tool_calls": null,
  "parallel_tool_calls": true,
  "previous_response_id": null,
  "conversation": null,
  "store": false,
  "service_tier": null,
  "safety_identifier": null,
  "truncation": "disabled"
}

Responses API

MiniMax-M3.1-Flash - Responses API

OpenAI Responses 프로토콜로 MiniMax-M3.1-Flash 모델을 호출합니다
입력 형식: input에는 일반 텍스트 또는 메시지, 함수 호출, 함수 결과로 구성된 입력 항목 배열을 전달할 수 있습니다
멀티모달 입력: 메시지의 content에서 input_text, input_image, input_video 콘텐츠 블록을 함께 사용합니다
시스템 지시: instructions로 전달하며 맨 앞의 system 메시지와 동일합니다
추론 모드: 항상 활성화되며 reasoning.effort로 추론 깊이를 조절합니다. 추론 내용은 reasoning 출력 항목으로 반환됩니다
스트리밍: 의미별 SSE 이벤트를 사용하며 response.completed로 종료됩니다. [DONE]은 전송하지 않습니다
도구 호출: Function Calling을 지원합니다
컨텍스트 캐시: 동일한 접두사를 자동으로 재사용하며, 캐시 적중 토큰 수는 usage.input_tokens_details.cached_tokens에 표시됩니다

무상태: 응답을 저장하지 않으며 previous_response_id를 지원하지 않습니다. 다음 턴에서는 이전 output의 모든 항목을 원래 순서와 구조 그대로 input에 추가하세요. 추론 항목의 content, summary, encrypted_content 등 모든 필드를 유지해야 합니다. 도구 실행 후에는 함수 호출과 동일한 call_id를 가진 function_call_output 항목을 추가하세요.

스트리밍 이벤트: response.created, response.in_progress, response.output_item.added, response.content_part.added, response.reasoning_text.delta / response.reasoning_text.done, response.output_text.delta / response.output_text.done, response.content_part.done, response.output_item.done이 있으며, 종료 이벤트는 response.completed입니다. 각 이벤트에는 순서를 나타내는 sequence_number가 포함됩니다.

POST

responses

curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-M3.1-Flash",
  "input": "Explain recursion in one sentence.",
  "max_output_tokens": 131072
}
'

{
  "id": "0725233a85e23431681447327cbcd9d2",
  "object": "response",
  "created_at": 1792405562,
  "model": "MiniMax-M3.1-Flash",
  "status": "completed",
  "output": [
    {
      "id": "0725233a85e23431681447327cbcd9d2_rs",
      "type": "reasoning",
      "status": "completed",
      "summary": [],
      "content": [
        {
          "type": "reasoning_text",
          "text": "We need solve CRT. Need only n. Compute. n=3 mod7, 5 mod11,7 mod13. Product 1001. Let's solve.\n\nUse n=3+7a. mod11: 3+7a=5 =>7a=2 mod11. inverse7=8 (56=1), a=16=5 mod11. a=5+11b. n=38+77b. mod13: 38+77b = 12+12b mod13 (77=12,38=12) equals7 =>12b=-5=8 mod13. inverse12=12, b=96 mod13 =5? 91 remainder5. n=38+385=423. Check 423 mod7 3 (420), mod11 5 (418), mod13 7 (416). Smallest positive 423. Only n."
        }
      ],
      "encrypted_content": "Ahlub3JtYWwtcmVhc29uaW5nLTIwMjYxMDExjehfvIf2rUinmic9ZiAutly0DD3lHqWEni9ENDziUw0nX-F6VPZLM7x1NbRWbytJNcLH9XQIa-KLYgd-it6XmXzYLvck3xOPOG9wtDdxUnjdBhuuj9dkWrkx0kbK8MFT5UreZ7EcxoRZybrs3oELf2BK_WtDUFOm_FbZXKwNbg76pTCFDoRke0Er0GMWjmi5L8GE7hGnvvBQjHXrwQ88G0L2p6STay-n1FJ5prqz6Q4LEF-xu7FqGjDmh9haliI638ivcQ9XGo9_DLUrtKMh1K4UYN87j2H7vbjbJPJaw6oJ61ZF8Ngk1FSuHUvLB540QKwBJKnClMcvw-ih3CdKRdSTPRfIYlsYOkNCwEWrLwHarLTHG5HzeakMO_5usxOAvzXVDUKRIX7W62x9xKCnVl_Gp0E91dLtlU3U8j_ZZvYCj9pMvd_n_Ba82OUpFxvoXv2R2H1H8bfzztGg5E88fH6OMwoMS5OYa45nCoRFA11Bw7G8OEVqBiPzS48EY1JPjPTC5lBco0CUoeUAHPXeD7jmO-D3LhIL1-3erJ_mxP0ZeiCWUckYaFE2EliolooAHqkoVBmy5Q"
    },
    {
      "id": "0725233a85e23431681447327cbcd9d2_msg",
      "type": "message",
      "status": "completed",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "423",
          "annotations": []
        }
      ]
    }
  ],
  "output_text": "423",
  "usage": {
    "input_tokens": 239,
    "output_tokens": 190,
    "total_tokens": 429,
    "input_tokens_details": {
      "cached_tokens": 174
    },
    "output_tokens_details": {
      "reasoning_tokens": 189
    }
  },
  "error": null,
  "incomplete_details": null,
  "instructions": null,
  "metadata": {},
  "tools": null,
  "tool_choice": "auto",
  "temperature": 1,
  "top_p": 0.95,
  "text": {
    "format": {
      "type": "text"
    }
  },
  "reasoning": {
    "effort": "medium",
    "summary": null
  },
  "max_output_tokens": 2048,
  "max_tool_calls": null,
  "parallel_tool_calls": true,
  "previous_response_id": null,
  "conversation": null,
  "store": false,
  "service_tier": null,
  "safety_identifier": null,
  "truncation": "disabled"
}

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>

필수

모델 ID

사용 가능한 옵션:

MiniMax-M3.1-Flash

예시:

"MiniMax-M3.1-Flash"

input

필수

모델 입력입니다

문자열: 전체 텍스트를 하나의 user 메시지로 처리합니다
배열: 입력 항목 목록이며 message, function_call, function_call_output, reasoning을 지원합니다

멀티모달: message 항목의 content 배열에서 input_text, input_image, input_video 블록을 함께 사용합니다.

멀티턴 대화: API는 상태를 저장하지 않으므로 대화를 이어가려면 배열에 전체 기록을 포함해야 합니다.

예시:

"Explain recursion in one sentence."

instructions

string

시스템 수준 지시로, 맨 앞에 삽입되는 system 메시지와 동일하며 역할, 어조, 출력 제약을 설정하는 데 사용합니다.

예시:

"You are a technical documentation assistant. Keep your answers concise."

stream

boolean

기본값:false

스트리밍으로 반환할지 여부입니다

false (기본값): 전체 응답 객체를 한 번에 반환합니다
true: 의미별 SSE 이벤트로 전송하며 response.completed로 종료됩니다. [DONE]은 전송하지 않습니다

예시:

false

max_output_tokens

integer

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

권장: 131,072 (128K), 최대: 524,288 (512K)
값이 너무 작으면 추론 단계에서 한도에 도달하여 message 출력 항목 없이 status: "incomplete"가 반환될 수 있습니다

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

예시:

131072

reasoning

object

추론 설정입니다. MiniMax-M3.1-Flash는 항상 추론을 수행하며 추론 내용은 reasoning 출력 항목으로 반환됩니다. 해당 토큰은 출력에 포함되며 출력 요금이 적용됩니다.

Show child attributes

temperature

enum<number>

기본값:1

샘플링 온도이며 1로 고정됩니다.

사용 가능한 옵션:

1

예시:

1

top_p

number

기본값:0.95

누적 확률 샘플링 임계값입니다. 기본값은 0.95입니다.

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

예시:

0.95

tools

도구 정의 · object[]

모델이 호출할 수 있는 도구 목록입니다. 현재 function 유형만 지원합니다. 클라이언트가 함수를 실행한 뒤 결과를 function_call_output 입력 항목으로 전달합니다.

Show child attributes

tool_choice

enum<string>

기본값:auto

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

사용 가능한 옵션:

auto

예시:

"auto"

text

object

텍스트 출력 형식 설정입니다. format.type은 text만 지원합니다.

Show child attributes

metadata

object

요청 메타데이터입니다. 키와 값은 모두 문자열입니다.

Show child attributes

응답

생성 성공

Responses API의 응답 객체입니다. 아래 필드 외에도 이번 요청의 설정인 tools, tool_choice, temperature, top_p, text, reasoning, max_output_tokens 등을 포함합니다.

string

이번 응답의 고유 식별자

예시:

"072514d63605b7a0c83f1672230c398c"

object

string

객체 유형이며 항상 response

예시:

"response"

created_at

integer

생성 시각(Unix 타임스탬프, 초)

예시:

1792401878

status

enum<string>

응답 상태입니다

completed: 정상 완료
incomplete: 출력이 잘렸으며, 원인은 incomplete_details에 표시됩니다
failed: 생성 실패이며, 원인은 error에 표시됩니다

사용 가능한 옵션:

completed,

incomplete,

failed

예시:

"completed"

model

string

실제로 이번 응답을 생성한 모델 ID

예시:

"MiniMax-M3.1-Flash"

output

object[]

생성 순서대로 정렬된 출력 항목 목록입니다:

reasoning: 추론 과정으로 ID 형식은 <id>_rs입니다. content (reasoning_text 블록 목록), summary (빈 배열), encrypted_content를 포함합니다
message: 최종 답변으로 ID 형식은 <id>_msg입니다. content (output_text 블록 목록)를 포함합니다
function_call: 모델이 시작한 함수 호출로 ID 형식은 <id>_fc_<index>입니다. call_id, name, arguments를 포함하며 클라이언트가 실행한 뒤 function_call_output으로 결과를 전달해야 합니다

output_text

string | null

모든 output_text 텍스트를 연결한 편의 필드입니다. 텍스트 출력이 없으면 null입니다.

error

object | null

실패 원인이며 성공 시에는 null

incomplete_details

object | null

출력이 잘린 원인으로, 잘리지 않았으면 null입니다. reason은 max_output_tokens (출력 한도 도달) 또는 content_filter (콘텐츠 안전)입니다.

usage

object

캐시 및 추론 세부 내역을 포함한 토큰 사용 통계입니다.

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

MiniMax-M3.1-Flash - Responses API

인증

본문

응답