> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heihuzi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# DeepSeek 接入

> 模型选择、三种调用协议与便利店实际验证范围。

使用便利店的 DeepSeek 分组 API Key。**实测日期：2026-09-19**；以下结论来自便利店公网入口的真实请求，具体参数组合以各页示例为准。

## 地址与模型

| 客户端                  | 配置地址                         | 实际请求路径                                   |
| -------------------- | ---------------------------- | ---------------------------------------- |
| OpenAI Python SDK    | `https://code.heihuzi.ai/v1` | `/v1/chat/completions` 或 `/v1/responses` |
| Anthropic Python SDK | `https://code.heihuzi.ai`    | `/v1/messages`                           |

环境变量 `HEIHUZI_API_KEY` 填写便利店 Key。OpenAI SDK 使用 Bearer 认证，Anthropic SDK 使用 `x-api-key`。不要把 DeepSeek 官方 Key 填到便利店地址。

本次 DeepSeek Key 查询 `/v1/models` 实际返回 `deepseek-flash` 和 `deepseek-v4-pro`。请先查[自己 Key 的模型列表](/cn/models)，其他分组的权限与可见模型可能不同。

| 模型 ID            | 本次完成的验证                                                          |
| ---------------- | ---------------------------------------------------------------- |
| `deepseek-flash` | 三种协议普通输出；三种协议流式；JSON；Chat / Responses 工具闭环；Responses 多轮；三种协议单图理解 |

DeepSeek 官方目前将 `deepseek-flash` 对应到 V4.1-Flash，并说明旧 Flash 名称的兼容关系；便利店本次模型列表仅返回上面的两个 ID，示例使用完整 ID。[官方模型说明](https://api-docs.deepseek.com/zh-cn/quick_start/pricing/)

## 按需求阅读

* [Chat Completions](/cn/api-reference/deepseek/chat-completions)：messages 格式、JSON 和流式文本。
* [Responses](/cn/api-reference/deepseek/responses)：input 格式、完整历史和事件流。
* [Messages](/cn/api-reference/deepseek/messages)：Anthropic SDK 的请求与完成条件。
* [工具调用](/cn/api-reference/deepseek/tools)：工具参数、执行结果回传和最终答案。
* [图片理解](/cn/api-reference/deepseek/vision)：三种协议的同一张参考图示例。
* [兼容性与限制](/cn/api-reference/deepseek/compatibility)：本轮通过的参数、输出字段和完成条件。

## 安装与运行

本次执行环境使用 OpenAI Python SDK **2.32.0**、Anthropic Python SDK **0.97.0**。按所选页面安装对应 SDK，并在运行环境设置 `HEIHUZI_API_KEY`。所有示例关闭自动重试，单次超时为 120 秒，输出 token 参数为 1024。

公开示例仅保留本轮真实执行通过的配置。每个完整脚本均重新运行；支持范围按模型和协议列在[实测范围](/cn/api-reference/deepseek/compatibility)。

## 计费与范围

费用以便利店当前分组配置和用量明细为准。使用范围以本文列出的模型、协议及已测参数组合为准。