大模型接入总指南-API文档-有道智云AI开放平台

一、有道智云账号系统

1. 接入前先看这一页

如果你只是想最快跑通一次大模型调用，请按下面 6 步走：

注册并登录有道智云控制台。
创建或选择一个应用，并在服务中勾选“大模型”。
在控制台创建 APIKey。
选择接入协议：优先使用 OpenAI 兼容协议；已有 Anthropic SDK 或 Messages 格式时使用 Anthropic 协议。
使用 APIKey 发起一次非流式请求，确认鉴权、模型名、请求体都正确。
再根据业务需要接入流式输出、工具调用、联网搜索、安全检测和限流保护。

大模型接入流程图

2. 你需要准备什么

准备项	是否必须	说明
有道智云账号	是	用于登录控制台、创建应用、管理 APIKey。
已开通“大模型”服务的应用	是	APIKey 与应用权限相关，未开通服务会导致无权限。
APIKey	是	通过 `Authorization: Bearer ${API_KEY}` 进行鉴权。
模型代号	是	如 `deepseek-chat`。具体可用模型以模型接入信息页面为准。
服务端调用环境	建议	不建议在浏览器前端直接暴露 APIKey。
日志与告警	上线必须	用于定位错误码、超时、限流、余额不足等问题。

3. 控制台配置流程

3.1 新用户：还没有应用

进入有道智云控制台并完成注册。
登录后，在左侧导航栏选择“大模型管理”。
点击“大模型”，进入大模型应用概览页。
在“应用概览”区域右上角点击“创建应用”。
在“选择服务”中找到“大模型”。
勾选“大模型”，并选择 API 接入方式。
点击“确定”，完成应用创建与权限开通。

入口位置如下图所示：

创建应用入口

3.2 老用户：已有应用

登录有道智云控制台。
在“业务总览”中选择已有应用。
点击“修改应用”。
在“选择服务”中勾选“大模型”。
点击“确定”，完成权限更新。

3.3 创建 APIKey

登录控制台。
进入“业务总览”。
在左侧导航栏选择“大模型管理”。
进入“大模型”应用概览页后，可以在应用卡片的 APIkey 一行点击 + 创建。
也可以进入“API Keys”页面，在页面右上角点击“创建API key”。
创建成功后复制 APIKey。
将 APIKey 放入服务端环境变量或密钥管理系统。

入口位置如下图所示：

创建 APIKey 入口

推荐环境变量命名：

bash

YOUDAO_LLM_API_KEY="你的 APIKey"

不要把 APIKey 写进前端代码、公开仓库、接口返回值或客户端日志。

4. 接入协议怎么选

有道智云大模型网关提供两类协议入口。

协议	地址	适合场景
OpenAI 兼容协议	`https://openapi.youdao.com/llmgateway/api/v1/chat/completions`	已有 OpenAI SDK、Chat Completions 格式、国内常见模型调用封装。
Anthropic 兼容协议	`https://openapi.youdao.com/llmgateway/anthropic/v1/messages`	已有 Anthropic SDK、Messages 格式，或业务内部统一使用 Anthropic 风格。

建议：

新接入项目优先选择 OpenAI 兼容协议，生态更通用，迁移成本更低。
已有系统如果已经抽象成 Anthropic Messages 格式，可以直接使用 Anthropic 协议。
同一个业务不要混用两种协议，除非你已经有统一的模型网关层。

5. API 基本信息

5.1 OpenAI 兼容协议

http

POST https://openapi.youdao.com/llmgateway/api/v1/chat/completions
Content-Type: application/json
Authorization: Bearer ${YOUDAO_LLM_API_KEY}

5.2 Anthropic 兼容协议

http

POST https://openapi.youdao.com/llmgateway/anthropic/v1/messages
Content-Type: application/json
Authorization: Bearer ${YOUDAO_LLM_API_KEY}

本文后续示例以 OpenAI 兼容协议为主。

6. 模型接入信息

调用接口时，请在请求体的 model 字段中填写对应模型代码。下表整理了当前大模型文档中展示的主要模型入口：

正在加载模型信息……

接入时请以各模型官方文档为准。不同模型在上下文长度、最大输出、多模态能力、思考模式和 Function Calling 支持上可能不同。

建议接入流程：

7. 模型价格

模型调用费用会因模型、输入 token、输出 token、缓存、联网搜索等能力而不同。接入前请先确认所选模型的计费规则，避免上线后成本不可控。

模型调用价格具体可参考：模型价格。

上线前建议确认：

当前业务使用哪些模型。
每个模型的输入和输出单价。
是否涉及联网搜索、思考模式、工具调用等可能影响成本的能力。
是否需要按用户、应用、模型维度统计 token 消耗。
是否需要设置预算告警、限流或降级模型。

8. 常用参数

