第3章 You.com Answer API 详解

获取基于实时网络结果的合成答案，附带来源引用。

Answer API 采用纯 REST 接口，Product MCP 不包含 you-answer 工具。搜索、内容、研究和金融功能请使用 Product MCP。无密钥的 you-search 和 you-discover 可通过 https://api.you.com/mcp?profile=free 访问。

安装 Docs MCP 服务器

Docs MCP 服务器允许你的智能体在这些文档的全库中进行搜索，免费使用。安装 https://you.com/docs/_mcp/server，请参考 Docs MCP 服务器指南了解更多详情。

什么是 Answer API

Answer API 返回带有引用和生成该答案所用网络结果的合成自然语言回答。

发送查询时，可选地设置时效性、地区、域名和显性内容过滤。API 会检索网络结果并合成带内联引用的答案。未知或多余的请求字段将被拒绝。

端点

每个 API 都有独立端点。所有请求都在 X-API-Key 头部中发送你的 API 密钥。

API 端点 指南 API 参考 Web Search API POST https://ydc-index.io/v1/search (也支持 GET) Overview /v1/search Contents API POST https://ydc-index.io/v1/contents Overview /v1/contents Answer API POST https://api.you.com/v1/answer Overview /v1/answer Research API POST https://api.you.com/v1/research Overview /v1/research Finance Research API POST https://api.you.com/v1/finance_research Overview /v1/finance_research

Answer、Research 和 Finance Research API 仅运行在 api.you.com 上。将上述路径发送至 ydc-index.io 将返回 403 错误，错误消息为 {"message": "Missing Authentication Token"}，即使密钥有效也是如此。

工作原理

Answer API 在 Web Search API 和 Contents API 相同的检索和提取基础设施上运行托管流水线。对于每个查询，它检索网络结果，提取最相关的支持内容，并在单次请求中合成带引用的答案。你无需配置搜索策略、页面读取、提示词或模型选择。

API 在返回答案前会验证每个引用均存在于源文本中且支持该答案。引用中的摘录是 LLM 用于构建答案的原文段落，因此你可以在不完全依赖模型的情况下确认准确性。

在 SimpleQA 基准测试中，Answer API 报告准确率为 93.48%。典型 p50 延迟为 2.67 秒。由于没有需要调整的努力等级，延迟和成本在不同查询中保持可预测。

何时使用 Answer API

当你希望在一次调用中从实时网络结果获取带引用的 Markdown 答案，且无需配置 research_effort 或 output_schema 时，请使用 Answer API。

当你需要自己选择模型、提示词和引用逻辑时，使用 Web Search API 和 Contents API 掌控流水线。当你需要轻级至前沿的深度、source_control 或结构化 JSON 时，使用 Research API。如果你已有 URL、需要金融优化索引，或想要 MCP 而非 REST，请参考“选择正确的 API”来匹配这些场景。

你将得到什么

每个 Answer API 响应均包含：

answer：带有编号内联引用（如 [[1, 2]]）的 Markdown 格式答案，引用 citations 数组中的项目。 citations：答案中引用的来源，按引用顺序排列。每项包含来源 URL 和 LLM 用于构建答案的原文摘录。 results.web：答案合成过程中考虑的所有网络结果，无论是否被引用。

results.web 中的每项包含 URL、标题和片段。来源元数据可包含 description、thumbnail_url 和 page_age（ISO 8601 发布时间戳）。

{ "answer": "The aurora borealis is caused by charged particles ejected from the Sun—carried by the solar wind and often intensified by solar flares or coronal mass ejections—that travel to Earth, are funneled by Earth's magnetic field toward the polar regions, and collide with oxygen and nitrogen atoms in the upper atmosphere. These collisions excite the atoms, which then release photons of light, creating the visible northern lights. [[1, 2]]", "citations": [ { "source": "https://www.jpl.nasa.gov/nmp/st5/SCIENCE/aurora.html", "excerpts": [ "Auroras are brilliant ribbons of light weaving across Earth's northern or southern polar regions. These natural light shows are caused by magnetic storms that have been triggered by solar activity." ] }, { "source": "https://www.valofinland.com/what-causes-the-colours-in-aurora-borealis/", "excerpts": [ "When these particles reach Earth, they collide with gases in our atmosphere, such as oxygen and nitrogen. These collisions excite the gas particles, causing them to emit light." ] } ], "results": { "web": [ { "url": "https://www.jpl.nasa.gov/nmp/st5/SCIENCE/aurora.html", "title": "How Auroras Form", "snippets": [ "Auroras are brilliant ribbons of light weaving across Earth's northern or southern polar regions." ] } ] }}

