DeepSeek API 的获取与对话示例.md

DeepSeek API 的获取与对话示例

代码文件下载：Code

在线链接：Kaggle | Colab

目录

• 环境依赖
• 获取 API
  • DeepSeek 官方
  • 硅基流动
  • 阿里云百炼
  • 百度智能云
  • 字节火山引擎
• 在线体验地址
• 📝 作业

环境依赖

pip install openai

获取 API

因为被攻击的原因，官方 API 平台可能会暂时无法注册，本文提供可替代的解决方案。

撰写文章时发现 DeepSeek API 创建已恢复正常，不过箭在弦上，其余平台的解决方案也同时提供。

不同平台参数对照表：

	api_key_name	base_url	chat_model_id	reasoner_model_id
DeepSeek	"DEEPSEEK_API_KEY"	"https://api.deepseek.com"	"deepseek-chat"	"deepseek-reasoner"
硅基流动	"SILICONFLOW_API_KEY"	"https://api.siliconflow.cn/v1"	"deepseek-ai/DeepSeek-V3"	"deepseek-ai/DeepSeek-R1"
阿里云百炼	"DASHSCOPE_API_KEY"	"https://dashscope.aliyuncs.com/compatible-mode/v1"	"deepseek-v3"	"deepseek-r1"
百度智能云	"BAIDU_API_KEY"	"https://qianfan.baidubce.com/v2"	"deepseek-v3"	"deepseek-r1"
字节火山引擎	"ARK_API_KEY"	"https://ark.cn-beijing.volces.com/api/v3"	"your-chat-model-id"	"your-reasoner-model-id"

参数说明：

• api_key_name：环境变量名称。
• base_url：API 请求地址。
• chat_model_id：对话模型标识。
• reasoner_model_id：推理模型标识。

从下方选择一个平台继续，点击 ► 或文字展开。

DeepSeek 官方

目前已恢复正常，所有新平台的注册都会赠送一定数量的 tokens，择一即可。

目前 DeepSeek 平台的新用户注册暂时不再赠送余额。

访问 https://platform.deepseek.com/sign_in 进行注册并登录：

新用户注册后将赠送 10 块钱余额，有效期为一个月：

点击左侧的 API keys（或者访问 https://platform.deepseek.com/api_keys），然后点击 创建 API key:

命名，然后点击 创建：

与其他平台不同的是，DeepSeek 的 API 仅在创建时显示，你可能需要记录它，点击 复制：

代码示例

from openai import OpenAI
import os

# 临时环境变量配置
os.environ["DEEPSEEK_API_KEY"] = "your-api-key" # 1

client = OpenAI(
    api_key=os.getenv("DEEPSEEK_API_KEY"),
    base_url="https://api.deepseek.com", # 2
)

# 单轮对话示例
completion = client.chat.completions.create(
    model="deepseek-chat", # 3
    messages=[
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': '你是谁？'}
    ]
)
print(completion.model_dump_json())

模型切换

# 切换推理模型
completion = client.chat.completions.create(
    model="deepseek-reasoner",  # 修改此处标识
    # ...其他参数保持不变...
)

观察 reasoning_content 可以捕捉到思考过程。

可以通过其他平台提供的服务来等价地访问 DeepSeek（当然，也可以使用平台自身的模型，比如阿里的 Qwen 或者百度的文言一心，不过本文不作探究）：

硅基流动

下方硅基流动的注册链接附带邀请码，因邀请所产生所有 tokens 将被用于学习共享（Discussions）。

感谢注册，因为你才有了该分享的诞生。

访问 https://cloud.siliconflow.cn/i/ofzj9IQy 进行注册并登录：

点击体验中心左侧的 API 密钥，然后点击 新建 API 密钥：

随意填写描述后点击 新建密钥：

直接点击密钥进行复制，这就是我们即将用到的 API KEY：

代码示例

from openai import OpenAI
import os

# 临时环境变量配置
os.environ["SILICONFLOW_API_KEY"] = "your-api-key" # 1

client = OpenAI(
    api_key=os.getenv("SILICONFLOW_API_KEY"),
    base_url="https://api.siliconflow.cn/v1", # 2
)

# 单轮对话示例
completion = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V3", # 3
    messages=[
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': '你是谁？'}
    ]
)
print(completion.model_dump_json())

模型切换

# 切换推理模型
completion = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-R1",  # 修改此处标识
    # ...其他参数保持不变...
)

[!note]

注意，硅基流动官方对于非实名用户的用量做了限制（100 次/天）：

如果有更高的用量需求，则需要进行实名认证。

阿里云百炼

访问 阿里云百炼控制台 注册并登录。

在注册后将获取 1000 万的免费额度，有效期为半年，可以用于 DeepSeek-V3 和 DeepSeek-R1。