名称	类型	是否必填	默认值	备注	其他信息
`model`	string	必填		模型名称参考文档"五、模型接入"文档的模型代号信息	DeepSeek 系列模型：按模型区分思考模式 chat：非思考模式 reasoner：思考模式 Kimi 系列模型：使用 thinking 参数控制思考模式（默认开启） `"thinking": {"type": "enabled"}` 开启思考模式 `"thinking": {"type": "disabled"}` 关闭思考模式
`messages`	object []	必填		消息列表	[{"role": "system","content": "You are a helpful assistant."},{"role": "user","content": "How's the weather in Hangzhou?"},{"role": "assistant","content": "","tool_calls": [{"id": "chatcmpl-tool-f6c2f72b91284f31b51988456cd9e8f0","type": "function","function": {"name": "get_weather","arguments": "{\"location\":\"Hangzhou\"}"}}]},{"role": "tool","tool_call_id": "chatcmpl-tool-f6c2f72b91284f31b51988456cd9e8f0","content": "24℃"},{"role": "assistant","content": "The weather in Hangzhou is currently 24°C."},{"role": "user","content": [{"type": "image_url","image_url": {"url": "data:image/png;base64,内容为使用 base64 编码过的图片内容"}},{"type": "text","text": "请描述图片的内容。"}]}]
`stream`	boolean	非必填	false	是否流式返回
`stream_options`	object	非必填		流式响应时的配置	备注：流式响应时的配置
`max_tokens`	integer	非必填	4096	模型的最大 tokens 数量：默认值 4096，最大 16k	mock：@natural(0,10000)
`stop`	string []	非必填		模型遇到 stop 字段所指定的字符串时将停止继续生成，这个词语本身不会输出。最多支持 4 个字符串。	item 类型：string
`presence_penalty`	number	非必填		存在惩罚系数。如果值为正，会根据新 token 到目前为止是否出现在文本中对其进行惩罚，从而增加模型谈论新主题的可能性。取值范围为 [-2.0, 2.0]。
`frequency_penalty`	number	非必填		频率惩罚系数。如果值为正，会根据新 token 在文本中的出现频率对其进行惩罚，从而降低模型逐字重复的可能性。取值范围为 [-2.0, 2.0]。
`temperature`	number	非必填		采样温度。控制了生成文本时对每个候选词的概率分布进行平滑的程度。取值范围为 [0, 2]。当取值为 0 时模型仅考虑对数概率最大的一个 token。较高的值（如 0.8）会使输出更加随机，而较低的值（如 0.2）会使输出更加集中确定。通常建议仅调整 temperature 或 top_p 其中之一，不建议两者都修改。
`top_p`	number	非必填		核采样概率阈值。模型会考虑概率质量在 top_p 内的 token 结果。取值范围为 [0, 1]。当取值为 0 时模型仅考虑对数概率最大的一个 token。如 0.1 意味着只考虑概率质量最高的前 10% 的 token，取值越大生成的随机性越高，取值越低生成的确定性越高。通常建议仅调整 temperature 或 top_p 其中之一，不建议两者都修改。
`logit_bias`	object	非必填		调整指定 token 在模型输出内容中出现的概率，使模型生成的内容更加符合特定的偏好。logit_bias 字段接受一个 map 值，其中每个键为词表中的 token ID（使用 tokenization 接口获取），每个值为该 token 的偏差值，取值范围为 [-100, 100]。-1 会减少选择的可能性，1 会增加选择的可能性；-100 会完全禁止选择该 token，100 会导致仅可选择该 token。该参数的实际效果可能因模型而异。	备注：调整指定 token 在模型输出内容中出现的概率，使模型生成的内容更加符合特定的偏好。logit_bias 字段接受一个 map 值，其中每个键为词表中的 token ID（使用 tokenization 接口获取），每个值为该 token 的偏差值，取值范围为 [-100, 100]。-1 会减少选择的可能性，1 会增加选择的可能性；-100 会完全禁止选择该 token，100 会导致仅可选择该 token。该参数的实际效果可能因模型而异。
`tools`	object []	非必填		待调用工具的列表，模型返回信息中可包含。当您需要让模型返回待调用工具时，需要配置该结构体。	`[{"type": "function","function": {"name": "get_weather","description": "Get weather of an location, the user shoud supply a location first","parameters": {"type": "object","properties": {"location": {"type": "string","description": "The city and state, e.g. San Francisco, CA"}},"required": ["location"]}}}]`
`thinking`	object	非必填	DeepSeek 系列模型：该参数不生效 Kimi 系列模型：默认值为 true	思考模式开启参数 enabled：开启思考模式 disabled：关闭思考模式	开启思考模式 `{"type": "enabled"}` 关闭思考模式
`web_search`	object	非必填	disabled	联网搜索 enabled：开启联网搜索 disabled：不开启联网搜索	`{"type": "enabled"}`
`safe`	object	非必须		安全检测默认 disable 关闭 input_type：输入安全检测 output_type：输出安全检测赋值说明 disabled：关闭安全检测 enabled：开启安全检测特别说明 input_type 输入安全检测对 onetime、sse 流式请求都生效 output_type 输出安全检测，目前仅对 onetime 请求生效，对 sse 流式请求不生效输出检测生效传参：stream = false，output_type=enabled 输出检测报错传参：stream = true，output_type=enabled	`{"input_type": "disabled","output_type": "enabled"}`

