DeepSeek 的 API 因为价格低、中文能力强，被大量用在客服、写作、代码、数据分析等场景。本文从中商起航 AI 网关的角度，讲清楚怎么获取 Key、怎么充值、怎么用 OpenAI SDK 调用，以及遇到限流时怎么处理。
本文以 OpenAI 兼容接口为例。DeepSeek 官方接口也兼容 OpenAI SDK，但 Base URL 和模型名不同，注意不要混用。
一、DeepSeek API 能做什么
常见用途：
- 中文问答、客服机器人。
- 长文总结、翻译、改写。
- 代码生成、代码解释。
- 数据分析、结构化抽取。
- Agent/工作流的推理节点。
DeepSeek 常见模型包括 deepseek-chat 和 deepseek-reasoner。具体可用模型名、上下文长度和价格，以 模型价格 页面为准。
二、注册与创建 Key
- 打开 中商起航 AI 网关 注册并登录。
- 进入「API 密钥」页面，点击新建。
- 名称写
deepseek-测试或deepseek-生产。 - 设置额度上限和过期时间。
- 复制 Key，保存到安全位置。
建议测试和生产分开建 Key。生产 Key 不要放在前端代码里。
三、充值
在「钱包」页面充值。到账后，控制台会显示余额。
如果你是第一次用，建议先充小额，跑通后再按实际用量调整。DeepSeek 的价格相对低，但长上下文和批量任务仍可能快速消耗余额。
四、Base URL 和模型名
中商起航的 OpenAI 兼容地址：
https://ai.zhongshangqihang.com/v1
模型名示例：
deepseek-chat
deepseek-reasoner
注意：
- 模型名以价格页为准；不要直接照搬官方文档里的旧模型名。
- 如果你用官方 DeepSeek 接口，Base URL 是
https://api.deepseek.com；用网关则填上面的地址。 - 不要把两个 Base URL 混用，否则会出现 401/404。
五、Python 调用
pip install openai
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://ai.zhongshangqihang.com/v1",
)
response = client.chat.completions.create(
model="deepseek-chat",
messages=[
{"role": "system", "content": "你是一个中文技术助手。"},
{"role": "user", "content": "用三句话解释什么是向量数据库"},
],
)
print(response.choices[0].message.content)
如果需要推理过程，可以切换到 deepseek-reasoner。注意推理模型通常更慢、更贵，适合难题，不适合所有请求。
六、curl 调用
export DEEPSEEK_API_KEY="sk-你的密钥"
curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "写一个 Python 读取 CSV 的例子"}
]
}'
七、限流和稳定性
DeepSeek 在高峰期可能出现限流或响应变慢。实际使用建议：
- 设置超时和重试：不要无限等待；对 429/5xx 做指数退避。
- 控制并发：批量任务不要一次打满。
- 准备备用模型：关键业务可以配置一个备用模型或备用通道。
- 监控错误率：按小时统计 401/429/5xx，异常时切通道。
- 长文本拆分：超长上下文容易慢和贵，先做摘要或分段。
八、常见报错
| 报错 | 原因 | 处理 |
|---|---|---|
401 | Key 错误或没带 Bearer | 检查 Key 和请求头 |
404 | Base URL 错 | 用 /v1 结尾的网关地址 |
model not found | 模型名不对 | 从价格页复制 |
429 | 限流 | 降并发、重试、切备用通道 |
insufficient quota | 余额不足 | 充值 |
| 响应很慢 | 高峰期/长上下文 | 缩短上下文、换模型、重试 |
九、DeepSeek 官方 vs 网关，怎么选
| 对比项 | 官方直连 | 中商起航网关 |
|---|---|---|
| 访问 | 受网络环境影响 | 统一入口，通常更稳 |
| 支付 | 官方支持的支付方式 | 站内充值 |
| 模型 | 只有 DeepSeek | 可同时接 Claude、GPT、Gemini 等 |
| 账单 | 官方后台 | 统一控制台 |
| 切换 | 换供应商要改代码 | 改模型名即可 |
如果你只用 DeepSeek、用量稳定、官方访问没问题，官方直连也可以。如果你需要多模型、统一账单或国内稳定访问，网关更合适。
十、安全建议
- 不要把 Key 写进前端或公开仓库。
- 给测试和生产分别建 Key。
- 设置额度上限，避免异常调用。
- 定期看用量日志，发现异常及时停用。
- 离职/换机时删除旧 Key。
常见问题
DeepSeek API 可以免费用吗？
通常有新用户额度或活动，但长期使用需要充值。具体以官方和站内政策为准。
一个 Key 能调用 Claude 吗？
在中商起航网关里，一个 Key 可以调用已开通的多个模型；模型在请求参数里指定。具体看价格页。
为什么同一个模型有时快有时慢？
可能受上游负载、上下文长度、并发和网络影响。生产环境建议做超时、重试和备用模型。
下一步
先 注册中商起航 AI 网关，创建 deepseek 测试 Key，用 curl 跑通，再接入你的应用。价格和模型名以 模型价格 为准。
相关阅读：
