Answer
向 Copilot 提问并获取回答，附带引用和来源。
POST /v1/copilot/answer以 JSON 请求体发送输入。回答需要数秒，请将超时设为最多 120 秒。
请求
curl -X POST "https://gateway.apinoa.com/v1/copilot/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"}'参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
prompt | string | 是 | The question, as a person would type it. |
country | string | The market the answer is asked from, as an ISO 3166 country code. Each engine's page lists its countries. | |
include | enum list | page: also return the answer as a self-contained HTML page, in page. |
这些参数及所有响应类型也写在OpenAPI 文档中。
响应
在 data 中返回 Answer。 真实响应的节选：数组只保留前几项，长文本已截断。
{
"success": true,
"data": {
"engine": "copilot",
"outcome": "answered",
"prompt": "What are the best running shoes for beginners?",
"askedAt": "2026-11-08T00:11:17.564Z",
"country": "US",
"language": "en-US",
"title": "Best Running Shoes for Beginners in 2026",
"blocks": [
{
"type": "paragraph",
"markdown": "The **ASICS Novablast 6** is the strongest all‑around beginner pick th…"
},
{
"type": "heading",
"level": 3,
"markdown": "✅ Top Overall Pick"
},
{
"type": "paragraph",
"markdown": "**ASICS Novablast 6** — Best beginner shoe overall"
},
{
"type": "list",
"ordered": false,
"items": [
{
"markdown": "**Why it works:** Outstanding cushioning that protects your legs as yo…",
"depth": 0
}
]
}
],
"text": "The ASICS Novablast 6 is the strongest all‑around beginner pick thanks…",
"markdown": "The **ASICS Novablast 6** is the strongest all‑around beginner pick th…",
"citations": [
{
"start": 197,
"end": 243,
"sources": [
1
]
}
],
"sources": [
{
"url": "https://runrepeat.com/guides/best-for-beginners-running-shoes",
"title": "7 Best Running Shoes For Beginners in 2026 - RunRepeat",
"site": "RunRepeat",
"favicon": "https://th.bing.com/th/id/ODF.ekmCiAFMQY-67T3t-jB_1w?w=16&h=16&c=10&pid=genserp&rm=2",
"snippet": "The 7 best running shoes for beginners based on extensive wear and lab…",
"cited": true,
"ext": {
"displayUrl": "https://runrepeat.com › guides › best-for-beginners-running-shoes"
}
},
{
"url": "https://www.rtings.com/running-shoes/reviews/best/beginners",
"title": "The 5 Best Running Shoes For Beginners of 2026 - RTINGS.com",
"site": "RTINGS.com",
"favicon": "https://th.bing.com/th/id/ODF.JG-7jC49BJkulfbWgwcl8g?w=16&h=16&c=10&pid=genserp&rm=2",
"snippet": "We've tested over 310 running shoes, and these are our picks for the b…",
"cited": true,
"ext": {
"displayUrl": "https://www.rtings.com › running-shoes › reviews › best › beginners"
}
}
],
"mentions": [],
"cards": [],
"suggestions": [],
"ext": {
"model": "Gpt5Mini"
}
}
}错误
| 状态 | 代码 | 含义 |
|---|---|---|
| 400 | INVALID_PARAMS | 参数缺失、未知、超出范围，或该引擎不接受。消息中会指出是哪一个。 |
| 401 | UNAUTHORIZED | 缺少 x-api-key 请求头，或密钥已吊销或未知。 |
| 402 | INSUFFICIENT_BALANCE | 余额不足以支付本次调用。请在控制台充值。 |
| 429 | MARKETPLACE_SATURATED | 并发调用过多。请等待 Retry-After 秒后重试。 |
| 502 | UPSTREAM_ERROR | 引擎返回了无法使用的内容。请退避后重试。 |
| 502 | UPSTREAM_TIMEOUT | 引擎未能及时回答。请重试。 |
| 503 | SERVICE_UNAVAILABLE | 临时故障。请退避后重试。 |
全部错误代码见 Errors。失败的调用不计费。
价格
价格 每次调用 $0.0012。标价；单日调用超过 1,000 次后单价下调。
说明
- Copilot 一次只回答一个问题：每次都请完整地提问。它不接受
conversation和photos。 - Copilot 用提问所用的语言回答。
ext.model是 Copilot 声明的作答模型名称。