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

> Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/answers/llms.txt)

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

```bash
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`。

| 引擎 | 国家 | 对话 | 图片 | 通常不超过 |
|---|---|:-:|:-:|---|
| [ChatGPT](/docs/api-reference/chatgpt) | US DE GB AT KR AU JP CA FR IT | ✓ | ✓ | 30 秒 |
| [Gemini](/docs/api-reference/gemini) | US DE GB AT KR AU JP CA FR IT | ✓ | | 15 秒 |
| [Google AI Mode](/docs/api-reference/google-ai-mode) | US | ✓ | | 35 秒 |
| [Google AI Overviews](/docs/api-reference/google-aio) | US | | | 10 秒 |
| [Naver AI Tab](/docs/api-reference/naver-ai-tab) | KR | ✓ | | 40 秒 |
| [Naver AI Briefing](/docs/api-reference/naver-ai-brief) | KR | | | 10 秒 |

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

## 输入

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

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

## 结果类型

`outcome` 说明引擎做了什么：

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

## 处处相同的部分

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

## 错误

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

## 参考

- [Response Schema](/docs/api-reference/answers/response-schema)：回答的每个字段
- [SERP API](/docs/api-reference/serp)：搜索引擎，其 Google 结果中带有相同的 AI 概览
- [Errors](/docs/errors)：所有错误代码