> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.agnes-ai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Agnes 2.5 Pro Alpha

> 面向高级编码、科学推理、长上下文分析、智能体工作流和多模态理解的付费推理模型。

<Info>
  Agnes 2.5 Pro Alpha 是 Sapiens AI 推出的付费推理模型，适用于高级编码、科学推理、长上下文分析、智能体工作流和多模态理解。该模型通过 OpenAI 兼容的 Chat Completions API 接入。
</Info>

<CardGroup cols={2}>
  <Card title="模型名称" icon="cube">
    `agnes-2.5-pro-alpha`
  </Card>

  <Card title="API Endpoint" icon="link">
    `POST /v1/chat/completions`
  </Card>

  <Card title="模型类型" icon="brain">
    付费推理模型，支持文本和图像输入。
  </Card>

  <Card title="榜单参考" icon="chart-line">
    已上榜 Artificial Analysis。
  </Card>
</CardGroup>

## 概述

Agnes 2.5 Pro Alpha 面向需要更强推理深度的任务，包括复杂代码任务、科学与数学推理、长上下文理解、知识密集型问答，以及智能体终端或工作流任务。

它与 Agnes 其他文本模型保持一致的基础接入方式：

| 项目       | 数值                           |
| -------- | ---------------------------- |
| Base URL | `https://api.agnes-ai.cn/v1` |
| Endpoint | `POST /v1/chat/completions`  |
| 模型名称     | `agnes-2.5-pro-alpha`        |
| 输入模态     | 文本、图像 URL                    |
| 输出模态     | 文本                           |
| 发布日期     | 2026 年 7 月 24 日              |
| 计费方式     | 付费模型                         |

<Note>
  Artificial Analysis 将 Agnes 2.5 Pro Alpha 标记为 Sapiens AI 的 proprietary reasoning model，并显示发布时间为 2026 年 7 月 24 日。外部评测数据属于第三方参考，可能随 Artificial Analysis 的方法或榜单更新而变化。
</Note>

## 核心能力

<CardGroup cols={2}>
  <Card title="高级推理" icon="brain">
    适合科学推理、知识密集型问题和多步骤分析。
  </Card>

  <Card title="编码与终端任务" icon="terminal">
    适用于代码生成、调试、重构、测试生成和智能体编码工作流。
  </Card>

  <Card title="长上下文分析" icon="file-lines">
    支持长文档、结构化上下文和多轮推理任务。
  </Card>

  <Card title="图像理解" icon="eye">
    支持图像 URL 输入，可用于视觉分析和多模态推理。
  </Card>

  <Card title="工具调用" icon="wrench">
    支持 OpenAI 兼容的函数调用和外部工具编排。
  </Card>

  <Card title="流式输出" icon="bolt">
    支持流式响应，适合交互式产品体验。
  </Card>
</CardGroup>

## Artificial Analysis 结果

以下指标基于 Agnes 2.5 Pro Alpha 的 Artificial Analysis 数据。

| 摘要项                  | 数值          |
| -------------------- | ----------- |
| Intelligence 摘要排名    | `#9 / 153`  |
| Price 摘要排名           | `#46 / 153` |
| Cache hit price 摘要排名 | `#8 / 153`  |

| 指标                 |         得分 |
| ------------------ | ---------: |
| Intelligence Index |       `39` |
| GPQA               |    `87.6%` |
| SciCode            |    `42.2%` |
| LCR                |    `63.7%` |
| Omniscience        |    `-26.3` |
| Accuracy           |    `32.3%` |
| Non-hallucination  |    `13.3%` |
| CritPt             |    `10.9%` |
| HLE                |    `31.9%` |
| TerminalBench v2.1 |    `67.0%` |
| GDPval v2          | `1170 elo` |
| Tau3               |    `11.6%` |

