Apifox测试大模型接口

Apifox 是什么#

Apifox 是一款 API 设计、开发、测试的一体化协作平台，是项目开发中进行 API 接口测试的神器。

在写代码之前先用它把接口调通，好处是：能把”接口问题”和”代码问题”分开——接口在 Apifox 里通了，写代码时出错就一定是代码的问题。

调用 DeepSeek 的三要素#

要素	内容
url 地址	`https://api.deepseek.com/chat/completions`
请求方式	POST
请求头（key: value）	`Content-Type: application/json` `Authorization: Bearer <你的API Key>`
请求体（json 格式）	`{"model": "...", "messages": [...], "stream": false}`

对应的原始 HTTP 请求长这样（官方文档给出的 curl 版本）：

1
curl https://api.deepseek.com/chat/completions \
2
  -H "Content-Type: application/json" \
3
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
4
  -d '{
5
        "model": "deepseek-chat",
6
        "messages": [
7
          {"role": "system", "content": "You are a helpful assistant."},
8
          {"role": "user", "content": "Hello!"}
9
        ],
10
        "stream": false
11
      }'

Tip

Authorization: Bearer xxx 里的 Bearer 是固定写法（表示”持有者令牌”），后面跟一个空格再跟 API Key。漏掉 Bearer 或空格都会导致 401。

请求体详解#

参数	含义
`model`	模型名称。`deepseek-chat` 对应非思考模式，`deepseek-reasoner` 对应思考模式（官方说明两者都已升级为 DeepSeek-V3.2）
`messages`	消息列表，决定模型”看到”的上下文
`stream`	是否流式输出。`false` 一次性返回完整结果，`true` 逐字返回（打字机效果）

messages 的三种角色#

messages 是一个列表，每个元素都是 {"role": ..., "content": ...}：

role	作用	示例
`system`	设定 AI 的身份和行为准则（回答的风格、限制、规则等）	“你是一名可爱的 AI 助手，你的名字叫小甜甜……”
`user`	用户实际提出的问题或指令	“你是谁”
`assistant`	AI 模型的回复/响应	“我是小甜甜呀！……”

1
"messages": [
2
  { "role": "system", "content": "你是一名可爱的AI助手, 你的名字叫小甜甜, 请以亲切、可爱语气来回答用户的问题" },
3
  { "role": "user", "content": "你是谁" },
4
  { "role": "assistant", "content": "我是小甜甜呀！一个可爱又贴心的AI助手……" }
5
]

Note

system 放在列表的最前面。它的内容就是我们后面要”定制伴侣性格”的地方，见提示词工程。

会话记忆-现状（为什么 AI 记不住上一句）#

与 AI 大模型的交互本质是无状态的，每一次请求响应都是相互独立的，AI 大模型本身没有真正的会话记忆能力。

第一次问”12 个苹果 3 个人怎么均分”，再问”那 2 个人呢”，因为这次请求里只有”那 2 个人呢”，模型不知道你在说什么：

1
"messages": [
2
  { "role": "system", "content": "你是一名可爱的AI助手……" },
3
  { "role": "user", "content": "那2个人呢?" }
4
]

会话记忆-处理方案（会话历史滚雪球）#

客户端把之前所有对话都塞进 messages 一起发过去，模型就”看起来记得”了：

1
"messages": [
2
  { "role": "system", "content": "你是一名可爱的AI助手……" },
3
  { "role": "user", "content": "12个苹果,3个人怎么均分?" },
4
  { "role": "assistant", "content": "嘻嘻，12个苹果分给3个人，每个人可以分到 **4个苹果** 哦～" },
5
  { "role": "user", "content": "那2个人呢?" }
6
]

这样模型就能正确回答”每人 6 个苹果”。代价是每轮请求都越来越长，Token 消耗越来越大。

练习题#

一、回忆填空（写完再展开对答案）#

调用 DeepSeek 的三要素：____ 地址、____（json 格式）、请求头
请求方式用 ____，url 是 https://api.deepseek.com/____
请求头 Content-Type 的值是 ____
请求头 Authorization 的值格式是 Bearer ____
请求体三个常用参数：model、、
messages 里三种 role：（设定身份和行为准则）、（用户提问）、____（AI 回复）
stream 为 true 表示 ____ 输出
Apifox 的作用是 ____，写代码之前先用它调通接口，可以把”接口问题”和”____问题”分开

填空答案（做完再点开）

url、请求体　2. POST、chat/completions　3. application/json　4. API Key（前面有 Bearer 和一个空格）　5. messages、stream　6. system、user、assistant　7. 流式　8. API 接口测试 / 代码

二、动手写（写在笔记本上或直接发我）#

2-1 手写一个最小的请求体 JSON：模型用 deepseek-chat，system 让 AI 自称”小甜甜”，user 问”你是谁”，不要流式

参考答案（做完再点开）

1
{
2
  "model": "deepseek-chat",
3
  "messages": [
4
    { "role": "system", "content": "你是一名可爱的AI助手, 你的名字叫小甜甜, 请以亲切、可爱语气来回答用户的问题" },
5
    { "role": "user", "content": "你是谁" }
6
  ],
7
  "stream": false
8
}

2-2 在上面基础上，补一条 assistant 的历史回复，说明”滚雪球”是怎么实现会话记忆的

参考答案（做完再点开）

在 messages 里再加一条 assistant 的历史回复，模型就能”看到”自己说过什么：

参考答案（做完再点开）

1
{
2
  "model": "deepseek-chat",
3
  "messages": [
4
    { "role": "system", "content": "你是一名可爱的AI助手, 你的名字叫小甜甜, 请以亲切、可爱语气来回答用户的问题" },
5
    { "role": "user", "content": "12个苹果,3个人怎么均分?" },
6
    { "role": "assistant", "content": "嘻嘻，12个苹果分给3个人，每个人可以分到 4个苹果 哦～" },
7
    { "role": "user", "content": "那2个人呢?" }
8
  ],
9
  "stream": false
10
}

2-3 如果 Apifox 里返回 401，你会先检查请求头里的哪一项？为什么？

参考答案（做完再点开）
先看请求头里的 Authorization：401 表示”未认证”，通常是没带这个头、没写 Bearer （Bearer+空格）、或者 API Key 写错/已失效。

团子和蛋糕

Apifox 是什么#

调用 DeepSeek 的三要素#

请求体详解#

messages 的三种角色#

会话记忆-现状（为什么 AI 记不住上一句）#

会话记忆-处理方案（会话历史滚雪球）#

相关#

练习题#

一、回忆填空（写完再展开对答案）#

二、动手写（写在笔记本上或直接发我）#

评论区

音乐

团子和蛋糕

Apifox测试大模型接口

Apifox测试大模型接口

Apifox 是什么#

调用 DeepSeek 的三要素#

请求体详解#

messages 的三种角色#

会话记忆-现状（为什么 AI 记不住上一句）#

会话记忆-处理方案（会话历史滚雪球）#

相关#

练习题#

一、回忆填空（写完再展开对答案）#

二、动手写（写在笔记本上或直接发我）#

相关阅读

评论区

音乐