Minimax API响应解析需按五步进行:一、识别code(正常为0)、message(如"success")、data(承载业务数据);二、解析data中content(字符串或含text键的对象数组);三、提取usage中input_tokens、output_tokens、total_tokens;四、code非零时读取error.code、error.message及error.param;五、验证response_id(≥16位,含字母数字和短横线)与request_id一致性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您调用 Minimax API 后收到 JSON 格式的响应,但无法准确识别各字段含义及嵌套结构,则可能是由于缺乏对响应体标准字段的系统性认知。以下是解析 Minimax API 返回值 JSON 格式的关键步骤:
一、识别顶层必选字段
Minimax API 的成功响应(HTTP 200)始终包含一组固定顶层字段,用于标识请求状态与内容载体。理解这些字段是解析后续嵌套结构的基础。
1、检查 code 字段:该字段为整数,正常响应时值为 0;非零值表示错误类型编码。
2、检查 message 字段:该字段为字符串,描述本次响应的整体状态,成功时通常为 "success"。
3、检查 data 字段:该字段为对象或数组,承载模型实际输出内容,所有业务数据均位于此键下。
二、解析 data 字段中的 content 结构
当请求类型为文本生成(如 chat.completion),data 对象内必定包含 content 字段,其值为字符串或字符串数组,代表模型生成的主文本结果。
1、若 content 为字符串:直接读取该字符串即为完整回复文本,例如 "你好,我是AI助手。"。
2、若 content 为数组:需遍历每个元素,每个元素为带 text 键的对象,提取 text 的值并按顺序拼接。
3、注意 content 可能为空字符串或空数组,此时应视作模型未返回有效文本。
三、提取 usage 字段中的计费与性能信息
usage 字段位于 data 内部,提供本次调用消耗的 token 数量及处理耗时,对成本控制与性能分析至关重要。
1、读取 input_tokens:该整数值表示发送至模型的提示词(prompt)所占 token 总数。
2、读取 output_tokens:该整数值表示模型生成的回复内容所占 token 总数。
3、读取 total_tokens:该值恒等于前两者之和,可用于快速校验 token 计算一致性。
四、处理 error 字段以定位失败原因
当 code 非零时,响应中将存在 error 字段,其为对象,内含机器可读的错误码与人工可读的详情说明。
1、检查 error.code:该字符串为平台定义的错误分类标识,例如 "invalid_parameter" 或 "rate_limit_exceeded"。
2、检查 error.message:该字符串提供上下文相关的错误解释,例如 "temperature must be between 0 and 2"。
3、检查 error.param(若存在):该字段指出引发错误的具体请求参数名,例如 "temperature"。
五、验证 response_id 与 request_id 的一致性
每个 Minimax API 响应都携带 response_id 字符串,部分响应还包含 request_id。二者用于日志追踪与问题排查,需确保其格式合法且非空。
1、确认 response_id 长度不小于 16 位,且仅含字母、数字与短横线(-)。
2、若请求头中设置了 X-Request-ID,则响应中 request_id 应与之完全一致。
3、在调试环境中,应将 response_id 与客户端日志中的请求时间戳联合记录,以便反查服务端原始请求。









