Answer
向 ChatGPT 提问并获取回答，附带引用、来源、卡片和提及。
POST /v1/chatgpt/answer以 JSON 请求体发送输入。回答需要数秒，请将超时设为最多 120 秒。
请求
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"}'参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
prompt | string | 是 | The question, as a person would type it. |
conversation | string | An earlier answer's conversation.id: ask a follow-up in the same conversation. | |
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. | |
photos | string[] | Up to four photos to ask about: https URLs, or data:image/…;base64, URLs. |
这些参数及所有响应类型也写在OpenAPI 文档中。
响应
在 data 中返回 Answer。 真实响应的节选：数组只保留前几项，长文本已截断。
{
"success": true,
"data": {
"engine": "chatgpt",
"outcome": "answered",
"prompt": "What are the best running shoes for beginners?",
"askedAt": "2026-10-30T01:00:31.899Z",
"country": "US",
"blocks": [
{
"type": "paragraph",
"markdown": "If you're just getting into running, I'd recommend starting with a pai…"
},
{"type": "paragraph", "markdown": "Here are my top recommendations for beginners in 2026."},
{"type": "cards", "cards": [0]}
],
"text": "If you're just getting into running, I'd recommend starting with a pai…",
"markdown": "If you're just getting into running, I'd recommend starting with a pai…",
"citations": [],
"sources": [
{
"url": "https://www.rtings.com/running-shoes/reviews/best/beginners",
"cited": false,
"title": "The 6 Best Running Shoes for Beginners of 2026 - RTINGS.com",
"site": "www.rtings.com",
"favicon": "https://www.google.com/s2/favicons?domain=https://www.rtings.com&sz=32"
}
],
"mentions": [
{
"name": "Brooks Ghost 18",
"kind": "product",
"category": "product",
"at": 305,
"ext": {"badges": ["Best overall"]}
}
],
"cards": [
{
"type": "image",
"title": "Brooks Ghost 18 Men's Primer Grey/Oyster Mushroom – Holabird Sports",
"url": "https://www.holabirdsports.com/products/brooks-ghost-18-mens-primer-gr…",
"image": "https://images.openai.com/static-rsc-4/gdRYkLjq-bR17fW27V3af80NtFn4L9l…",
"thumbnail": "https://images.openai.com/static-rsc-4/aoryHYHPeH-VtbKe9AMq-CeuVyRNzQu…",
"width": 800,
"height": 800,
"sponsored": false,
"ext": {
"original": "https://www.holabirdsports.com/cdn/shop/files/044666_1_800x.jpg?v=1779…",
"query": "Brooks Ghost 18 running shoes"
}
}
],
"suggestions": [
{
"text": "Find my best running shoes",
"prompt": "Recommend the best beginner running shoes based on these preferences:…"
}
],
"ext": {
"useCase": "shopping",
"modelExperience": "instant",
"steps": ["Searching the web"],
"layout": {
"program": "function __dilSafe(evaluate,failureValue){try{return evaluate()}catch{…",
"constants": {
"0": "If you're just getting into running, I'd recommend starting with a pai…",
"1": "comfortable, well-cushioned daily running shoes",
"2": ". You don't need expensive racing shoes or anything overly technical.",
"3": "Here are my top recommendations for beginners in 2026.",
"4": "🏃 Best running shoes for beginners",
"5": "a588d0a9-b3f2-5d84-b96a-e7dbc7573701",
"6": "Best overall",
"7": "1. ",
"8": "Brooks Ghost 18",
"9": "3ffebd24-1b61-5e95-8b90-4667c80853e6",
"10": "$150",
"11": "Comfortable, balanced cushioning.",
"12": "Great for everyday road running.",
"13": "A reliable first running shoe.",
"14": "Best if you want one shoe for most runs.",
"15": "339f3929-b005-5464-9db1-8a1b00da4b7e",
"16": "Best cushioned all-rounder",
"17": "2. ",
"18": "ASICS Novablast 6",
"19": "8b156f63-e995-50c6-9723-932c37fb8cb4",
"20": "Soft, responsive cushioning.",
"21": "Lightweight feel.",
"22": "Great for building up running distance.",
"23": "Best if you want comfort with a little bounce.",
"24": "caeda85d-331b-5956-b5d3-e030ea256046",
"25": "3. ",
"26": "HOKA Clifton 11",
"27": "0fc28757-f71e-5bfe-a04f-e3f232ba79fb",
"28": "$155",
"29": "Soft, protective cushioning.",
"30": "Lightweight for its cushioning level.",
"31": "Excellent for run/walk training.",
"32": "Best if you're starting with a Couch to 5K plan.",
"33": "6a501449-4b60-543b-91b6-71a191bd9f68",
"34": "4. ",
"35": "Nike Vomero 18",
"36": "5212da76-3de1-5bcb-80f1-b7b378478858",
"37": "$155",
"38": "Plush, maximum cushioning.",
"39": "Comfortable for longer easy runs.",
"40": "Soft and responsive underfoot.",
"41": "Best if comfort is your biggest priority.",
"42": "eac36d13-dd19-5522-8e8e-ff2ed1602705",
"43": "5. ",
"44": "New Balance Fresh Foam 680 v9",
"45": "1bbf6e8f-3c49-5733-af2d-0e07430e50e3",
"46": "Practical everyday trainer.",
"47": "Comfortable cushioning.",
"48": "A good option for budget-conscious beginners.",
"49": "Best for an affordable first pair.",
"50": "a4e63692-5937-5d73-bfab-3b417068dc56",
"51": "6. ",
"52": "Brooks Adrenaline GTS 25",
"53": "386c636a-91f2-503d-a31e-c46a6537de44",
"54": "Supportive stability design.",
"55": "Comfortable cushioning.",
"56": "Useful if you prefer more guidance underfoot.",
"57": "Best if you need a stability shoe.",
"58": "Prices are approximate US retail prices. Recommendations informed by ",
"59": "Runner's World",
"60": "25bfac6e-fbcd-5e68-a028-1e13eb99de53",
"61": " and ",
"62": "RTINGS 2026 testing",
"63": "dedf923e-efb9-5796-821d-1bd07d4a9183",
"64": ".",
"65": "What should you look for as a beginner?",
"66": "My advice:",
"67": "Cushioning:",
"68": " Look for comfortable cushioning, but not necessarily the thickest sol…",
"69": "Fit:",
"70": " Leave about a thumb's width of space between your longest toe and the…",
"71": "Width:",
"72": " Your toes should be able to spread naturally.",
"73": "Weight:",
"74": " Avoid unnecessarily heavy shoes.",
"75": "Support:",
"76": " Don't assume you need stability shoes just because you're a beginner.",
"77": "Try shoes on later in the day when your feet are slightly swollen, and…",
"78": "Let me narrow it down to the best shoe for you",
"79": "A few details will help me recommend the right pair rather than just t…",
"80": "1. What's your budget?",
"81": "Under $80",
"82": "$80–$100",
"83": "$100–$150",
"84": "$150–$200",
"85": "No limit",
"86": "2. What's your main goal?",
"87": "Start running / lose weight",
"88": "Train for a 5K",
"89": "Run a 10K or longer",
"90": "Improve fitness and endurance",
"91": "Run and walk for general health",
"92": "3. Where will you run?",
"93": "Road / pavement",
"94": "Treadmill",
"95": "Trails / parks",
"96": "Combination of surfaces",
"97": "4. What's most important?",
"98": "Maximum comfort and cushioning",
"99": "Lightweight and flexible",
"100": "Extra stability and support",
"101": "Best value for money",
"102": "Find my best running shoes",
"103": "I'll use your answers to narrow it down to the three shoes I'd recomme…"
}
},
"forms": [
{
"suggestion": 0,
"submit": "Find my best running shoes",
"prompt": "Recommend the best beginner running shoes based on these preferences:…",
"fields": [
{
"name": "budget",
"control": "radio-group",
"options": [{"value": "Under $80", "label": "Under $80"}],
"default": "100–150",
"label": "1. What's your budget?"
}
]
}
]
},
"conversation": {"id": "c_f2Yfh5reFisXUt4Wga6Mkw", "turn": 1, "expiresAt": "2026-10-30T04:00:43.744Z"}
}
}错误
| 状态 | 代码 | 含义 |
|---|---|---|
| 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 次后单价下调。
说明
- 要追问，把回答中的
conversation.id作为conversation传入。 photos最多接受四张要提问的图片，格式为 https URL 或data:image/…;base64,URL。- ChatGPT 用提问所用的语言回答。