DeepSeek 官方 API 第一次调用（按量计费）
api
- EndpointEndpoint
https://api.deepseek.com- 认证Authentication
- Authorization: Bearer API key
额度与限制Limits
按量计费；价格、并发和限流规则按官方价格与 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 名称。
命令已在上方「快速上手」给出。The copyable command already appears in Quick start above.
预期结果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 打印模型回复；控制台可查看本次调用用量。
验证动作Validation
响应包含 choices 数组中的模型文本，并在控制台确认账户余额和用量变化。
常见问题Common issues
- 401：检查 API Key 是否正确，且没有把 API URL 填进 Key 字段。401： API Key ， API URL Key 。
- 402：账户余额不足；停止重试并检查价格和余额。402： ； 。
- 404：确认模型 ID 为当前官方模型名，例如 deepseek-flash。404： ID ， deepseek-flash。
- 429：降低请求频率并按官方建议等待后再重试。429： 。