Agnes 2.5 Pro Alpha（已废弃）

Agnes 2.5 Pro Alpha 的 Agnes AI 托管 API 已废弃，不再建议用于新的 API 接入。官方开源权重仍可在 Hugging Face 获取，并采用 Apache 2.0 许可证。

agnes-2.5-pro-alpha 托管 API 已废弃。本页仅保留历史接口、参数与评测资料；新接入请使用稳定版 agnes-2.5-pro。开源模型权重不受该 API 废弃状态影响。

模型名称

agnes-2.5-pro-alpha

历史 API Endpoints

Chat Completions：POST /v1/chat/completions
Responses：POST /v1/responses
Messages：POST /v1/messages

API 状态

已废弃；推荐迁移至 agnes-2.5-pro。

模型类型

开源推理模型，支持文本和图像输入。

开源模型权重

在 Hugging Face 查看官方模型权重和模型卡。

概述

Agnes 2.5 Pro Alpha 面向需要更强推理深度的任务，包括复杂代码任务、科学与数学推理、长上下文理解、知识密集型问答，以及智能体终端或工作流任务。它与 Agnes 其他文本模型保持一致的基础接入方式：

项目	数值
Base URL	`https://apihub.agnes-ai.com/v1`
Endpoint	`POST /v1/chat/completions`
模型名称	`agnes-2.5-pro-alpha`
输入模态	文本、图像 URL
输出模态	文本
发布日期	2026 年 7 月 24 日
开源权重	Hugging Face
开源许可证	Apache 2.0
托管 API 状态	已废弃

Agnes 2.5 Pro Alpha 官方权重现已采用 Apache 2.0 许可证开源。Artificial Analysis 属于第三方评测来源，其模型元数据可能在榜单更新前仍保留旧状态。

核心能力

高级推理

适合科学推理、知识密集型问题和多步骤分析。

编码与终端任务

适用于代码生成、调试、重构、测试生成和智能体编码工作流。

长上下文分析

支持长文档、结构化上下文和多轮推理任务。

图像理解

支持图像 URL 输入，可用于视觉分析和多模态推理。

工具调用

支持 OpenAI 兼容的函数调用和外部工具编排。

流式输出

支持流式响应，适合交互式产品体验。

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

Artificial Analysis 模型页

查看模型介绍、摘要和价格分析。

Artificial Analysis 榜单

与其他上榜模型对比。

API Reference

Endpoint

POST https://apihub.agnes-ai.com/v1/chat/completions

请求头

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

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

请求示例

基础聊天
编码任务
流式输出
图像理解

curl https://apihub.agnes-ai.com/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
  }'

curl https://apihub.agnes-ai.com/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
  }'

curl https://apihub.agnes-ai.com/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
  }'

curl https://apihub.agnes-ai.com/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"
            }
          }
        ]
      }
    ]
  }'

响应格式

{
  "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 使用信息。

Responses API

除 Chat Completions 外，该模型还支持 OpenAI Responses API。使用 input 代替 messages 传递输入。

Responses Endpoint

POST https://apihub.agnes-ai.com/v1/responses

Responses 请求参数

参数	类型	必填	说明
`model`	string	是	模型名称，使用 `agnes-2.5-pro-alpha`。
`input`	string / array	是	纯文本 Prompt 或结构化输入消息数组。
`max_output_tokens`	integer	否	最大输出预算。推理模型建议设置较大值，避免响应状态变为 `incomplete`。

文本输入
结构化输入

curl https://apihub.agnes-ai.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-2.5-pro-alpha",
    "input": "Explain how autonomous agents use tools.",
    "max_output_tokens": 1024
  }'

curl https://apihub.agnes-ai.com/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-2.5-pro-alpha",
    "input": [
      {
        "role": "user",
        "content": [
          {
            "type": "input_text",
            "text": "Explain how autonomous agents use tools."
          }
        ]
      }
    ],
    "max_output_tokens": 1024
  }'

Responses 输出格式

