Skip to main content
三方模型调用教程

DeepSeek-阿里云

本文档介绍如何在阿里云百炼平台通过OpenAI兼容接口或DashScope SDK调用DeepSeek系列模型。

deepseek-v3、deepseek-v3.1、deepseek-v3.2、deepseek-v3.2-exp、deepseek-r1、deepseek-r1-0528、deepseek-r1-distill-qwen-7b/14b/32b 将于2026年10月10日下架。推荐转用:qwen3.7-plusqwen3.7-maxqwen3.6-flash

服务接入地址

不同地域的服务接入地址不同,请根据您选择的地域配置对应的 Base URL(调用时请将{WorkspaceId}替换为真实的业务空间ID)。各地域可调用的模型及限流不同,请参见限流文档。
  • OpenAI兼容
  • OpenAI兼容-Responses API
  • DashScope
  • 华北2(北京)
  • 美国(弗吉尼亚)
  • 新加坡
  • 德国(法兰克福)
  • 日本(东京)
SDK 调用配置的base_urlhttps://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1HTTP 请求地址:POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions

快速开始

deepseek-v4-pro-0813 是 DeepSeek 系列旗舰模型,在编程、数学和通用任务方面表现出色。deepseek-v4-flash-0731 是Flash系列最新版本。您可以通过enable_thinking参数在思考与非思考模式之间切换。以下示例以 deepseek-v4-pro 模型为例展示思考模式的调用方式,您可以将 model 参数替换为其他 DeepSeek 模型。 需要已获取与配置 API Key并完成配置API Key到环境变量。如果通过SDK调用,需要安装 OpenAI 或 DashScope SDK
  • OpenAI兼容
  • DashScope
  • Anthropic兼容
enable_thinking非 OpenAI 标准参数,OpenAI Python SDK通过 extra_body传入,Node.js SDK作为顶层参数传入。reasoning_effort是 OpenAI 标准参数,可直接作为顶层参数传入。
  • Python
  • Node.js
  • HTTP

示例代码

from openai import OpenAI
import os
# 初始化OpenAI客户端
client = OpenAI(
    # 如果没有配置环境变量,请用阿里云百炼API Key替换:api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 以下为华北2(北京)地域的URL。请将 {WorkspaceId} 替换为您的百炼业务空间ID,各地域的URL不同。
    base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
)
messages = [{"role": "user", "content": "你是谁"}]
completion = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=messages,
    # 通过 extra_body 设置 enable_thinking 开启思考模式
    extra_body={"enable_thinking": True},
    stream=True,
    stream_options={
        "include_usage": True
    },
)
reasoning_content = ""  # 完整思考过程
answer_content = ""  # 完整回复
is_answering = False  # 是否进入回复阶段
print("\n" + "=" * 20 + "思考过程" + "=" * 20 + "\n")
for chunk in completion:
    if not chunk.choices:
        print("\n" + "=" * 20 + "Token 消耗" + "=" * 20 + "\n")
        print(chunk.usage)
        print("Request ID:", chunk.id)
        continue
    delta = chunk.choices[0].delta
    # 只收集思考内容
    if hasattr(delta, "reasoning_content") and delta.reasoning_content is not None:
        if not is_answering:
            print(delta.reasoning_content, end="", flush=True)
        reasoning_content += delta.reasoning_content
    # 收到content,开始进行回复
    if hasattr(delta, "content") and delta.content:
        if not is_answering:
            print("\n" + "=" * 20 + "完整回复" + "=" * 20 + "\n")
            is_answering = True
        print(delta.content, end="", flush=True)
        answer_content += delta.content

返回结果

====================思考过程====================
嗯,用户问了一个非常简单的自我介绍问题:"你是谁"。
我需要明确自己的身份,用简洁友好的方式介绍我是DeepSeek,说明我的创造者、基本特性和可提供的帮助。
想到了可以这样组织回答:先直接表明身份,说明由深度求索公司创造,然后列出一些关键特点(免费、长上下文、文件上传等),最后以友好的邀请结束,询问是否需要帮助。
====================完整回复====================
你好!我是 DeepSeek,由深度求索公司创造的 AI 助手。
我可以帮你解答各种问题、进行文字创作、分析文档、编程辅助等等。我最大的特点是**免费使用**、**超长上下文**(能一次处理整本三体三部曲那么多内容)、支持**文件上传**和**联网搜索**(需手动开启)。
有什么我可以帮你的吗?不管是学习、工作还是日常闲聊,我都很乐意陪你聊聊!
====================Token 消耗====================
CompletionUsage(completion_tokens=238, prompt_tokens=5, total_tokens=243, completion_tokens_details=CompletionTokensDetails(accepted_prediction_tokens=None, audio_tokens=None, reasoning_tokens=93, rejected_prediction_tokens=None), prompt_tokens_details=None)
Request ID: chatcmpl-a1b2c3d4-e5f6-7890-abcd-ef1234567890

推理强度(reasoning_effort)

deepseek-v4-pro、deepseek-v4-flash 、 deepseek-v4-flash-0731 和 deepseek-v4-pro-0813默认开启思考模式。通过reasoning_effort参数可以调整推理强度,可选值为low(仅deepseek-v4-flash-0731 和 deepseek-v4-pro-0813 支持)highmax,默认为high
  • OpenAI兼容
  • DashScope
Python
from openai import OpenAI
import os
client = OpenAI(
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 以下为华北2(北京)地域的URL。请将 {WorkspaceId} 替换为您的百炼业务空间ID,各地域的URL不同。
    base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
)
completion = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "9.9和9.11哪个大"}],
    reasoning_effort="high",
)
print(completion.choices[0].message.content)

Responses API