9. 消息格式

messages 是对话上下文数组，常用角色包括：

role	用途
`system`	设置模型身份、回答风格和约束。
`user`	用户输入的问题或任务。
`assistant`	历史轮次中的模型回复，用于多轮对话。
`tool`	工具调用结果，仅在使用工具调用时需要。

普通文本请求示例：

json

{
  "model": "deepseek-chat",
  "messages": [
    {
      "role": "system",
      "content": "你是一个专业、简洁的企业知识库助手。"
    },
    {
      "role": "user",
      "content": "请总结这段会议纪要的关键事项。"
    }
  ],
  "stream": false
}

多轮对话时，把上一轮 user 和 assistant 消息继续放入 messages 即可。图片输入、工具调用等能力取决于具体模型，请先确认模型能力后再接入。

10. 请求示例

建议首次调试使用非流式请求，方便一次性查看完整返回。

cURL方式

bash

curl -X POST "https://openapi.youdao.com/llmgateway/api/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${YOUDAO_LLM_API_KEY}" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {
        "role": "user",
        "content": "你好，请用一句话介绍你自己。"
      }
    ],
    "stream": false,
    "max_tokens": 512,
    "temperature": 0
  }'

JavaScript方式：

bash

import OpenAI from "openai";

const client = new OpenAI({
    baseURL: "https://openapi.youdao.com/llmgateway/api/v1",
    apiKey: "YOUR_API_KEY",
});

async function chat() {
    const response = await client.chat.completions.create({
        model: "deepseek-chat",
        messages: [
            { role: "user", content: "你好，请介绍一下你自己" }
        ],
    });
    console.log(response.choices[0].message.content);
}

chat();

python方式

bash

from openai import OpenAI

client = OpenAI(
    base_url="https://openapi.youdao.com/llmgateway/api/v1",
    api_key="YOUR_API_KEY"
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ],
    stream=False
)

print(response.choices[0].message.content)

成功标准：HTTP 状态码为 200，返回体中存在 choices，并且可以从 choices[0].message.content 读取模型回答。

11. 返回结果处理

11.1 流式返回

正常返回（http code = 200）：结果完全兼容 OpenAI SDK，可参考火山引擎的文本对话 API 文档：对话(Chat) API

流式返回结果示例（因返回内容过多，做了删减，仅保留必要的结构）

完整 JSON 数据


data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057407,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"simple_search.start","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057407,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"search.start","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057407,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"rewrite_query.start","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057411,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"rewrite_query.done","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057411,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"websearch.start","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057411,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"parallel_batch_search.start","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057413,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"searcher.partial_completed","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057413,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"searcher.partial_completed","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057414,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"searcher.partial_completed","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057415,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"searcher.partial_completed","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057415,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"parallel_batch_search.done","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057421,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"websearch.done","references":null}}

