如何在中国境外使用 DeepSeek API：设置与检查

要在中国境外使用 DeepSeek API，先选择支持你的账户和部署地点的服务。你可以评估 DeepSeek 直连平台，或 Tokenhot 等网关。无论哪种方式，都需要该服务的端点、该服务签发的 API 密钥，以及所选路径实际支持的模型标识符。

没有一个延迟数字或注册规则适用于每个国家、账户和供应商。在围绕服务构建前，请检查所在地区当前的注册和付款选项。网关是一种访问选项；不应被视为可以忽略服务可用性规则的许可。

更新于 2026 年 9 月 14 日。代码示例是基于文档的起点，不是在线 API 性能测量。

直接访问 DeepSeek 还是使用网关？

决策项	DeepSeek 直连	Tokenhot 网关
端点	https://api.deepseek.com	https://api.tokenhot.ai/v1
凭据	来自 DeepSeek 平台的密钥	来自 Tokenhot 控制台的密钥
模型选择	DeepSeek API 文档中的当前标识符	Tokenhot 目录中的准确路径标识符
计费	DeepSeek 账户和当前第一方费率	Tokenhot 账户和显示的网关费率
评估主要原因	与模型提供商直接建立关系	通过一个服务访问多个模型家族

端点和 SDK 设置见 DeepSeek quick start和 Tokenhot quick start。密钥是服务专属的：不要将 DeepSeek 密钥发送到 Tokenhot，也不要将 Tokenhot 密钥发送到 DeepSeek。

如果现有 DeepSeek 账户已支持工作负载，请先测试该路径。若需要更广目录或不同账户安排，请比较网关选项。我们的 OpenRouter 替代方案指南涵盖初次 API 调用之外的兼容性和供应商选择问题。

复制旧示例前检查模型名称

DeepSeek 当前 quick start 推荐 deepseek-flash。它说明旧 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 名称在直连服务上仍可接受，但请求现使用 DeepSeek V4.1 Flash，因为对应的旧模型已退役。同一页面称 V4 Pro API 服务会在 2026 年 9 月 14 日后继续。当前 DeepSeek API 标识符。

因此，可用别名并不能证明调用的是未变更模型。在部署配置中记录端点、请求模型、可用时返回的模型元数据和验证日期。

不要假设网关遵循相同别名或退役时间表。明确选择其列出的标识符。历史 V4 Pro 发布、基准和权重要求请见 DeepSeek V4 Pro 指南。

使用 Python 发出一个小型首次调用

安装支持可配置基础 URL 和 Chat Completions 客户端的官方 OpenAI Python SDK：

pip install openai

对于直连访问，在 DeepSeek 平台创建密钥，并在环境中设置 DEEPSEEK_API_KEY。先使用短提示词，使身份验证和模型选择能在不产生大工作负载时得到检查。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DEEPSEEK_API_KEY"],
    base_url="https://api.deepseek.com",
    timeout=120.0,
    max_retries=0,
)

response = client.chat.completions.create(
    model="deepseek-flash",
    messages=[{"role": "user", "content": "Explain an API gateway in two sentences."}],
    stream=False,
)
print(response.choices[0].message.content or "")
print(response.usage)

显式超时和关闭自动重试可让初始诊断运行更易解释。它们是示例设置，不是每种工作负载的推荐限制。理解服务错误和应用时间预算后，再配置有界重试策略。

对于 Tokenhot，在 API 密钥控制台获取密钥，在模型目录选择 DeepSeek 路径，并在服务器环境设置 TOKENHOT_API_KEY 和 TOKENHOT_MODEL。将客户端和模型配置替换为：

client = OpenAI(
    api_key=os.environ["TOKENHOT_API_KEY"],
    base_url="https://api.tokenhot.ai/v1",
    timeout=120.0,
    max_retries=0,
)
model = os.environ["TOKENHOT_MODEL"]

在相同的基本 Chat Completions 调用中传入 model=model。通过配置选择模型，避免在教程中嵌入未经验证的网关别名。将凭据保留在服务器中，避免放入浏览器 bundle、公开仓库和诊断截图。

