大模型请求／响应参数完全拆解：每个字段都是什么意思？ - 教程

AI时代下，如果你仅仅限于下载AI产品、通过网站对话访问Ai那就太落伍了。本文将用Apifox对阿里云上的模型进行请求，进行参数解读，让你从另一个视角认识大模型。

在这里插入图片描述

HTTP协议 请求方法（GET/POST）
请求头/请求体
状态码（200/400/500）

JSON格式 知道json就好 API认证 API Key管理
请求头Authorization
Apifox工具 创建请求集合
环境变量配置
测试和调试

第一步：平台方面

访问：下列网址，注册账号并注册密匙

在这里插入图片描述

访问：下列网址，找到curl

第二步：软件方面

下载安装好Apifox，来到新建界面窗口

分别填入

在这里插入图片描述

点击发送，大模型就会回复了

在这里插入图片描述

以下是调用大模型参数需要的json格式数据

千问 Qwen 教程

model

指定要使用的AI模型版本，不同模型具有不同的能力和特点。

contenet/role

stream

true: 流式返回，响应内容会逐步返回，用户可以实时看到生成过程
false: 等待完整生成后一次性返回所有内容

enable_search

true: 模型可以联网搜索最新信息作为回答依据
false: 仅使用模型自身的知识库回答

在这里插入图片描述

总结

参数名称类型说明可选值/示例 model string 告诉平台，当前调用哪个模型等模型名称 messages array 发送给模型的数据，模型会根据这些数据给出合适的响应消息对象数组 stream boolean 调用方式 : 非阻塞调用(流式调用)
: 阻塞调用(一次性响应)，默认值
enable_search boolean 联网搜索，启用后，模型会将搜索结果作为参考信息 : 开启
: 关闭(默认)

字段名称说明可选值 role 消息角色(类型) : 用户消息
: 系统消息
: 模型响应消息

content 消息内容具体的文本内容在这里插入图片描述

响应数据示例

上面这个响应可以这样解读

响应字段说明表格

字段名称类型说明 choices array 模型生成的内容数组，可以包含一条或多条内容 object string 始终为，无需关注 usage object 本次对话过程中使用的token信息 created integer 本次会话被创建时的时间戳 system_fingerprint string/null 固定为，无需关注 model string 本次会话使用的模型名称 id string 本次调用的唯一标识符

finish_reason表示模型停止生成的原因：

stop: 模型自然完成了回答
length: 生成的内容达到了最大长度限制而被截断

created

Unix时间戳格式，表示该响应生成的时间。示例中的转换为日期时间约为2025年5月。

每次API调用的唯一标识符，可用于日志追踪、问题排查或审计。

choices 数组结构（重点关注）

字段名称类型说明 message object 本次调用模型输出的消息 finish_reason string 自然结束()，生成内容过长() index integer 当前内容在choices数组中的索引

这是一个数组，包含模型生成的所有响应。通常情况下只有一个元素（index为0），但某些API配置下可能返回多个候选响应。

message 对象结构

字段名称类型说明 role string 固定为，表示这是模型的响应 content string 模型生成的具体文本内容

usage 对象结构（重点关注）

字段名称类型说明 prompt_tokens integer 用户的输入转换成token的个数 completion_tokens integer 模型生成的回复转换成token的个数 total_tokens integer 用户输入和模型生成的总token个数

Token是AI模型处理文本的基本单位，用户输入内容需要转换成token才能方便大模型处理同时用于计费和性能监控：

（一个token等于四个英文字符，一个汉字等于1~2个token）

prompt_tokens: 你发送给模型的所有内容（包括历史对话）消耗的token数
completion_tokens: 模型生成的回复消耗的token数
total_tokens: 本次调用的总消耗，等于前两者之和

在这里插入图片描述

学习程度测试：下面响应该如何解读？

我将答案放在了最后面，小伙伴们可以可以先打到评论区，用以检验自己学习程度。

题目：

你好,我是Qiuner. 为帮助别人少走弯路而写博客 这是我的 github https://github.com/Qiuner⭐ gitee https://gitee.com/Qiuner

如果本篇文章帮到了你不妨点个赞吧~ 我会很高兴的 (^ ~ ^) 。想看更多那就点个关注吧我会尽力带来有趣的内容。

代码都在github或gitee上，如有需要可以去上面自行下载。记得给我点星星哦

如果你遇到了问题，自己没法解决，可以去我掘金评论区问。CSDN评论区和私信看不完掘金账号 https://juejin.cn/user/01860 掘金账号

更多专栏:

一图读懂系列

一文读懂系列

持续更新

人生经验

掘金账号CSDN账号

感谢订阅专栏三连文章

上一篇推荐 链接 Java程序员快又扎实的学习路线点击该处自动跳转查看哦一文读懂 AI 点击该处自动跳转查看哦一文读懂服务器点击该处自动跳转查看哦 2024年创作回顾点击该处自动跳转查看哦一文读懂 ESLint配置点击该处自动跳转查看哦老鸟如何追求快捷操作电脑点击该处自动跳转查看哦

未来会写什么文章？ 预告链接 一文读懂 XX？点击该处自动跳转查看哦 2025年终总结点击该处自动跳转查看哦一图读懂 XX？点击该处自动跳转查看哦

发布者：Ai探索者，转载请注明出处：https://javaforall.net/257345.html原文链接：https://javaforall.net