<CardGroup cols={2}>
  <Card title="Artificial Analysis 模型页" icon="arrow-up-right" href="https://artificialanalysis.ai/models/agnes-2-5-pro-alpha">
    查看模型介绍、摘要和价格分析。
  </Card>

  <Card title="Artificial Analysis 榜单" icon="chart-line" href="https://artificialanalysis.ai/models?models=mimo-v2-5-pro%2Cgemini-3-5-flash-lite%2Cinkling%2Cclaude-sonnet-5%2Cminimax-m3%2Ccommand-a-plus%2Cgpt-5-6-luna%2Ck2-think-v2%2Cnvidia-nemotron-3-ultra-550b-a55b%2Cqwen3-7-max%2Cgemini-3-6-flash%2Cgrok-4-5%2Cclaude-opus-4-8%2Cclaude-4-5-haiku-reasoning%2Cgemini-3-1-pro-preview%2Cgpt-5-6-terra%2Cdeepseek-v4-pro%2Cgemma-4-31b%2Cclaude-fable-5%2Cmuse-spark-1-1%2Cdeepseek-v4-flash%2Cgpt-5-6-sol%2Cmistral-medium-3-5%2Cgpt-5-5-pro%2Cgpt-oss-120b%2Cglm-5-2%2Ckimi-k3%2Cagnes-2-5-pro-alpha">
    与其他上榜模型对比。
  </Card>
</CardGroup>

## API Reference

### Endpoint

```text theme={null}
POST https://api.agnes-ai.cn/v1/chat/completions
```

### 请求头

```bash theme={null}
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
```

### 请求参数

| 参数                     | 类型              | 必填 | 说明                                          |
| ---------------------- | --------------- | -- | ------------------------------------------- |
| `model`                | string          | 是  | 模型名称，使用 `agnes-2.5-pro-alpha`。              |
| `messages`             | array           | 是  | 对话消息数组，包含 `system`、`user` 和 `assistant` 消息。 |
| `messages[].content`   | string / array  | 是  | 可为纯文本，也可为包含 `text` 和 `image_url` 的内容块数组。    |
| `temperature`          | number          | 否  | 控制输出随机性。值越低，输出越确定。                          |
| `top_p`                | number          | 否  | 控制核采样。                                      |
| `max_tokens`           | number          | 否  | 响应中生成的最大 token 数量。                          |
| `stream`               | boolean         | 否  | 是否启用流式输出。                                   |
| `tools`                | array           | 否  | 工具调用工作流的工具定义。                               |
| `tool_choice`          | string / object | 否  | 控制模型是否使用工具以及如何使用工具。                         |
| `chat_template_kwargs` | object          | 否  | OpenAI 兼容请求扩展字段。                            |
| `thinking`             | object          | 否  | Anthropic 兼容请求中启用 Thinking 模式。              |

## 图像 URL 输入

Agnes 2.5 Pro Alpha 支持在同一个 `messages` 请求中传入文本和图像 URL。

```json theme={null}
{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "Analyze this architecture diagram and identify possible failure points."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/diagram.png"
      }
    }
  ]
}
```

## 请求示例

<Tabs>
  <Tab title="基础聊天">
    ```bash theme={null}
    curl https://api.agnes-ai.cn/v1/chat/completions \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "agnes-2.5-pro-alpha",
        "messages": [
          {
            "role": "system",
            "content": "You are a precise technical assistant."
          },
          {
            "role": "user",
            "content": "Explain the tradeoffs between optimistic locking and pessimistic locking in distributed systems."
          }
        ],
        "temperature": 0.3,
        "max_tokens": 1200
      }'
    ```
  </Tab>

  <Tab title="编码任务">
    ```bash theme={null}
    curl https://api.agnes-ai.cn/v1/chat/completions \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "agnes-2.5-pro-alpha",
        "messages": [
          {
            "role": "user",
            "content": "Review this TypeScript API handler for security issues, explain the risks, and provide a corrected version."
          }
        ],
        "temperature": 0.2,
        "max_tokens": 2000
      }'
    ```
  </Tab>

  <Tab title="流式输出">
    ```bash theme={null}
    curl https://api.agnes-ai.cn/v1/chat/completions \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "agnes-2.5-pro-alpha",
        "messages": [
          {
            "role": "user",
            "content": "Create a step-by-step migration plan for moving a monolith to services."
          }
        ],
        "stream": true
      }'
    ```
  </Tab>

  <Tab title="图像理解">
    ```bash theme={null}
    curl https://api.agnes-ai.cn/v1/chat/completions \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "agnes-2.5-pro-alpha",
        "messages": [
          {
            "role": "user",
            "content": [
              {
                "type": "text",
                "text": "Summarize this chart and call out any anomalies."
              },
              {
                "type": "image_url",
                "image_url": {
                  "url": "https://example.com/chart.png"
                }
              }
            ]
          }
        ]
      }'
    ```
  </Tab>