分别添加流式传输和推理选项

基本请求可用后，在所选路径测试流式传输。对于 Chat Completions 流，在访问内容前检查 chunk 是否含有 choice：

stream = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "Give three checks before deploying an API client."}],
    stream=True,
)
try:
    for chunk in stream:
        if chunk.choices:
            text = chunk.choices[0].delta.content
            if text:
                print(text, end="", flush=True)
finally:
    stream.close()

此处的 client 和 model 指向上面所选配置；对于直连示例，设置 model="deepseek-flash"。代码打印回答内容。不要假设每个推理模型都会将中间输出嵌入字面 <think> 标签。只解析路径文档规定的字段，并将辅助推理数据与最终回答分开。

DeepSeek 当前直连示例将 reasoning_effort 与 thinking 对象一起使用。这不能证明任意网关接受相同扩展或取值。仅在核查路径文档后添加这些控制项。工具、结构化输出、图像输入和长上下文也应逐项测试：共享客户端接口并不让每个模型功能可互换。

更换供应商前先诊断访问错误

一次失败请求本身不能证明存在区域网络封锁。先检查 HTTP 状态、服务错误消息、端点和模型选择。

症状	首先检查
身份验证错误	密钥是否由接收请求的服务创建，且仍有效？
余额不足	API 账户是否有可用于此路径的余额？
参数或模型无效	当前模型是否接受发送的标识符、字段和值？
速率限制	请求并发或 token 数量是否高于账户允许水平？
超时或服务器过载	小请求能否完成，服务是否报告了事故？
流中断	连接是否提前关闭，应用是否错误地将部分文本视为完整回答？

DeepSeek 对身份验证失败记录 401、余额不足 402、无效参数 422、限流 429，以及服务器问题 500/503。网关代码可能不同。请阅读相关服务的错误参考，而不是将一个供应商的重试策略套用到每条路径。DeepSeek 错误码。

为支持保留请求 ID 和已脱敏错误元数据。不要将 API 密钥或私密提示词粘贴到公开 issue 报告。对于重复失败，每次只更改一个变量：密钥、模型、请求体或网络位置。这会让结果可执行。

从部署区域测量延迟

从应用运行的服务器区域比较路径。附近的网关入口会影响网络连接时间，但生成还取决于排队、输入长度、模型计算、推理模式和输出长度。

对每项测试使用相同提示词、并发、输出设置和时间窗口。测量首个回答 token 的时间、总完成时间、成功率和已计费用量。记录计时是否包含连接建立，以及辅助推理是否在回答文本前到达。在有足够观察值后分别报告中位延迟和尾部延迟。

对长上下文任务，使用真实文档长度。短问候不能证明一条路径在大型代码库上的表现。对流式接口，除成功响应外还要测试中断和取消。本文不作通用低于 200ms 承诺，因为未包含受控的区域基准。

按实际路径比较账单和数据条款

使用你将支付的端点当前报价。第一方 DeepSeek 价格与 Tokenhot 网关费率是不同报价。缓存输入、普通输入、推理输出和随时间变化的定价都会改变有效成本；LLM API 定价比较提供可复现的计算框架。

添加资金前，检查账户显示的支付方式和任何最低购买额。不要假设每个国家都支持相同的卡或钱包。

对于敏感工作负载，审阅网关和上游供应商适用的数据条款。询问哪条路径处理请求、保留哪些运行日志，以及适用哪些合同保留设置。传输加密、关于保留的营销声明和已完成的合规评估回答的是不同问题。

进入生产前

确认账户受支持、准确模型可用、有代表性的请求能完成，并且使用量如预期出现。然后测试流式传输、错误处理、请求限制和应用所需的模型特定功能。保存带日期的配置记录，使后续别名或价格变动可见。

网关设置从 Tokenhot quick start开始，直连访问从 DeepSeek quick start开始；在扩大流量前，用自己的工作负载评估路径。