data:{"id":"web-search-2416bf35-c30c-4ffb-890f-a0d385d89f0a","created":1757057421,"choices":null,"usage":null,"model":"deepseek-v3.1-250821","object":"chat.completion.chunk","search_results":{"stage":"simple_search.done","references":[{"index":1,"title":"格尔软件：在“量子风暴”中铸就“信任基座”","url":"<https://finance.sina.com.cn/jjxw/2025-07-11/doc-infezzct3018635.shtml","snippet":"在不久前落幕的第十一届中国（上海）国际技术进出口交易会上，格尔软件自主研发的抗量子密码（PQC）安全解决方案入选“十大项目”，成为信息安�...","publish_time":"2025-07-11T08:11:08"},{"index":2,"title":"中国电信强化量子技术攻关> 筑牢数字时代安全防线","url":"<https://finance.sina.com.cn/tech/roll/2025-07-02/doc-infeafyn2578836.shtml","snippet":"今年6月是我国第24个全国“安全生产月”，安全生产始终是经济社会发展的基石，而信息安全作为其中的核心环节，正面临日益复杂的挑战——数据泄�...","publish_time":"2025-07-02T20:48:11"},{"index":3,"title":"后量子加密走向标准化","url":"http://www.news.cn/liangzi/20250723/a6cec4c3e168446bb0df24e99923e449/c.html","snippet":"参考消息网7月19日报道据《日本经济新闻》7月15日报道，关于将信息通信必不可少的加密方式转向“后量子加密”(PQC)的讨论正在取得进展，这种加密�...","publish_time":"2025-07-23T00:00:00"},{"index":4,"title":"量子计算将如何挑战> IoT 安全","url":"<https://finance.sina.com.cn/tech/roll/2025-07-11/doc-inffafmr2967107.shtml","snippet":"现代非对称密码学的关键是创建一个方程，该方程在一个方向上很容易求解，但很难被另一个方向的对手逆转。传统上，这是通过模算术完成的，其中�...","publish_time":"2025-07-11T10:22:33"},{"index":5,"title":"全球首例！中国量子密码技术开启商用新时代：抗量子计算安全体系","url":"https://m.toutiao.com/a7504651526250693156/","snippet":"2025年5月14日，中国电信量子集团以一场全球瞩目的技术发布会给出了答案——> 全球首个融合量子密钥分发（QKD）与后量子密码算法（PQC）的分布式密码体系正式商用 ！ 这不仅是中国在抗量子计算安全领域的里程碑，更意味着我国在量子通信技术领域实现了从“跟跑”到“领跑”的跨越式突破。","publish_time":"2025-05-15T20:49:00+08:00"},{"index":6,"title":"破解量子计算威胁：格尔软件展示新一代密码防护体系","url":"<https://m.163.com/dy/article/K1SI0TCQ051984TV.html","snippet":"以广泛应用的RSA-2048加密算法为例，传统计算机需要耗费数千年才能完成的大数分解运算，量子计算机借助秀尔算法可在数小时内破解，这意味着当前存储的加密数据可能在未来量子计算技术突破时瞬间暴露。更严峻的是，量子计算攻击具有独特的"先存储后破解"特性。攻击者无需即时破解加密信息，只需窃取并存储当前加密数据，待","publish_time":"2025-06-12T19:15:37+08:00"},{"index":7,"title":"重磅发布！泰雷兹Luna> HSM固件支持PQC 算法，全面抵御量子威胁","url":"<https://www.sohu.com/a/926829310_122058772","snippet":"根据Gartner预测，2030年量子计算将能够攻破传统的加密算法。...该版本可帮助客户和合作伙伴开发稳定、符合标准的解决方案，并将量子安全加密技术无缝集成到系统和基础架构中，从而保护关键的应用程序、身份、交易和敏感数据。...","publish_time":"2025-08-29T15:30:14+08:00"},{"index":8,"title":"微软“先下手为强”2033年完成量子安全大迁徙，你的数据还安全吗？","url":"https://new.qq.com/rain/a/20250822A085LU00?media_id=&suid=","snippet":"这也就意味着，像RSA这种依赖于大数因子分解的公钥加密算法，在量子计算机面前将不堪一击，只需数小时便可被轻易破解。而对于对称加密算法，比如被广泛使用的> AES-256，虽然...最终目标是调整量子安全加密标准并支持全球互作性。...","publish_time":"2025-08-29T15:30:14+08:00"},{"index":9,"title":"我们可能要经历一场紧迫的密码算法大迁徙","url":"<https://m.blog.csdn.net/djkeyzx/article/details/144402562","snippet":"11月12日，NIST发布了名为《Transition> to Post-Quantum Cryptography Standards》的内部研究报告，描绘了从易受量子攻击的密码算法向量子抗性算法过渡的路线图；沿用FIPS197的AE...","publish_time":"2024-12-11T18:00:33+08:00"},{"index":10,"title":"NIST发布后量子密码迁移路线图公开草案","url":"<https://www.secrss.com/articles/72377","snippet":"11月12日，美国国家标准与技术研究院（NIST）发布了过渡到后量子密码学（PQC）标准的初始公开草案（《Transition> to Post-...","publish_time":"2024-11-14T00:00:00+08:00"},{"index":11,"title":"终于，历时7年 NIST发布3份后量子密码学标准草案","url":"<https://www.360doc.cn/article/73390753_1093766363.html","snippet":"...https://www./news-events/news/2020/07/nists-post-quantum-cryptography-program-enters-selection-round> [3]<https://www./news-events/news/2023/08/nist-st...","publish_time":"2023-08-24T00:00:00+08:00"},{"index":12,"title":"微软“抢跑”量子安全技术，力推NIST抗量子加密算法标准","url":"https://www.secrss.com/articles/70265","snippet":"...entity/microsoft-s-quantum-resistant-cryptography-is-here/ba-p/4238780https://arstechnica.com/security/2...","publish_time":"2024-09-14T00:00:00+08:00"},{"index":13,"title":"全球首例！我国量子密码技术实现双重加密突破> - 新华网","url":"<http://www.news.cn/liangzi/20250523/2cbb2bf9569f4545942bcdd83fcf24be/c.html","snippet":"记者5月14日获悉，近日中电信量子集团发布了全球首个融合QKD（量子密钥分发）和PQC（后量子密码学）的分布式密码体系。该体系创新融合QKD和PQC技术，为用户> ...","publish_time":"2025年5月16日"},{"index":14,"title":"解读后量子密码学热潮| F5","url":"<https://www.f5.com.cn/company/blog/weighing-in-on-the-post-quantum-cryptography-hype","snippet":"量子计算即将到来，它将颠覆保护我们的数据、通信和基础设施的加密系统。> 现在正是开始准备的最佳时机。 在这个由六部分组成的后量子密码学（PQC）博客系列中 ...","publish\_time":"2025年6月26日"},{"index":15,"title":"抗量子计算密码及应用研讨会在京举办 - 中国计算机学会","url":"<https://www.ccf.org.cn/Chapters/TC/News_/2024-11-18/837117.shtml","snippet>":"... 《抗量子计算密码及应用研讨会》于2024年11月15日在京举办。 近年来量子计算发展迅速，引发公钥密码破解的信息安全威胁日益迫近，应对量子计算信息安全 ...","publish_time":"2024年11月18日"}]}}

