AI 教程｜DeepSeek API 调用，AI 开发入门实战

DeepSeek 作为国产高性能大模型，凭借强大的推理能力、百万级上下文窗口及多语言支持，成为AI开发入门的优选工具。其API兼容OpenAI接口规范，上手简单、文档完善，本文从注册、密钥获取到代码调用，手把手带你完成首个AI API开发实战，零基础也能轻松掌握。

一、前期准备：注册账号与获取API Key

调用DeepSeek API的核心凭证是API Key，获取流程简单高效。

1. 注册登录：访问DeepSeek官网（platform.deepseek.com），用邮箱或手机号注册，完成邮箱验证与实名认证。
2. 创建API Key：登录控制台后，进入“API Keys”模块，点击“生成新密钥”，复制生成的sk-开头密钥并妥善保存（仅显示一次）。
3. 安全配置：严禁硬编码密钥，建议通过环境变量存储。Windows终端执行$env:DEEPSEEK_API_KEY = "你的密钥"，Mac/Linux执行export DEEPSEEK_API_KEY="你的密钥"。

二、环境搭建：安装依赖库

推荐使用Python调用API，需安装OpenAI官方SDK（兼容DeepSeek接口）。打开终端执行命令：

pip install openai

安装完成后，即可通过SDK快速对接DeepSeek模型，无需手动处理HTTP请求。

三、核心实战：基础对话API调用

以调用deepseek-v4-pro模型为例，实现简单对话交互，代码可直接复制运行。

import os
from openai import OpenAI

# 初始化客户端，配置DeepSeek接口地址
client=OpenAI(
    api_key=os.environ.get('DEEPSEEK_API_KEY'),
    base_url="https://api.deepseek.com"
)

# 调用对话API
response=client.chat.completions.create(
    model="deepseek-v4-pro",  # 选择模型
    messages=[
        {"role": "system", "content": "你是 helpful 的AI助手"},
        {"role": "user", "content": "解释什么是API，用通俗语言说明"}
    ],
    temperature=0.7,  # 控制随机性，0严谨1创意
    max_tokens=1024   # 最大输出长度
)

# 打印结果
print("AI回答：\n", response.choices[0].message.content)

运行脚本后，控制台会输出清晰的API解释，代表调用成功。核心参数说明：model指定模型版本，temperature平衡回答严谨性与创造性，max_tokens限制输出字数。

四、进阶实战：流式输出实现实时回复

长文本生成时，流式输出可实时展示结果，提升交互体验，只需开启stream=True参数。

import os
from openai import OpenAI

client=OpenAI(
    api_key=os.environ.get('DEEPSEEK_API_KEY'),
    base_url="https://api.deepseek.com"
)

# 流式调用
stream=client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "写一段200字的AI发展简介"}],
    stream=True
)

# 实时打印输出
print("AI实时回复：\n")
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

运行后，文字会逐字输出，类似ChatGPT的实时回复效果，适合聊天机器人、内容创作等场景。

五、常见问题与避坑指南

1. 401鉴权错误：多为API Key错误或环境变量未配置，重新核对密钥并正确设置环境变量。
2. 模型调用失败：确认模型名称正确（如deepseek-v4-pro），旧模型名即将下线，需及时更新。
3. 速率限制报错：免费额度有限，高频调用需升级套餐或优化请求频率。

六、总结与拓展

本文完成了DeepSeek API从注册到流式调用的全流程实战，核心在于密钥安全管理和接口参数配置。作为AI开发入门核心技能，API调用可快速集成到聊天机器人、内容生成、代码辅助等场景。