DeepSeek API 代理怎么配置：Base URL、API Key 与超时排查
配置 DeepSeek API 代理时，区分 Base URL、API Key、代理认证与网络连接。本文提供最小请求示例，并按超时、401、404、429 分层排查。
DeepSeek API 代理配置涉及两层：代理 IP 参与客户端到 API 服务的网络连接，Base URL、API Key 和模型参数决定 API 请求本身是否有效。请求失败时先区分 API 服务端点和 API Key、客户端网络代理，以及代理服务认证；配置代理不会授予 API 权限或配额，也不保证请求成功。
配置请求时，区分 Base URL、接口路径和 API Key
DeepSeek API 官方文档列出的 OpenAI 兼容 Base URL 是 https://api.deepseek.com，Anthropic 兼容 Base URL 是 https://api.deepseek.com/anthropic。API Key 放在 Authorization: Bearer ... 请求头中；OpenAI 兼容聊天接口路径为 /chat/completions。模型名称以当前文档为准。代理服务的主机和端口不能代替 API Base URL，代理凭证也不能代替 API Key。
先看错误码，判断是网络、代理认证还是 API 配置
| 现象 | 先检查 | 判断方向 |
|---|---|---|
| 域名解析失败或连接超时 | DNS、网络连通性、客户端代理是否生效 | 网络/传输层问题，记录目标主机和时间 |
| 代理认证失败 | 代理账号、密码、端口及认证方式 | 修正代理接入信息，不更换 API Key 试错 |
| API 返回认证错误 | API Key 的有效性、请求头格式及账户权限 | API 认证层问题，按官方说明核对 |
| API 返回参数错误 | Base URL、路径、模型名、请求体和 SDK 版本 | 请求配置问题，不应归因于代理 IP |
| 服务端限流或错误 | 响应状态、错误体、账户额度及服务状态 | 按当前官方错误说明处理，避免无边界重试 |
域名解析、连接超时或 TLS 错误可参考已发布的代理超时、连接拒绝和 TLS 错误排查；代理返回 407 时，可查看已发布的代理 407 认证失败排查。
发起一条最小请求，验证 API 和代理连接
以 OpenAI SDK 为例，Base URL 与 API Key 应在客户端初始化时分别设置；API Key 从环境变量读取，不写入源代码：
```python
import os
import httpx
from openai import OpenAI
proxy_http_client = httpx.Client(proxy=os.environ["PROXY_URL"], timeout=30.0)
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://api.deepseek.com",
http_client=proxy_http_client,
timeout=30.0,
max_retries=0,
)
response = client.chat.completions.create(
model=os.environ["DEEPSEEK_MODEL"], # 从当前账户/官方模型列表确认后设置
messages=[{"role": "user", "content": "Reply with: OK"}],
)
print(response.choices[0].message.content)
```
上例按 openai 1.x 与 httpx 0.27+ 的客户端接口编写；运行前锁定并核对实际依赖版本。PROXY_URL 是网络代理地址，不是 API Base URL，须从安全环境注入。要做直连与代理对照时，每次只切换 http_client 的网络代理设置，其它请求参数保持一致；请求成功本身不能证明已走代理，需结合代理侧日志或出口记录验证。不要打印代理 URL、API Key 或 Authorization 头。
也可用 curl 做最小请求。先通过环境变量设置 DEEPSEEK_API_KEY 和经确认可用的 DEEPSEEK_MODEL，不要把密钥写入命令文本或打印出来：
```bash
curl --max-time 30 https://api.deepseek.com/chat/completions \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"model\":\"$DEEPSEEK_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"Reply with: OK\"}]}"
```
401 通常需核对 API Key、请求头和账户权限；404 优先核对 Base URL、/chat/completions 路径及模型/接口兼容性；429 查看限流或额度信息并遵循服务限制，不要循环重试。成功响应应包含 choices 内容。官方模型列表会变化，示例从 DEEPSEEK_MODEL 读取已确认的模型名；截至 2026-10-20，官方快速开始页列出 deepseek-flash 与 deepseek-v4-pro。不要输出环境变量、Authorization 头或带密钥的调试日志。
Anthropic 兼容接口使用对应的 Base URL。网络代理需在 SDK 所用的 HTTP 客户端中另行配置，具体方式取决于客户端版本。发送一条低风险请求，记录 SDK 版本、HTTP 状态码和脱敏错误信息；若网络环境允许，可先测直连，再单独启用代理对照。
遇到超时，依次检查域名解析、TCP 连接、代理认证与隧道、TLS 握手，最后查看 API 响应等待时间。记录各阶段时间和客户端错误，避免只调大总超时而掩盖问题所在。
FAQ
Base URL 是代理地址吗？
不是。Base URL 指 API 服务端点；代理地址属于客户端网络连接配置，两者应分别按各自文档设置。
HTTP 429 应该增加超时时间或重试吗？
增加超时时间不能解决限流。先查看响应体、账户额度和 DeepSeek 当前的限流说明；只有在官方策略允许时才按其要求处理重试，避免循环请求。连接超时与 429 属于不同问题，应分别检查传输层和服务端限流响应。
按错误类型继续排查 DeepSeek API 请求
记录 SDK 与 httpx 版本、HTTP 状态码和脱敏错误；如需确认代理是否生效，对照代理侧连接日志，不记录密钥或含认证信息的代理 URL。