data:{"id":"chatcmpl-70db0094ed0a411e92e33e545d0477e6","created":1757057421,"choices":[{"index":0,"finish_reason":null,"delta":{"role":"assistant","content":"","reasoning\_content":""},"message":null}],"usage":null,"model":"deepseek_v3_1","object":"chat.completion.chunk"}

data:{"id":"chatcmpl-70db0094ed0a411e92e33e545d0477e6","created":1757057421,"choices":[{"index":0,"finish_reason":null,"delta":{"role":"assistant","content":"量子","reasoning_content":""},"message":null}],"usage":null,"model":"deepseek_v3_1","object":"chat.completion.chunk"}

data:{"id":"chatcmpl-70db0094ed0a411e92e33e545d0477e6","created":1757057421,"choices":[],"usage":{"completion_tokens":1365,"prompt_tokens":17007,"total_tokens":18372,"prompt_tokens_details":{"cached_tokens":0},"completion_tokens_details":{"reasoning_tokens":0}},"model":"deepseek_v3_1","object":"chat.completion.chunk"}

data:[DONE]

11.2 非流式返回

完整 JSON 数据

json

{
  "id": "chatcmpl-75faf4da524e44b58709bde376b35c66",
  "created": 1757054733,
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "量子计算在密码学领域的应用呈现出双刃剑效应：一方面对现有加密体系构成严峻挑战，另一方面又催生了新一代安全技术。以下是量子计算在密码学中的主要应用方向：\n\n### 一、量子计算对传统密码学的威胁\n\n#### 1. **破解现有加密算法**\n量子计算机运行**Shor算法**可在多项式时间内破解基于大整数分解和离散对数问题的公钥加密算法[^8]：\n- **RSA加密**：2048位RSA密钥的破解时间可从百万年缩短至小时级[^3][^7]\n- **椭圆曲线密码（ECC）**：包括SM2等国密算法面临同等威胁[^1]\n- **威胁范围**：全球超80%的数字身份系统依赖这些传统算法[^1]\n\n量子计算机运行**Grover算法**可对对称加密算法（如AES）实现平方加速攻击，使AES-256的安全性降至约等于AES-128的水平[^7]。\n\n#### 2. \"先窃取后解密\"（HNDL）攻击\n攻击者现已开始囤积加密数据，等待量子计算成熟后解密，威胁长期保密数据的安全[^1][^2]。美国NIST警告此类威胁已进入现实阶段[^1]。\n\n### 二、量子密码学的防御性应用\n\n#### 1. **量子密钥分发（QKD）**\n基于量子力学原理实现无条件安全密钥分发：\n- **核心原理**：利用量子态不可克隆特性，任何窃听行为都会扰动量子态而被检测[^9][^11]\n- **实际应用**：\n  - 中国\"京沪干线\"项目实现4000公里密钥分发[^9]\n  - 电子政务涉密文件传输中采用\"三阶段QKD\"架构，传输成功率高达99.998%[^9]\n  - 与5G网络融合，时延从200ms降至35ms[^9]\n\n#### 2. **抗量子密码（PQC）**\n开发能抵抗量子计算攻击的新型加密算法：\n\n**算法类型**：\n- **基于格的密码**（如NTRU、CRYSTALS-Kyber）：利用格上最短向量问题[^3][^7]\n- **基于编码的密码**：利用纠错码解码问题[^3]\n- **基于哈希的签名**：利用哈希函数抗碰撞性[^3]\n\n**标准化进展**：\n- NIST于2024年8月发布全球首批3个抗量子加密标准[^1]\n- 中国2025年2月启动新一代商用密码算法全球征集[^1]\n- 微软计划2029年前完成核心服务PQC迁移[^2]\n\n### 三、混合解决方案与实施挑战\n\n#### 1. **混合加密架构**\n- **QKD+传统加密**：量子密钥分发与传统加密结合[^9]\n- **PQC+传统加密**：过渡期采用混合模式确保向后兼容[^7]\n- **量子-经典混合加密**：中国密码学会提出组合方案，抗攻击强度提升至2^256[^9]\n\n#### 2. **技术实施挑战**\n- **QKD限制**：单光子探测效率低（<5%），信道衰减限制（<100km）[^9]\n- **物联网设备**：低功耗设备缺乏支持PQC所需的内存和计算资源[^4]\n- **标准化缺失**：全球尚未形成统一QKD应用标准[^9]\n\n### 四、行业应用与时间表\n\n#### 1. **各领域应用进展**\n- **金融行业**：中国银河证券开展抗量子密码技术在证券业的应用研究[^1]\n- **政务系统**：电子投票防篡改、电子证照防伪造[^1]\n- **物联网**：智能电网、车联网设备认证体系[^1]\n\n#### 2. **全球迁移时间表**\n- **美国**：2030年底弃用RSA，2035年底现有加密方式失效[^3]\n- **英国**：计划2035年前完成切换[^2]\n- **日本**：2026财年向政府机构提交过渡方针[^3]\n- **中国**：积极推进PQC标准制定和算法征集[^1]\n\n### 五、未来发展方向\n\n1. **多协议融合**：QKD与区块链、零信任架构结合[^9]\n2. **跨域应用**：中国\"东数西算\"工程计划西部部署10个QKD数据中心[^9]\n3. **硬件突破**：量子中继器、抗干扰探测器研发[^9]\n4. **人才培养**：高校与企业合作培养密码专业人才[^1]\n\n量子计算既带来了密码学领域的\"量子风暴\"，也推动了抗量子密码技术的快速发展。当前正处于传统密码体系向后量子密码过渡的关键时期，需要全球协作加快标准化和产业化进程，以应对量子计算时代的网络安全挑战。",
        "reasoning_content": ""
      }
    }
  ],
  "usage": {
    "completion_tokens": 1041,
    "prompt_tokens": 13306,
    "total_tokens": 14347,
    "prompt_tokens_details": {
      "cached_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 0
    }
  },
  "model": "deepseek_v3_1",
  "object": "chat.completion",
  "search_results": {
    "stage": "simple_search.done",
    "references": [
      {
        "index": 1,
        "title": "格尔软件：在“量子风暴”中铸就“信任基座”",
        "url": "https://finance.sina.com.cn/jjxw/2025-07-11/doc-infezzct3018635.shtml",
        "snippet": "在不久前落幕的第十一届中国（上海）国际技术进出口交易会上，格尔软件自主研发的抗量子密码（PQC）安全解决方案入选“十大项目”，成为信息安�...",
        "publish_time": "2025-07-11T08:11:08"
      },
      {
        "index": 2,
        "title": "微软加速量子安全密码学算法集成进程",
        "url": "https://k.sina.com.cn/article_1686203097_64816ad9001018zy8.html?from=tech&subch=internet",
        "snippet": "在量子安全计划（QSP）推出两年后，微软正稳步推进将后量子密码学（PQC）算法集成到其产品套件安全基础组件的进程中。\n这家计算巨头表示，为确保�...",
        "publish_time": "2025-08-21T21:46:35"
      },
      {
        "index": 3,
        "title": "后量子加密走向标准化",
        "url": "https://www.news.cn/liangzi/20250723/a6cec4c3e168446bb0df24e99923e449/c.html",
        "snippet": "参考消息网7月19日报道\n据《日本经济新闻》7月15日报道，关于将信息通信必不可少的加密方式转向“后量子加密”(PQC)的讨论正在取得进展，这种加密�...",
        "publish_time": "2025-07-23T00:00:00"
      },
      {
        "index": 4,
        "title": "量子计算将如何挑战 IoT 安全",
        "url": "https://finance.sina.com.cn/tech/roll/2025-07-11/doc-inffafmr2967107.shtml",
        "snippet": "现代非对称密码学的关键是创建一个方程，该方程在一个方向上很容易求解，但很难被另一个方向的对手逆转。传统上，这是通过模算术完成的，其中�...",
        "publish_time": "2025-07-11T10:22:33"
      },
      {
        "index": 5,
        "title": "量子计算在量子密码学中的应用潜力与2025年技术挑战报告.docx",
        "url": "https://m.book118.com/html/2025/0610/5213214041012222.shtm",
        "snippet": "量子计算在量子密码学中的应用潜力与2025年技术挑战报告 一、量子计算在量子密码学中的应用潜力 1.1 量子密码学的理论基础 1.2 量子计算在量子密码学中的应用 1.2.1 量子密钥分发 1.2.2 量子加密算法 1.2.3 量子密码分析 1.3 量子计算在量子密码学中的应用优势 1.4 量子计算在量子密码学中的应用前景 1.4...",
        "publish_time": "2025-06-11T00:00:00+08:00"
      },
      {
        "index": 6,
        "title": "2025年量子计算技术在量子密码学领域的应用探索报告.docx",
        "url": "https://max.book118.com/html/2025/0521/5200334141012210.shtm",
        "snippet": "2025年量子计算技术在量子密码学领域的应用探索报告参考模板 一、2025年量子计算技术在量子密码学领域的应用探索报告 1.1 量子计算技术概述 1.2 量子密码学概述 1.3 量子计算技术在量子密码学领域的应用探索 1.3.1 量子密钥分发 1.3.2 量子密码分析 1.3.3 量子密码协议 1.3.4 ",
        "publish_time": "2025-05-22T00:00:00+08:00"
      },
      {
        "index": 7,
        "title": "量子安全编码解析 | 2025技术视角（基于量子计算威胁的加密升级方案）",
        "url": "https://m.blog.csdn.net/blns_yxl/article/details/145874734",
        "snippet": "‌ 一、核心概念对比 ‌ ‌ 特性 ‌ ‌ Base64 ‌ ‌ 抗量子加密（如NTRU）‌ ‌ 本质 ‌ 编码方式（非加密）数学加密算法 ‌ 安全性 ‌ 无保护，可轻松解码 抵御量子计算攻击 ‌ 适用场景 ‌ 二进制转文本、简单数据掩码 量子环境下的敏感数据（如国防、金融） ‌ 破解难度 ‌ 即时解码（无需算力）量子计算机也无法在有效时间内破解 ‌ 二、为什么量子计算威胁传统",
        "publish_time": "2025-02-26T13:25:04+08:00"
      },
      {
        "index": 8,
        "title": "量子计算对现有加密算法的挑战-全面剖析",
        "url": "https://m.renrendoc.com/paper/415407008.html",
        "snippet": "2第二部分Shor算法及其影响 4第三部分RSA加密的安全性 8第四部分ECC加密的脆弱性 11第五部分Hash函数的量子攻击 14第六部分密码哈希算法挑战 17第七部分后量子加密算法 21第八部分安...",
        "publish_time": "2025-04-30T00:00:00+08:00"
      },
      {
        "index": 9,
        "title": "量子密钥分发在电子政务涉密文件加密存储与安全传输中的应用实践",
        "url": "https://m.blog.csdn.net/2501_92477643/article/details/148698812",
        "snippet": "全球尚未形成统一的QKD应用标准。中国《量子通信技术安全要求》（GB/T 38829-2020）规定了密钥分发频率、误码率阈值等12项指标（CNCA,2020）。IEEE 1900.8标准工作组正在制定\"量子通信网络架构标准\"，预计2025年完成（IEEE Standards Association,2023）。未来发展方向 多协议融合 IBM提出的\"QKD+区块链\"架构（IBM Research,2023），将",
        "publish_time": "2025-06-16T19:29:07+08:00"
      },
      {
        "index": 10,
        "title": "第四期：后量子密码学开创的新时代",
        "url": "https://www.xjtlu.edu.cn/zh/professors-of-xjtlu-public-lecture/2025/lecture-4",
        "snippet": "为了迎接即将到来的量子计算时代，我们需要构建能够抵御量子计算机攻击的新型公钥密码体制。在本讲座中，我们将介绍后量子密码学及其最新发展，特别是NIST 的标准化进程及其 ...",
        "publish_time": ""
      },
      {
        "index": 11,
        "title": "[PDF] 量子保密通信技术发展及应用前沿报告",
        "url": "https://www.china-cic.cn/upload/202012/05/73453ac5127a48aeb2a01f218460b9e5.pdf",
        "snippet": "该报告将量子通信界定为基于量子随机数发生器（QRNG）和量. 子密钥分发（QKD）等技术，实现保密通信、长期安全存储、云计算. 等密码学相关应用，以及未来用于 ...",
        "publish_time": "2020年12月5日"
      },
      {
        "index": 12,
        "title": "[PDF] 量子计算密码攻击进展 - 计算机学报",
        "url": "http://cjc.ict.ac.cn/online/onlinepaper/08150%20%E7%8E%8B%E6%BD%AE-202094103159.pdf",
        "snippet": "量子计算密码攻击需要探索新的途径：一是，量子计算能否协助/加速传统密码攻击模式，拓展已有量子. 计算的攻击能力；二是，需要寻找Shor 算法之外的量子计算算法探索密码攻击.",
        "publish_time": ""
      },
      {
        "index": 13,
        "title": "抗量子密码：为全球网络安全筑起新防线",
        "url": "http://old2022.bulletin.cas.cn/zgkxyyk/ch/reader/view_news.aspx?id=20240904151528001",
        "snippet": "这一发现预示着，一旦能够运行Shor算法的大型量子计算机被研发出来，现有的公钥密码算法将失去效用，互联网的信任与安全通信体系将面临瓦解，全球社会经济活动 ...",
        "publish_time": "2024年9月4日"
      },
      {
        "index": 14,
        "title": "红帽企业Linux 布局后量子密码学 - Red Hat",
        "url": "https://www.redhat.com/zh-cn/technologies/linux-platforms/enterprise-linux-10/post-quantum-cryptography",
        "snippet": "红帽企业Linux 10 率先采用了经美国国家标准与技术研究院（NIST）认证的抗量子算法，帮助您及早针对量子计算带来的威胁筑起安全防线。 红帽企业Linux 10 现已支持后量子 ...",
        "publish_time": ""
      },
      {
        "index": 15,
        "title": "聚焦量子安全之二密码面临的最高危风险——量子计算攻击",
        "url": "http://www.qiac.org.cn/kepuhuicui/299.html",
        "snippet": "使用Shor算法挖掘对称密码算法的弱结构的成功概率和效率不如对公钥密码那样高。也就是一般情况下经过量子傅里叶变换输出后的规律比较微弱、不够显著，无法 ...",
        "publish_time": "2022年11月26日"
      }
    ]
  }
}

