> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Exa Contents

> 为一组 URL 提取完整页面文本、摘要和元数据。

获取 `ids` 中传入的一组 URL（或 Exa 结果 id）的完整页面内容。用 `text`（完整页面正文）、`highlights`（相关片段）和 `summary`（AI 生成的摘要）选择返回内容，并用 `subpages` 一并拉取链接的子页面。

优先返回缓存的即时结果；`livecrawl` 控制新鲜度——`always` 强制实时抓取，`fallback` 仅在缓存未命中时实时抓取，`never` 只返回缓存内容。每次成功请求固定计费 **\$0.08**；上游 4xx 响应不计费。如需先找到这些 URL，请从 [`post_exa-search`](/docs/zh/api-reference/search/post_exa-search) 开始。


## OpenAPI

````yaml openapi/zh/exa.json POST /exa/contents
openapi: 3.0.0
info:
  title: Exa API
  version: 1.0.0
  description: >-
    通过 AIsa 网关开放的 Exa 神经语义搜索 endpoint 的统一 API 文档：Search、Contents、Answer，以及异步的研究型
    Agent Runs。


    Search、Contents 和 Answer 为同步接口，每次成功请求固定计费 $0.08。Agent Runs
    为异步接口：调用方提交任务，然后轮询返回的任务资源以获取状态和结果，每次任务固定计费 $0.10。上游 4xx 响应（例如
    401/403/404）不计费。Exa 返回的 `costDollars` 字段是上游成本明细，仅供参考——客户计费以上述 AIsa 固定价格为准。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /exa/contents:
    post:
      tags:
        - https://docs.exa.ai/reference/get-contents
      summary: 为一组 URL 提取完整页面内容。
      description: >-
        同步接口。获取一组 URL 的完整页面文本、摘要和元数据。优先返回缓存的即时结果；缓存未命中时 Exa 会退回实时抓取。每次成功请求固定计费
        $0.08。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  type: array
                  items:
                    type: string
                  description: 要获取内容的 URL（或 Exa 结果 id）。
                  example:
                    - https://example.com/article
                text:
                  type: boolean
                  description: 返回完整的页面文本。
                highlights:
                  type: boolean
                  description: 返回高亮的相关片段。
                summary:
                  type: boolean
                  description: 返回该页面由 AI 生成的摘要。
                subpages:
                  type: integer
                  description: 同时抓取的关联子页面数量。
                livecrawl:
                  type: string
                  enum:
                    - always
                    - fallback
                    - never
                  description: 新鲜度策略：始终实时抓取、缓存未命中时退回实时抓取，或从不实时抓取。
              required:
                - ids
      responses:
        '200':
          description: 内容获取成功。
          content:
            application/json:
              schema:
                type: object
                properties:
                  requestId:
                    type: string
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        url:
                          type: string
                        publishedDate:
                          type: string
                        author:
                          type: string
                        id:
                          type: string
                        text:
                          type: string
                        highlights:
                          type: array
                          items:
                            type: string
                        summary:
                          type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````