注意：目前仅供免费体验，免费额度用完之后不可继续调用（个人使用可以忽略），随着时间的推移，赠送的额度或有变化。

目前国内所有赠送额度的平台都需要实名才能正常使用 API：阿里云实名入口，进入后点击 个人支付宝认证 / 个人扫脸认证。

点开左侧的 模型广场，点击 开通模型服务：

打勾，并点击 确认开通：

在控制台点击右上角的 用户图标 - API-KEY：

点击创建

选择 默认业务空间，点击 确定 创建 API-KEY：

点击 查看 并复制 API KEY：

代码示例

from openai import OpenAI
import os

# 临时环境变量配置
os.environ["DASHSCOPE_API_KEY"] = "your-api-key" # 1

client = OpenAI(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1", # 2
)

# 单轮对话示例
completion = client.chat.completions.create(
    model="deepseek-v3", # 3
    messages=[
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': '你是谁？'}
    ]
)
print(completion.model_dump_json())

模型切换

# 切换推理模型
completion = client.chat.completions.create(
    model="deepseek-r1",  # 修改此处标识
    # ...其他参数保持不变...
)

百度智能云

访问百度智能云控制台进行注册并登录：

查看用户协议，点击 同意并继续：

点击左侧的 模型广场，搜索 DeepSeek：

可以看到百度也提供了相关服务，接下来我们访问 API Key，点击 创建 API Key：

选择 千帆 ModelBuilder，点击 确定：

点击 复制：

代码示例

from openai import OpenAI
import os

# 临时环境变量配置
os.environ["BAIDU_API_KEY"] = "your-api-key" # 1

client = OpenAI(
    api_key=os.getenv("BAIDU_API_KEY"),
    base_url="https://qianfan.baidubce.com/v2", # 2
)

# 单轮对话示例
completion = client.chat.completions.create(
    model="deepseek-v3", # 3
    messages=[
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': '你是谁？'}
    ]
)
print(completion.model_dump_json())

模型切换

# 切换推理模型
completion = client.chat.completions.create(
    model="deepseek-r1",  # 修改此处标识
    # ...其他参数保持不变...
)

字节火山引擎

这是一个稍显繁杂的流程。

访问火山引擎进行注册并登录：

对于每个模型，将赠送 50 万 tokens 的额度。

点击左侧的 API Key 管理 或者访问 API 入口，然后点击 创建 API Key：

默认名称基于时间自动生成，修改或直接点击 创建：

点击箭头位置，然后复制 API Key：

接下来，点击左侧的 开通服务，找到 DeepSeek，然后点击右侧的 开通服务：

勾选想用的模型，点击 立即开通：

点击左侧的 在线推理，点击 创建推理接入点：

接入点名称可以随意命名，命名完之后进行 模型选择：

选择步骤参考下图（注意，不能同时选择两个，需要分开创建）：

聊天模型	推理模型

然后点击右侧的 确认接入：

在接入点名称处复制想要接入模型的 ID。

以上图的 DeepSeek-V3 为例，此时 model_id = "ep-20250208211645-hrlmt"，而非 DeepSeek-V3。

代码示例

字节与其他家完全不同的点在于 model_id 不固定，在创建完接入点之后才可以得知对应 ID，这固然提高了可操作性，但对于刚注册的用户来说实在不够明确，在使用时需要注意它们的不同，如果在之前没有保存 api_key 和 model，可以通过入口进行复制：

• api_key：入口
• model：入口

from openai import OpenAI
import os

# 临时环境变量配置
os.environ["ARK_API_KEY"] = "your-api-key" # 1

client = OpenAI(
    api_key=os.getenv("ARK_API_KEY"),
    base_url="https://ark.cn-beijing.volces.com/api/v3", # 2
)

# 单轮对话示例
completion = client.chat.completions.create(
    model="your-chat-model-id", # 3
    messages=[
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': '你是谁？'}
    ]
)
print(completion.model_dump_json())

模型切换

# 切换推理模型
response = client.chat.completions.create(
    model="your-reasoner-model-id",  # 修改此处标识
    # ...其他参数保持不变...
)

---

在线体验地址

除了官方平台外，还可以通过其他平台与 DeepSeek 进行对话（避开官方平台的卡顿）：

平台	在线链接
DeepSeek 官方	官方
硅基流动	DeepSeek-V3 DeepSeek-R1
百度智能云	DeepSeek-V3 DeepSeek-R1
火山引擎	模型广场选择体验

📝 作业

1. 尝试非官方平台来感知代码上的差异（对应于代码注释中的 #1 #2 #3 所在行）。
2. 根据文章《DeepSeek 联网满血版使用指南 》进行多平台配置并对话。