12. 错误码与排查路径

HTTP 状态码/错误	常见原因	处理建议
`400`	请求体格式错误，不是合法 JSON，或字段类型错误	检查入参格式是否正确.
`401`	APIKey 错误、无权限、余额不足	检查 APIKey、应用是否开通大模型服务、账户余额。
`422`	参数异常或超时异常	根据错误信息修改参数；必要时联系维护团队。
`429`	RPM 或 TPM 达到上限	降低并发、增加排队、做限流和重试。
`500`	服务内部异常	稍后重试；持续出现时联系维护团队。
`103501/104201/104203/104204`	服务超时	低峰期重试，或向维护团队反馈。
`103503`	服务繁忙或异常，暂时无法响应	稍后重试，增加退避策略。
`103504`	TCP 连接异常	记录请求 ID 和时间，向维护团队反馈。
`100118/100119`	黑白名单限制	切换到推荐新模型，或联系支持确认权限。

高频问题：

返回 401 时，优先检查 Authorization: Bearer ${API_KEY}、应用是否开通“大模型”服务、账户余额是否充足。
content 字段报错时，确认纯文本模型传入的是字符串，而不是数组。
流式请求报安全检测错误时，检查是否误用了 safe.output_type=enabled。

13. 限流说明

服务按照“智云平台应用 + 模型”的维度限流。可以理解为：

