文本合成

Authorizations

Authorization

string

header

required

HTTP: Bearer Auth

Security Scheme Type: http
HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在账户管理>接口密钥中查看。

Headers

Content-Type

enum<string>

default:application/json

required

请求体的媒介类型，请设置为 application/json，确保请求数据的格式为 JSON

可用选项:

application/json

Body

application/json

model

enum<string>

required

模型 ID。可选值：MiniMax-M2, MiniMax-M1, MiniMax-Text-01 。注：MiniMax-M2 和 MiniMax-M1 为推理模型，为获得最佳体验建议使用流式输出

可用选项:

MiniMax-M2,

MiniMax-M1,

MiniMax-Text-01

messages

object[]

required

包含对话历史的消息列表

显示子属性

messages.role

enum<string>

required

消息发送者的角色

system: 设定模型的角色和行为
user: 用户的输入
assistant: 模型的历史回复，也可包含对工具的调用请求
tool: 工具调用的返回结果

可用选项:

system,

user,

assistant,

tool

messages.content

required

消息内容。支持 string 和 object[] 两种类型

messages.name

string

发送者的名称。若同一类型的角色有多个，须提供具体名称以区分

messages.tool_calls

object[]

模型决定调用的工具列表。当 role 为 assistant 时出现

显示子属性

messages.tool_calls.id

string

required

工具调用的唯一 ID

messages.tool_calls.type

enum<string>

required

工具类型，固定值为 function

可用选项:

function

messages.tool_calls.function

object

required

具体的工具使用信息

显示子属性

messages.tool_calls.function.name

string

required

要调用的函数名称

messages.tool_calls.function.arguments

string

required

包含函数参数的 JSON 字符串

stream

boolean

default:false

是否使用流式传输，默认为 false。设置为 true 后，响应将分批返回

max_tokens

integer<int64>

deprecated

废弃参数，请使用max_completion_tokens

指定生成内容长度的上限（Token 数）。超过上限的内容会被截断。如果生成因 length 原因中断，请尝试调高此值默认值：MiniMax-M2 为 10240，MiniMax-M1 为 8192，MiniMax-Text-01 为 2048

必填范围: x >= 1

max_completion_tokens

integer<int64>

指定生成内容长度的上限（Token 数）。超过上限的内容会被截断。如果生成因 length 原因中断，请尝试调高此值默认值：MiniMax-M2 为 10240，MiniMax-M1 为 8192，MiniMax-Text-01 为 2048。

必填范围: x >= 1

temperature

number<double>

温度系数，影响输出随机性，取值范围 (0, 1]，取值范围 (0, 1]。值越高，输出越随机；值越低，输出越确定 MiniMax-M2 推荐使用 1.0 MiniMax-M1 默认值为 1.0，推荐范围 [0.8, 1.0] MiniMax-Text-01 默认值为 0.1，适用于答案明确的场景，对于文案生成等发散性场景可适当调高至 0.7-1.0

必填范围: 0 < x <= 1

top_p

number<double>

default:0.95

采样策略，影响输出随机性，取值范围 (0, 1]，各模型默认为 0.95，MiniMax-M2 推荐使用 0.95

必填范围: 0 < x <= 1

tools

object[]

可供模型选择调用的工具列表。更多详情参考 M2 工具使用 & Interleaved Thinking

显示子属性

tools.type

enum<string>

required

工具类型，当前仅支持 function

可用选项:

function

tools.function

object

required

显示子属性

tools.function.name

string

required

函数名称

tools.function.description

string

required

对函数功能的描述

tools.function.parameters

object

required

函数的参数

tool_choice

enum<string>

default:auto

控制模型如何使用工具。none (不调用) 或 auto (自主决定)

可用选项:

none,

auto

response_format

object

指定模型输出的格式，当前仅 MiniMax-Text-01 支持此参数设置为 { "type": "json_schema", "json_schema": {...} } 可强制模型按指定的 JSON Schema 结构输出

显示子属性

response_format.type

enum<string>

required

格式类型，仅支持 json_schema

可用选项:

json_schema

response_format.json_schema

object

required

定义输出格式的 JSON Schema 对象

显示子属性

response_format.json_schema.name

string

required

格式名称。

须由a-z、A-Z、0-9 组成
最大长度为64字符

Maximum string length: 64

response_format.json_schema.schema