{
  "id": "resp_xxx",
  "object": "response",
  "status": "completed",
  "model": "agnes-2.5-pro-alpha",
  "output": [
    {
      "type": "reasoning",
      "summary": []
    },
    {
      "type": "message",
      "role": "assistant",
      "status": "completed",
      "content": [
        {
          "type": "output_text",
          "text": "Autonomous agents use tools to retrieve data and perform actions."
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 40,
    "output_tokens": 80,
    "total_tokens": 120
  },
  "error": null,
  "incomplete_details": null
}

字段	类型	说明
`id`	string	响应的唯一 ID。
`object`	string	对象类型，通常为 `response`。
`status`	string	响应状态，例如 `completed` 或 `incomplete`。
`output`	array	有序输出项，包括 reasoning 和 assistant message。
`output[].type`	string	输出项类型，例如 `reasoning` 或 `message`。
`output[].content[].type`	string	内容类型；模型生成文本使用 `output_text`。
`output[].content[].text`	string	模型生成的正文。
`usage`	object	Token 使用信息。
`error`	object / null	请求失败时的错误详情。
`incomplete_details`	object / null	响应提前停止时的原因。

当前响应不包含顶层 output_text 便捷字段。请从 output[].type 为 message、且 output[].content[].type 为 output_text 的内容块中读取生成文本。

Reasoning 输出是可选项，可能位于 content[].reasoning_text，也可能位于 summary[].summary_text。不同模型的 Token 字段命名也可能不同，客户端应同时兼容 input_tokens / output_tokens 与 prompt_tokens / completion_tokens。

如果 status 为 incomplete，请检查 incomplete_details，并使用更大的 max_output_tokens 重试。推理模型可能在输出回答正文前消耗一部分输出预算。

Messages API

该模型还支持 Anthropic 兼容的 Messages API。使用 messages 传递对话输入，并通过 x-api-key 完成认证。

Messages Endpoint

POST https://apihub.agnes-ai.com/v1/messages

Messages 请求头

-H "x-api-key: YOUR_API_KEY"
-H "anthropic-version: 2023-06-01"
-H "Content-Type: application/json"

Messages 请求参数

参数	类型	必填	说明
`model`	string	是	模型名称，使用 `agnes-2.5-pro-alpha`。
`max_tokens`	integer	是	最大输出 Token 数量。推理模型建议设置较大值。
`messages`	array	是	对话消息数组，支持 `user` 和 `assistant` 角色。
`messages[].role`	string	是	消息角色，使用 `user` 或 `assistant`。
`messages[].content`	string / array	是	纯文本或 Anthropic 兼容的内容块数组。
`system`	string / array	否	请求使用的系统指令。
`temperature`	number	否	控制输出随机性。
`stream`	boolean	否	是否返回流式响应。

Messages 请求示例

curl https://apihub.agnes-ai.com/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-2.5-pro-alpha",
    "max_tokens": 1024,
    "system": "You are a helpful AI assistant.",
    "messages": [
      {
        "role": "user",
        "content": "Explain how autonomous agents use tools."
      }
    ]
  }'

Messages 响应格式

{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "model": "agnes-2.5-pro-alpha",
  "content": [
    {
      "type": "text",
      "text": "Autonomous agents use tools to retrieve information and perform actions."
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 290,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "output_tokens": 28
  }
}

字段	类型	说明
`id`	string	消息的唯一 ID。
`type`	string	对象类型，通常为 `message`。
`role`	string	响应角色，通常为 `assistant`。
`model`	string	请求使用的模型。
`content`	array	有序响应内容块。
`content[].type`	string	内容块类型；生成文本使用 `text`。
`content[].text`	string	模型生成的正文。
`stop_reason`	string	生成停止原因，例如 `end_turn` 或 `max_tokens`。
`usage.input_tokens`	integer	输入 Token 数量。
`usage.output_tokens`	integer	输出 Token 数量。
`usage.cache_creation_input_tokens`	integer	写入 Prompt 缓存的输入 Token 数量。
`usage.cache_read_input_tokens`	integer	从 Prompt 缓存读取的输入 Token 数量。

请从 content[].type 为 text 的内容块读取生成正文。如果 stop_reason 为 max_tokens，请提高 max_tokens 后重试。

限制与价格

Agnes 2.5 Pro Alpha 托管 API 已废弃。以下价格仅作为历史计费记录保留。

项目	数值
上下文窗口	`1M` tokens
最大输出长度	`65536` tokens
输入模态	文本、图像
输出模态	文本
Reasoning	是
模型权重	已开源：Hugging Face
开源许可证	Apache 2.0

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

输入缓存命中单价为普通输入 Token 单价的 10%。价格和可用性可能受账户、地区、计费配置或后续价格更新影响。请以 Agnes AI 平台控制台中展示的账户价格为准。

最佳实践

高推理任务

当任务更关注正确性和多步骤推理，而不是极低延迟时，请使用稳定版 Agnes 2.5 Pro，例如科学推理、复杂策略分析和长篇技术规划。

编码任务

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

长上下文任务

在 Prompt 中使用结构化章节、文件名或文档标签，帮助模型引用来源并生成可追踪的结论。

接入检查清单

不再使用已废弃的 agnes-2.5-pro-alpha 托管 API，并迁移至 agnes-2.5-pro。

如需自行部署，可继续从 Hugging Face 获取 Agnes 2.5 Pro Alpha 开源权重。

基础聊天补全请求必须包含 model 和 messages。

图像输入需要使用公开可访问的 image_url。

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

Get Started

Use Guides

Agnes 2.5 Pro Alpha（已废弃）

模型名称

历史 API Endpoints

API 状态

模型类型

开源模型权重

概述

核心能力

高级推理

编码与终端任务

长上下文分析

图像理解

工具调用

流式输出

Artificial Analysis 结果

Artificial Analysis 模型页

Artificial Analysis 榜单

API Reference

Endpoint

请求头

请求参数

图像 URL 输入

请求示例

响应格式

响应字段

Responses API

Responses Endpoint

Responses 请求参数

Responses 输出格式

Messages API

Messages Endpoint

Messages 请求头

Messages 请求参数

Messages 请求示例

Messages 响应格式

限制与价格

最佳实践

接入检查清单

模型名称

历史 API Endpoints

API 状态

模型类型

开源模型权重

​概述

​核心能力

高级推理

编码与终端任务

长上下文分析

图像理解

工具调用

流式输出

​Artificial Analysis 结果

Artificial Analysis 模型页

Artificial Analysis 榜单

​API Reference

​Endpoint

​请求头

​请求参数

​图像 URL 输入

​请求示例

​响应格式

​响应字段

​Responses API

​Responses Endpoint

​Responses 请求参数

​Responses 输出格式

​Messages API

​Messages Endpoint

​Messages 请求头

​Messages 请求参数

​Messages 请求示例

​Messages 响应格式

​限制与价格

​最佳实践

​接入检查清单

概述

核心能力

Artificial Analysis 结果

API Reference

Endpoint

请求头

请求参数

图像 URL 输入

请求示例

响应格式

响应字段

Responses API

Responses Endpoint

Responses 请求参数

Responses 输出格式

Messages API

Messages Endpoint

Messages 请求头

Messages 请求参数

Messages 请求示例

Messages 响应格式

限制与价格

最佳实践

接入检查清单