> ## 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

> A paid reasoning model for advanced coding, scientific reasoning, long-context analysis, agentic workflows, and multimodal understanding.

<Info>
  Agnes 2.5 Pro Alpha is a paid reasoning model from Sapiens AI. It is designed for advanced coding, scientific reasoning, long-context analysis, agentic workflows, and multimodal understanding. The model is available through the OpenAI-compatible Chat Completions API.
</Info>

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

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

  <Card title="Model Type" icon="brain">
    Paid reasoning model with text and image input.
  </Card>

  <Card title="Benchmark Reference" icon="chart-line">
    Listed on Artificial Analysis.
  </Card>
</CardGroup>

## Overview

Agnes 2.5 Pro Alpha is intended for workloads that need stronger reasoning depth than flash-class models, including complex code tasks, science and math reasoning, long-context understanding, knowledge-intensive Q\&A, and agentic terminal or workflow tasks.

It uses the same base integration pattern as other Agnes text models:

| Item             | Value                        |
| ---------------- | ---------------------------- |
| Base URL         | `https://api.agnes-ai.cn/v1` |
| Endpoint         | `POST /v1/chat/completions`  |
| Model name       | `agnes-2.5-pro-alpha`        |
| Input modalities | Text and image URL           |
| Output modality  | Text                         |
| Release date     | July 24, 2026                |
| Billing          | Paid model                   |

<Note>
  Artificial Analysis lists Agnes 2.5 Pro Alpha as a proprietary reasoning model released on July 24, 2026. External benchmark scores are third-party references and may change as Artificial Analysis updates its methodology or leaderboard data.
</Note>

## Core Capabilities

<CardGroup cols={2}>
  <Card title="Advanced Reasoning" icon="brain">
    Suitable for scientific reasoning, knowledge-intensive questions, and multi-step analysis.
  </Card>

  <Card title="Coding and Terminal Tasks" icon="terminal">
    Designed for code generation, debugging, refactoring, test generation, and agentic coding workflows.
  </Card>

  <Card title="Long-context Analysis" icon="file-lines">
    Handles long documents, structured context, and multi-turn reasoning tasks.
  </Card>

  <Card title="Image Understanding" icon="eye">
    Accepts image URL inputs for visual analysis and multimodal reasoning.
  </Card>

  <Card title="Tool Calling" icon="wrench">
    Supports OpenAI-compatible function calling and external tool orchestration.
  </Card>

  <Card title="Streaming" icon="bolt">
    Supports streaming responses for interactive product experiences.
  </Card>
</CardGroup>

## Artificial Analysis Results

The following metrics are based on the Artificial Analysis data provided for Agnes 2.5 Pro Alpha.

| Summary Item                 | Value       |
| ---------------------------- | ----------- |
| Intelligence summary rank    | `#9 / 153`  |
| Price summary rank           | `#46 / 153` |
| Cache hit price summary rank | `#8 / 153`  |

| Metric             |      Score |
| ------------------ | ---------: |
| 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 Model Page" icon="arrow-up-right" href="https://artificialanalysis.ai/models/agnes-2-5-pro-alpha">
    View the model profile, summary, and pricing analysis.
  </Card>

  <Card title="Artificial Analysis Leaderboard" 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">
    Compare Agnes 2.5 Pro Alpha with other listed models.
  </Card>
</CardGroup>

## API Reference

### Endpoint

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

### Headers

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

### Request Parameters

| Parameter              | Type            | Required | Description                                                                                            |
| ---------------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------ |
| `model`                | string          | Yes      | Model name. Use `agnes-2.5-pro-alpha`.                                                                 |
| `messages`             | array           | Yes      | Conversation messages, including `system`, `user`, and `assistant` messages.                           |
| `messages[].content`   | string / array  | Yes      | Message content. It can be plain text or an array of content blocks containing `text` and `image_url`. |
| `temperature`          | number          | No       | Controls randomness. Lower values produce more deterministic output.                                   |
| `top_p`                | number          | No       | Controls nucleus sampling.                                                                             |
| `max_tokens`           | number          | No       | Maximum number of tokens to generate in the response.                                                  |
| `stream`               | boolean         | No       | Whether to enable streaming output.                                                                    |
| `tools`                | array           | No       | Tool definitions for tool-calling workflows.                                                           |
| `tool_choice`          | string / object | No       | Controls whether and how the model uses tools.                                                         |
| `chat_template_kwargs` | object          | No       | Extension field for OpenAI-compatible requests.                                                        |
| `thinking`             | object          | No       | Field for enabling Thinking mode in Anthropic-compatible requests.                                     |

## Image URL Input

Agnes 2.5 Pro Alpha supports text and image URL inputs in the same `messages` request.

```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"
      }
    }
  ]
}
```

## Request Examples

<Tabs>
  <Tab title="Basic Chat">
    ```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="Coding">
    ```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="Streaming">
    ```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="Image Understanding">
    ```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>

## Response Format

```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
  }
}
```

### Response Fields

| Field                       | Type    | Description                             |
| --------------------------- | ------- | --------------------------------------- |
| `id`                        | string  | Unique ID of the completion request.    |
| `object`                    | string  | Object type, usually `chat.completion`. |
| `created`                   | integer | Request timestamp.                      |
| `model`                     | string  | Model used for the request.             |
| `choices`                   | array   | List of generated responses.            |
| `choices[].message.role`    | string  | Role of the message sender.             |
| `choices[].message.content` | string  | Content generated by the model.         |
| `choices[].finish_reason`   | string  | Reason generation stopped.              |
| `usage`                     | object  | Token usage information.                |

## Limits and Pricing

Agnes 2.5 Pro Alpha is a paid model. Usage is billed by cache read, input, and output tokens.

| Item              | Value                        |
| ----------------- | ---------------------------- |
| Context window    | `1M` tokens                  |
| Max output        | `65536` tokens               |
| Input modalities  | Text, image                  |
| Output modalities | Text                         |
| Reasoning         | Yes                          |
| Model weights     | Proprietary, not open source |

| Type                         |            USD Price |
| ---------------------------- | -------------------: |
| Input cache hit / Cache Read | `$0.0038 / M tokens` |
| Input cache miss / Input     |   `$0.45 / M tokens` |
| Output                       |   `$0.90 / M tokens` |

<Note>
  Pricing and availability may vary by account, region, billing configuration, or later pricing updates. Use the Agnes AI platform dashboard as the source of truth for your account.
</Note>

## Best Practices

<AccordionGroup>
  <Accordion title="Reasoning-heavy Tasks">
    Use Agnes 2.5 Pro Alpha for tasks where correctness and multi-step reasoning matter more than raw latency, such as scientific reasoning, complex policy analysis, and long-form technical planning.
  </Accordion>

  <Accordion title="Coding Tasks">
    Provide the target language, framework, existing code, error messages, expected behavior, and constraints. Ask for root-cause analysis before the patch when debugging complex issues.
  </Accordion>

  <Accordion title="Long-context Tasks">
    Use structured sections, filenames, or document labels inside the prompt so the model can refer to sources and produce traceable conclusions.
  </Accordion>
</AccordionGroup>

## Integration Checklist

<Check>
  Use `agnes-2.5-pro-alpha` as the model name.
</Check>

<Check>
  Confirm that your account has access to the paid Agnes 2.5 Pro Alpha model.
</Check>

<Check>
  Basic chat completion requests must include `model` and `messages`.
</Check>

<Check>
  Use publicly accessible `image_url` values for image inputs.
</Check>

<Check>
  Track cache read, input, and output token usage because this is a paid model.
</Check>