Minimax大模型API返回数据格式 JSON参数字段详细解释【文档】

积累知识，胜过积蓄金银！毕竟在科技周边开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《Minimax大模型API返回数据格式 JSON参数字段详细解释【文档】》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

Minimax大模型API响应为JSON格式，成功时含response（含id、choices、usage）、choices含message（role="assistant"、content为纯文本）和finish_reason（"stop"/"length"/"tool_calls"），失败时直接返回error（含code和message）。

当调用Minimax大模型API时，响应体以JSON格式返回，其结构包含固定字段与模型生成内容嵌套字段。以下是各JSON参数字段的逐项说明：

一、response字段

该字段为顶层对象，封装全部响应数据，类型为JSON对象，是所有返回内容的根容器。

1、response字段内必定包含id、choices、usage三个子字段。

2、response字段不包含error字段；若发生错误，整个响应结构将被替换为独立的error对象，不再嵌套于response中。

二、id字段

标识本次请求的唯一追踪ID，由服务端生成，用于日志关联与问题排查，字符串类型，长度固定为32位十六进制字符。

1、id值在同一次HTTP请求生命周期内全局唯一。

2、该字段不可为空，且不随重试请求变化而重复。

三、choices字段

承载模型实际生成结果的数组，每个元素代表一个完成选项（completion choice），即使仅配置了n=1，也始终为长度为1的数组。

1、choices数组中每个对象包含index、message、finish_reason三个必选字段。

2、index从0开始递增，用于匹配并行生成的多个输出顺序。

四、message字段

位于choices[i]内部，表示单条生成消息的内容与角色声明，类型为JSON对象。

1、message字段必含role和content两个键。

2、role取值严格限定为"assistant"，不会出现"user"或"system"。

3、content为字符串类型，即模型输出的纯文本结果，不含前导空格、换行符或Markdown标记，除非显式启用相关参数。

五、finish_reason字段

指示本次生成终止的原因，字符串类型，用于判断输出是否完整或因外部条件中断。

1、合法取值包括"stop"、"length"、"tool_calls"三种。

2、"stop"表示触发了stop序列；"length"表示达到max_tokens限制；"tool_calls"表示模型主动发起工具调用。

六、usage字段

记录本次请求消耗的token统计信息，类型为JSON对象，仅在请求成功时存在。

1、usage字段包含prompt_tokens、completion_tokens、total_tokens三个整数字段。

2、prompt_tokens计数包含系统提示、用户输入及历史对话轮次的全部编码token。

3、completion_tokens仅统计message.content中实际生成的token数量，不含分隔符或控制符号。

七、error字段（错误响应专属）

当API调用失败时，响应体不再包含response字段，而是直接返回error对象，类型为JSON对象。

1、error对象必含code和message两个字段。

2、code为字符串，取值如"invalid_api_key"、"rate_limit_exceeded"、"bad_request"等标准化错误码。

3、message为面向开发者的简明错误描述，不包含HTML、换行或占位符变量。

今天关于《Minimax大模型API返回数据格式 JSON参数字段详细解释【文档】》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！