text

(应用id, model) -> 流量组 -> 对应限流额度

例如：

appKey1 + DeepSeek-R1 会映射到一个流量组。
appKey2 + DeepSeek-V3 会映射到另一个流量组。
不同应用、不同模型的流量会分别统计和限流。

文档中给出的默认限流配置：

指标	默认值
RPM	1000
TPM	5M
回答总超时时间	10 分钟

上线建议：

服务端增加本地限流，避免所有请求直接打到模型网关。
对 429 使用指数退避重试。
高并发场景下增加队列，允许用户排队或降级到更快模型。
记录每个模型的调用量、失败率、平均耗时和 token 消耗。

14. 推荐工程架构

不要让前端直接调用有道智云 API。推荐在业务后端封装一层模型服务。

模型服务封装层建议统一处理 APIKey、请求体、错误码、流式响应、限流重试、usage 统计和日志监控。

一、有道智云账号系统 ​

1. 接入前先看这一页 ​

2. 你需要准备什么 ​

3. 控制台配置流程 ​

3.1 新用户：还没有应用 ​

3.2 老用户：已有应用 ​

3.3 创建 APIKey ​

4. 接入协议怎么选 ​

5. API 基本信息 ​

5.1 OpenAI 兼容协议 ​

5.2 Anthropic 兼容协议 ​

6. 模型接入信息 ​

7. 模型价格 ​

8. 常用参数 ​

9. 消息格式 ​

10. 请求示例 ​

11. 返回结果处理 ​

11.1 流式返回 ​

11.2 非流式返回 ​

12. 错误码与排查路径 ​

13. 限流说明 ​

14. 推荐工程架构 ​

一、有道智云账号系统

1. 接入前先看这一页

2. 你需要准备什么

3. 控制台配置流程

3.1 新用户：还没有应用

3.2 老用户：已有应用

3.3 创建 APIKey

4. 接入协议怎么选

5. API 基本信息

5.1 OpenAI 兼容协议

5.2 Anthropic 兼容协议

6. 模型接入信息

7. 模型价格

8. 常用参数

9. 消息格式

10. 请求示例

11. 返回结果处理

11.1 流式返回

11.2 非流式返回

12. 错误码与排查路径

13. 限流说明

14. 推荐工程架构