deepseek-v4-flashdeepseek-v4-flash-0731deepseek-v4-prodeepseek-v4-pro-0813支持通过 OpenAI 兼容的 Responses API 调用,仅支持华北2(北京)与新加坡地域,服务接入地址参见服务接入地址 通过 Responses API 调用时,可在tools参数中添加web_search联网搜索)、web_extractor网页抓取)与code_interpreter代码解释器)工具。
Python
from openai import OpenAI
import os

client = OpenAI(
    # 如果没有配置环境变量,请用阿里云百炼API Key替换:api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # 以下为华北2(北京)地域的URL。新加坡地域请使用 https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
    base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
)

response = client.responses.create(
    model="deepseek-v4-flash",
    input="你好,请用一句话介绍你自己。",
    # 可选:通过 tools 参数开启联网搜索、网页抓取与代码解释器工具
    tools=[
        {"type": "web_search"},
        {"type": "web_extractor"},
        {"type": "code_interpreter"},
    ],
)

# 获取模型回复
print(response.output_text)

其它功能

模型多轮对话Function Calling联网搜索上下文缓存结构化输出前缀续写
deepseek-v4-pro支持支持支持支持支持不支持
deepseek-v4-pro-us支持支持支持支持支持不支持
deepseek-v4-flash-0731支持支持支持支持支持不支持
deepseek-v4-flash支持支持支持支持支持不支持
deepseek-v4-flash-us支持支持支持支持支持不支持
deepseek-v3.2支持支持支持支持不支持不支持
deepseek-v3.2-exp支持支持
仅支持非思考模式。
支持不支持不支持不支持
deepseek-v3.1支持支持
仅支持非思考模式。
支持支持不支持不支持
deepseek-r1支持支持支持支持不支持不支持
deepseek-r1-0528支持支持支持不支持不支持不支持
deepseek-v3支持支持支持支持不支持不支持
蒸馏模型支持不支持不支持不支持不支持不支持

参数默认值

模型

temperature

top_p

repetition_penalty

presence_penalty

max_tokens

thinking_budget

deepseek-v4-pro

1.0

1.0

-

-

共393,216

deepseek-v4-pro-us

1.0

1.0

-

-

共393,216

deepseek-v4-flash-0731

1.0

1.0

-

-

共393,216

deepseek-v4-flash

1.0

1.0

-

-

共393,216

deepseek-v4-flash-us

1.0

1.0

-

-

共393,216

deepseek-v3.2

1.0

0.95

-

-

65,536

32,768

deepseek-v3.2-exp

0.6

0.95

1.0

-

65,536

32,768

deepseek-v3.1

0.6

0.95

1.0

-

65,536

32,768

deepseek-r1

0.6

0.95

-

1

16,384

32,768

deepseek-r1-0528

0.6

0.95

-

1

16,384

32,768

蒸馏版

0.6

0.95

-

1

16,384

16,384

deepseek-v3

0.7

0.6

-

-

16,384

-

  • “-” 表示没有默认值,也不支持设置。
  • deepseek-r1、deepseek-r1-0528、蒸馏版模型不支持设置以上参数值。
  • “共393,216” 表示 deepseek-v4 系列模型的 max_tokens 与 thinking_budget 共用同一上限,两者合计最大为 393,216 Token(即模型的最大输出长度)。
  • 参数含义请参考OpenAI兼容-Chat

模型列表与计费

  • 混合思考模型(通过enable_thinking参数控制是否思考):deepseek-v4-pro、deepseek-v4-flash、deepseek-v4-flash-0731、deepseek-v3.2、deepseek-v3.2-exp、deepseek-v3.1
  • 仅思考模型(回复前总会思考):deepseek-r1、deepseek-r1-0528
  • 非思考模型:deepseek-v3
deepseek-v4-pro 在编程、数学和通用任务方面表现出色,deepseek-v4-flash-0731 快速且经济高效,推荐优先使用 deepseek-v4-pro。 模型上下文长度与价格信息请参见百炼控制台。 按照模型的输入与输出 Token 计费。
思考模式下,思维链按照输出 Token 计费。

常见问题

免费额度用完后如何购买 Token?

访问费用与成本中心进行充值,确保您的账户没有欠费即可调用 DeepSeek 模型。
调用 DeepSeek 模型会自动扣费,出账周期为分钟级,消费明细请前往 账单详情 进行查看。

如何接入ChatboxCherry StudioDify

此处以常用工具为例进行说明,其它大模型工具的接入方式类似。
  • Chatbox
  • Cherry Studio
  • Dify
请参见Chatbox

可以上传图片或文档进行提问吗?

DeepSeek 模型仅支持文本输入,不支持图片或文档输入。如需图片输入,请使用千问VL模型;如需文档输入,请使用Qwen-Long模型。

如何查看Token消耗量及调用次数?

模型调用完一小时后,在模型观测页面设置查询条件(例如,选择时间范围、业务空间等),再在模型列表区域找到目标模型并单击操作列的监控,即可查看该模型的调用统计结果。具体请参见模型监控文档。
数据按小时更新,高峰期可能有小时级延迟,请您耐心等待。

还有哪些使用DeepSeek的方式?

在百炼平台使用DeepSeek有三种方式:
  1. 在线体验:访问模型广场
  2. 通过API或客户端(如Chatbox)调用模型:请参考本文内容。
  3. 0代码构建大模型应用:请参考智能体应用(Agent 1.0)工作流应用
如需自行部署DeepSeek,请参考技术解决方案

错误码

如果执行报错,请参见错误码进行解决。
Token Plan
模型体验
  • 3D模型生成
  • 音乐生成
模型调优
模型压缩目录节点
用量统计与性能监控
资产中心
服务支持