</Tabs>

## 响应格式

```json theme={null}
{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 1784899200,
  "model": "agnes-2.5-pro-alpha",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 120,
    "completion_tokens": 300,
    "total_tokens": 420
  }
}
```

### 响应字段

| 字段                          | 类型      | 说明                          |
| --------------------------- | ------- | --------------------------- |
| `id`                        | string  | 补全请求的唯一 ID。                 |
| `object`                    | string  | 对象类型，通常为 `chat.completion`。 |
| `created`                   | integer | 请求时间戳。                      |
| `model`                     | string  | 请求使用的模型。                    |
| `choices`                   | array   | 生成结果列表。                     |
| `choices[].message.role`    | string  | 消息发送者角色。                    |
| `choices[].message.content` | string  | 模型生成内容。                     |
| `choices[].finish_reason`   | string  | 生成停止原因。                     |
| `usage`                     | object  | Token 使用信息。                 |

## 限制与价格

Agnes 2.5 Pro Alpha 是付费模型，按输入缓存命中、输入缓存未命中和输出 Token 计费。

| 项目        | 数值              |
| --------- | --------------- |
| 上下文窗口     | `1M` tokens     |
| 最大输出长度    | `65536` tokens  |
| 输入模态      | 文本、图像           |
| 输出模态      | 文本              |
| Reasoning | 是               |
| 模型权重      | Proprietary，非开源 |

| 类型                  |                 美元价格 |
| ------------------- | -------------------: |
| 输入缓存命中 / Cache Read | `$0.0038 / M tokens` |
| 输入缓存未命中 / Input     |   `$0.45 / M tokens` |
| 输出 / Output         |   `$0.90 / M tokens` |

<Note>
  价格和可用性可能受账户、地区、计费配置或后续价格更新影响。请以 Agnes AI 平台控制台中展示的账户价格为准。
</Note>

## 最佳实践

<AccordionGroup>
  <Accordion title="高推理任务">
    当任务更关注正确性和多步骤推理，而不是极低延迟时，建议使用 Agnes 2.5 Pro Alpha，例如科学推理、复杂策略分析和长篇技术规划。
  </Accordion>

  <Accordion title="编码任务">
    提供目标语言、框架、已有代码、错误信息、期望行为和约束条件。复杂问题建议先要求模型分析根因，再给出修复补丁。
  </Accordion>

  <Accordion title="长上下文任务">
    在 Prompt 中使用结构化章节、文件名或文档标签，帮助模型引用来源并生成可追踪的结论。
  </Accordion>
</AccordionGroup>

## 接入检查清单

<Check>
  使用 `agnes-2.5-pro-alpha` 作为模型名称。
</Check>

<Check>
  确认你的账户已开通 Agnes 2.5 Pro Alpha 付费模型访问权限。
</Check>

<Check>
  基础聊天补全请求必须包含 `model` 和 `messages`。
</Check>

<Check>
  图像输入需要使用公开可访问的 `image_url`。
</Check>

<Check>
  该模型为付费模型，请跟踪输入缓存命中、输入缓存未命中和输出 Token 使用量。
</Check>