参数

query 为必填项，其他字段均为可选。

参数 类型 必填 说明 query string 是 待回答的问题或提示。限 400 字符，不能为空。 freshness string 否 day、week、month、year 或 YYYY-MM-DDtoYYYY-MM-DD 格式的日期范围 country string 否 来自支持集的 countryCode（如 US、GB 或 FR），决定网络结果的地理范围 language string 否 来自支持集的语言标签（如 EN、EN-GB 或 FR），决定网络结果的语言 safesearch string 否 网络结果的显性内容过滤：off、moderate（默认）或 strict include_domains string[] 否 仅返回这些域名的结果。最多 500 个域名。不能与 exclude_domains 或 boost_domains 同时使用 exclude_domains string[] 否 排除这些域名的结果。最多 500 个域名。不能与 include_domains 同时使用。可与 boost_domains 一起使用 boost_domains string[] 否 优先展示这些域名的结果，但不排除其他域名。最多 500 个域名。可与 exclude_domains 一起使用，但不能与 include_domains 一起使用

查看完整 API 参考

使用 freshness、locale、域名过滤器和 safesearch 引导结果。请参考搜索控制。

常见用例

AI 应用中的问答

在需要基于事实且带引用的响应的应用中使用 Answer API，包括聊天机器人、副驾和研究工具。发送问题即可获取有来源的答案，无需配置研究深度。

内容流水线

将 Answer API 用作写作前的研究步骤：提出问题，获取带引用的详尽答案，并将其作为报告、文章或简报的素材。

内部知识工具

允许员工提出复杂问题——如产品对比、法规摘要、技术深入分析——并获取有来源的答案，无需手动阅读数十个页面。

最佳实践

撰写具体问题以获得更好答案

对于复杂主题，包含上下文、约束或你希望覆盖的具体角度。“PostgreSQL 和 MongoDB 在 10M 行的写密集型工作负载中的权衡是什么？”比“比较数据库”能产生更聚焦的答案。

使用搜索控制定向结果

当你需要最新信息时设置 freshness。从支持的值中选择 country 和 language 以控制网络结果的地域和语言。设置 safesearch 以控制显性内容过滤。使用 include_domains 设置严格白名单，使用 exclude_domains 移除不需要的来源，或使用 boost_domains 优先展示特定来源而不过滤其他结果。请参考搜索控制。

在高利害场景下验证引用

内联引用编号对应 citations 数组。在法律、金融或医疗场景下，在向前端展示声明前，构建一个步骤来跟踪每个来源 URL 并检查支持性摘录。

当深度比速度更重要时使用 Research

如果你的用例需要在选择快速事实答案和详尽或前沿分析之间权衡，Research API 的 research_effort 参数提供了这种控制。

定价

请参考计费页面了解完整定价详情。

如需批量折扣、年度定价或企业功能，请访问 you.com/pricing 或联系 api@you.com。

数据保留

在严格隐私、合规或安全规定下运营的组织可以在企业协议中添加零数据保留（ZDR）。ZDR 限制整个账户范围内 Answer API 请求和响应内容的保留，且无需更改你的集成。请参考零数据保留了解其覆盖范围和启用方法。

下一步

快速入门：发起你的第一个 Answer API 请求 搜索控制：时效性、地区、域名过滤器和 safesearch API 参考：完整参数参考、请求/响应模式和交互式沙盒 Research API：当深度重要时，使用努力等级控制研究深度