DeepSeek 官方 API 第一次调用(按量计费)
api
- EndpointEndpoint
https://api.deepseek.com- 认证Authentication
- Authorization: Bearer API key
按量计费;价格、并发和限流规则按官方价格与 Rate Limit 页面为准。
前置条件Prerequisites
- DeepSeek Platform 账号DeepSeek Platform
- 已创建 API Key 并保存到 DEEPSEEK_API_KEY 环境变量API Key DEEPSEEK_API_KEY
- 已查看官方价格并确认账户余额;此入口不是免费额度;
操作步骤Steps
- 创建 API Key 并查看价格
在 DeepSeek Platform 创建密钥。官方 API 按量计费;先查看当前模型价格与账户余额,再发请求。
操作Action:打开 https://platform.deepseek.com/
- 安装 OpenAI Python SDK
官方 API 兼容 OpenAI Chat Completions 格式。建议使用 Python 3.9+ 虚拟环境。
可复制命令Copyable commandpython -m pip install -U openai - 发送第一条请求
使用官方当前模型 ID deepseek-flash。该模型名替代已退役的旧 Flash 名称。
可复制命令Copyable commandexport DEEPSEEK_API_KEY="你的 Key" curl https://api.deepseek.com/chat/completions -H 'Content-Type: application/json' -H "Authorization: Bearer $DEEPSEEK_API_KEY" -d '{"model":"deepseek-flash","messages":[{"role":"user","content":"用一句话解释 API 是什么。"}],"stream":false}'预期结果Expected:返回 choices[0].message.content;同时检查控制台余额和用量记录。
- Python SDK 示例
密钥从环境变量读取;不在代码中粘贴真实密钥。
可复制命令Copyable commandimport os from openai import OpenAI client = OpenAI( api_key=os.environ["DEEPSEEK_API_KEY"], base_url="https://api.deepseek.com", ) response = client.chat.completions.create( model="deepseek-flash", messages=[{"role": "user", "content": "用一句话解释 API 是什么。"}], ) print(response.choices[0].message.content)预期结果Expected:终端打印模型回复。
- Node.js SDK 示例
安装 OpenAI 官方 Node.js SDK;Node.js 20 LTS 或更新版本。
可复制命令Copyable commandnpm install openai import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.DEEPSEEK_API_KEY, baseURL: "https://api.deepseek.com", }); const response = await client.chat.completions.create({ model: "deepseek-flash", messages: [{ role: "user", content: "用一句话解释 API 是什么。" }], }); console.log(response.choices[0].message.content);预期结果Expected:Node.js 打印模型回复;控制台可查看本次调用用量。
响应包含 choices 数组中的模型文本,并在控制台确认账户余额和用量变化。
- 401:检查 API Key 是否正确,且没有把 API URL 填进 Key 字段。401: API Key , API URL Key 。
- 402:账户余额不足;停止重试并检查价格和余额。402: ; 。
- 404:确认模型 ID 为当前官方模型名,例如 deepseek-flash。404: ID , deepseek-flash。
- 429:降低请求频率并按官方建议等待后再重试。429: 。