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 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您调用 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 与客户端日志中的请求时间戳联合记录，以便反查服务端原始请求。
