Apinoa Docs

AI Answers API

ChatGPT、Gemini、Google AI 概览、Google AI Mode 和 Naver AI 对提问给出的回答，附带全部引用、来源、商品卡片和品牌提及，统一为一种回答类型。

查看原始 .mdx

AI Answers API 向 AI 引擎提问，并返回用户看到的回答：正文、所引用的来源、商品和地点卡片，以及引擎自己标出的品牌。 所有引擎返回同一种类型，因此追踪 ChatGPT 如何谈论某个品牌，与追踪 Google AI Mode 的方式完全相同。

curl -X POST "https://gateway.apinoa.com/v1/chatgpt/answer" \
  -H "x-api-key: $APINOA_API_KEY" -H "content-type: application/json" \
  -d '{"prompt": "What are the best running shoes for beginners?", "country": "US"}'

引擎

每个引擎只有一个操作：answer。

引擎国家对话图片通常不超过
ChatGPTUS DE GB AT KR AU JP CA FR IT✓✓30 秒
GeminiUS DE GB AT KR AU JP CA FR IT✓15 秒
Google AI ModeUS✓35 秒
Google AI OverviewsUS10 秒
Naver AI TabKR✓40 秒
Naver AI BriefingKR10 秒

回答需要数秒而非数毫秒。每次调用请预留最多 120 秒。

输入

输入含义
prompt问题，按人的输入方式书写（必填）
country提问所在的市场。各引擎的国家见上表，第一个为默认值
language回答语言（Google 引擎）。其他引擎用提问的语言回答
conversation之前回答的 conversation.id，用于在同一对话中追问
photos最多四张要提问的图片，格式为 https URL 或 data:image/…;base64, URL（ChatGPT）
includepage：同时以独立的 HTML 页面返回回答

以 POST 的 JSON 请求体发送输入。引擎不接受的输入会以 400 INVALID_PARAMS 拒绝，消息中说明原因，绝不会被悄悄忽略。

结果类型

outcome 说明引擎做了什么：

  • answered：回答了。
  • noAnswer：该提问没有显示回答。Google 只对部分搜索显示 AI 概览，Naver 只对部分搜索显示简报。周围的搜索结果仍在 results 中返回，由于页面已读取，本次调用计费。
  • refused：拒绝回答；它的原话在 text 中。
  • partial：中途停止，但返回了部分正文。

处处相同的部分

  • 一种类型。 每个引擎都返回 Answer。只有某个引擎才有的信息放在 ext 中。
  • 正文、Markdown 与区块一致。 text 和 markdown 由 blocks 生成，citations 指向 text 的字符范围。
  • 来源，无论是否引用。 sources 列出引擎显示的全部来源。cited 区分回答链接的来源和仅读取过的来源。
  • 提及只来自引擎本身。 mentions 是引擎自己标出的品牌、商品和地点，绝不从正文中猜测。
  • 价格。 每个回答 $0.0012。

错误

AI Answers API 使用与 API 其他部分相同的响应格式和代码，见 Errors。引擎未能及时回答时返回 502 UPSTREAM_TIMEOUT。失败的调用不计费。

参考

Trending

获取某个国家当前在 Google 上的热门搜索。

Response Schema

每个 AI 引擎返回的 Answer 类型：回答正文、引用和来源、卡片、提及和追问建议。

本页内容

引擎输入结果类型处处相同的部分错误参考