Apinoa Docs

Answer

向 Dola (Doubao) 提问并获得回答,附带来源。

查看原始 .mdx
POST /v1/dola/answer

以 JSON 请求体发送输入。回答需要数秒,请将超时设为最多 120 秒。

请求

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

参数

参数类型必填说明
promptstring是The question, as a person would type it.
conversationstringAn earlier answer's conversation.id: ask a follow-up in the same conversation.
countrystringThe market the answer is asked from, as an ISO 3166 country code. Each engine's page lists its countries.
includeenum listpage: also return the answer as a self-contained HTML page, in page.

这些参数及所有响应类型也写在OpenAPI 文档中。

响应

在 data 中返回 Answer。 真实响应的节选:数组只保留前几项,长文本已截断。

{
  "success": true,
  "data": {
    "engine": "dola",
    "outcome": "answered",
    "prompt": "What are the best running shoes for beginners?",
    "askedAt": "2026-11-11T01:31:49.701Z",
    "country": "KR",
    "language": "en",
    "blocks": [
      {
        "type": "heading",
        "level": 1,
        "markdown": "🏃 Best Running Shoes for Beginners (2026)"
      },
      {
        "type": "paragraph",
        "markdown": "Great question! The ideal beginner shoe prioritizes **comfort, cushioning, stability, and durability** — not speed or fancy tech. Here are m…"
      },
      {
        "type": "rule"
      }
    ],
    "text": "🏃 Best Running Shoes for Beginners (2026)\n\nGreat question! The ideal beginner shoe prioritizes comfort, cushioning, stability, and durabilit…",
    "markdown": "# 🏃 Best Running Shoes for Beginners (2026)\n\nGreat question! The ideal beginner shoe prioritizes **comfort, cushioning, stability, and durab…",
    "citations": [],
    "sources": [
      {
        "url": "https://www.rtings.com/running-shoes/reviews/best/running",
        "title": "The 7 Best Running Shoes of 2026 - RTINGS.com",
        "site": "rtings.com",
        "cited": false,
        "ext": {
          "docId": "f538ac5ebedb0ebb-bd4b6a2a4c56e838",
          "searchId": "2026111101315317201800102650044588",
          "index": 1
        }
      },
      {
        "url": "https://www.runrepeat.com/uk/guides/best-for-beginners-running-shoes",
        "title": "7 Best Running Shoes For Beginners in 2026 | RunRepeat",
        "site": "runrepeat.com",
        "cited": false,
        "ext": {
          "docId": "abc0cc96bb831a0d-692220fe4d575423",
          "searchId": "2026111101315317201800102650044588",
          "index": 2,
          "rank": 1
        }
      },
      {
        "url": "https://www.sportsgearlab.com/best-running-shoes-for-beginners/",
        "title": "Best Running Shoes for Beginners 2026: Comfort Guide",
        "site": "sportsgearlab.com",
        "cited": false,
        "ext": {
          "docId": "e5b80fd9e68a24c8-5c1b007e028ceffb",
          "searchId": "2026111101315317201800102650044588",
          "index": 3,
          "rank": 2
        }
      }
    ],
    "mentions": [],
    "cards": [],
    "suggestions": [],
    "ext": {
      "steps": [
        "Searching the web",
        "Found 2 sources",
        "Found 6 sources"
      ],
      "searches": [
        "best running shoes for beginners 2026",
        "beginner running shoes guide cushion support durability"
      ],
      "searchSummary": "Searched for 2 keywords · 12 sources",
      "finishReason": "succeed:completion",
      "hasSuggestions": true
    }
  }
}

错误

状态代码含义
400INVALID_PARAMS参数缺失、未知、超出范围,或该引擎不接受。消息中会指出是哪一个。
401UNAUTHORIZED缺少 x-api-key 请求头,或密钥已吊销或未知。
402INSUFFICIENT_BALANCE余额不足以支付本次调用。请在控制台充值。
429MARKETPLACE_SATURATED并发调用过多。请等待 Retry-After 秒后重试。
502UPSTREAM_ERROR引擎返回了无法使用的内容。请退避后重试。
502UPSTREAM_TIMEOUT引擎未能及时回答。请重试。
503SERVICE_UNAVAILABLE临时故障。请退避后重试。

全部错误代码见 Errors。失败的调用不计费。

价格

价格 每次调用 $0.0012。标价;单日调用超过 1,000 次后单价下调。

说明

  • Dola 以提问所用的语言回答,不接受 language。
  • 用上一个回答的 conversation 继续追问;对话大约保持 30 分钟。
  • Dola 会列出来源,但不说明每个句子依据哪个来源,因此 citations 为空,所有来源的 cited 均为 false。来源包含 url、title 和 site,没有摘要片段。
  • 可从 KR、JP、DE、GB、AU、FR、IT、SG、TW、HK、CN 提问。Dola 本身不在中国大陆提供,因此 CN 由字节跳动在大陆的服务豆包(Doubao)回答,响应结构相同。US、CA 不可用,调用会以 COUNTRY_UNAVAILABLE 失败。不接受 photos。
  • 回答通常需要 10 到 35 秒。

本页内容