object

required

JSON Schema 定义。

显示子属性

response_format.json_schema.schema.type

enum<string>

required

取值应为 object

可用选项:

object

response_format.json_schema.schema.properties

object

required

详细定义格式化输出所需的内容支持的类型包括：String、Array、Enum、Number、Integer、Object、Boolean。请注意，使用结构化输出时，所有字段或函数参数都必须指定为required

Example:

"json_schema": {
  "name": "user_analysis",
  "description": "User behavior analysis result",
  "schema": {
    "type": "object",
    "properties": {
      "analysis": {
        "type": "string",
        "description": "Content analysis based on rules"
      },
      "summary_words": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Content keywords summary, limited to three words"
      },
      "content_result": {
        "type": "string",
        "enum": [
          "低俗色情违规",
          "广告引流违规",
          "违法违规",
          "涉政违规",
          "自杀自残违规",
          "未成年违规",
          "攻击辱骂违规",
          "其他违规",
          "正常"
        ],
        "description": "Content classification result"
      },
      "risk_words": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Keywords indicating violations, emojis converted to text"
      },
      "correct_rate": {
        "type": "number",
        "description": "Credibility score, from 0.00 to 1.00"
      },
      "content_risk_level": {
        "type": "string",
        "enum": ["high", "medium", "low"],
        "description": "Risk concentration level in content"
      }
    },
    "required": [
      "analysis",
      "summary_words",
      "content_result",
      "risk_words",
      "correct_rate",
      "content_risk_level"
    ]
  }
}

response_format.json_schema.description

string

格式的描述。用于模型确定如何以该格式进行输出

stream_options

object

显示子属性

stream_options.include_usage

boolean

default:false

默认为 false。若设为 true，流式响应的最后一个数据块将包含本次请求完整的 usage 统计信息

Response

string

本次响应的唯一 ID

choices

object[]

响应选择列表

显示子属性

choices.finish_reason

enum<string>

生成停止的原因：stop (自然结束), length (达到 max_tokens 上限), tool_calls (调用工具)

可用选项:

stop,

length,

tool_calls

choices.index

integer

选项的索引，从 0 开始

choices.message

object

模型生成的完整回复

显示子属性

choices.message.content

string

required

文本回复内容

choices.message.role

enum<string>

required

角色，固定为 assistant

可用选项:

assistant

choices.message.tool_calls

object[]

模型请求调用的工具列表

显示子属性

choices.message.tool_calls.id

string

工具调用的唯一 ID

choices.message.tool_calls.type

enum<string>

工具类型，固定为 function

可用选项:

function

choices.message.tool_calls.function

object

具体的工具使用信息

显示子属性

choices.message.tool_calls.function.name

string

required

要调用的函数名称

choices.message.tool_calls.function.arguments

string

required

一个 JSON 字符串，包含调用该函数的参数

created

integer<int64>

响应创建的 Unix 时间戳（秒）

model

string

本次请求使用的模型 ID

object

enum<string>

对象类型。非流式为 chat.completion，流式为 chat.completion.chunk

可用选项:

chat.completion,

chat.completion.chunk

usage

object

本次请求的 Token 使用情况统计

显示子属性

usage.total_tokens

integer

消耗的总 Token 数

input_sensitive

boolean

输入内容是否命中敏感词。如果输入内容严重违规，接口会返回内容违规错误信息，回复内容为空

input_sensitive_type

integer<int64>

输入命中敏感词类型，当input_sensitive为true时返回。取值为以下其一：1 严重违规；2 色情；3 广告；4 违禁；5 谩骂；6 暴恐；7 其他

output_sensitive

boolean

输出内容是否命中敏感词。如果输出内容严重违规，接口会返回内容违规错误信息，回复内容为空

output_sensitive_type

integer<int64>

输出命中敏感词类型

base_resp

object

错误状态码和详情

显示子属性

base_resp.status_code

integer<int64>

状态码

1000: 未知错误
1001: 请求超时
1002: 触发限流
1004: 鉴权失败
1008: 余额不足
1013: 服务内部错误
1027: 输出内容错误
1039: Token 超出限制
2013: 参数错误

更多内容可查看错误码查询列表了解详情

base_resp.status_msg

string

错误详情

文本

语音

视频

图片

音乐

文件

错误码查询

Authorizations

Headers

Body

Response