Agnes 2.5 Flash

Agnes 2.5 Flash is a generally available language model upgraded from Agnes 2.0 Flash. It keeps the same OpenAI-compatible Chat Completions integration path while improving the experience for coding, agent workflows, tool calling, multi-turn conversations, reasoning, and image understanding.

Model

agnes-2.5-flash

API Endpoint

POST /v1/chat/completions

Release Status

Generally available to users with Agnes API access.

Upgrade Path

API-compatible upgrade from agnes-2.0-flash.

Overview

Agnes 2.5 Flash is designed as the next-step upgrade for developers already using Agnes 2.0 Flash. In most integrations, you only need to replace the model value with agnes-2.5-flash; the Base URL, endpoint, headers, message format, streaming format, tool-calling format, and image URL input format remain the same. The model focuses on a smoother developer experience, stronger instruction following, more stable multi-turn output, and improved code-specific capability for generation, debugging, refactoring, explanation, and agentic coding workflows.

Use agnes-2.5-flash directly as the model name. If you need to keep compatibility with an existing integration, agnes-2.0-flash remains available as the previous generation model.

Core Capabilities

Chat Completions

Generate high-quality responses for conversations, applications, and business systems.

Multi-turn Conversations

Maintain context consistency across continuous interactions.

Image URL Input

Accept visual content through publicly accessible image URLs.

Image Understanding

Analyze screenshots, describe images, answer visual questions, and extract visual information.

Tool Calling

Support function calling and external tool orchestration.

Agent Workflows

Improved planning, execution, context tracking, and multi-step task completion.

Code-specialized Tasks

Optimized for code generation, debugging, refactoring, explanation, and patch-style development workflows.

Streaming

Return responses in real time for a better interactive experience.

Use Cases

AI Assistants

General Q&A, productivity assistants, personal assistants, and in-app copilots.

Autonomous Agents

Multi-step task execution, planning, tool use, and workflow scheduling.

Coding Assistants

Code generation, bug fixing, refactoring suggestions, code review, test generation, and code explanation.

Customer Support

FAQ automation, support chatbots, and service workflow automation.

Search and Q&A

Retrieval-based answers, summarization, and information extraction.

Image Understanding

Screenshot analysis, image description, visual Q&A, and structured extraction.

Upgrade from Agnes 2.0 Flash

If you already call agnes-2.0-flash, the 2.5 Flash migration is intentionally small.

Item	Agnes 2.0 Flash	Agnes 2.5 Flash
Endpoint	`POST /v1/chat/completions`	`POST /v1/chat/completions`
Base URL	`https://apihub.agnes-ai.com/v1`	`https://apihub.agnes-ai.com/v1`
Model name	`agnes-2.0-flash`	`agnes-2.5-flash`
Message format	OpenAI-compatible `messages`	Same
Streaming	`stream: true`	Same
Tool calling	`tools` and `tool_choice`	Same
Image URL input	`messages[].content[].image_url`	Same

For existing integrations, the migration can be handled as a model-name change. Keep agnes-2.0-flash only if you need a compatibility fallback for legacy workflows.

API Reference

Endpoint

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

Headers

-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-flash`.
`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 results.
`top_p`	number	No	Controls nucleus sampling. Lower values make output more focused.
`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 enabling Thinking and other features in OpenAI-compatible requests.
`thinking`	object	No	Field for enabling Thinking mode in Anthropic-compatible requests.

Image URL Input

Agnes 2.5 Flash supports passing text and image URLs in the same messages request.

Input Type	Format	Description
Text	`text`	Plain text instruction or question.
Image URL	`image_url`	Pass image content through a publicly accessible image URL.

{
  "role": "user",
  "content": [
    {
      "type": "text",
      "text": "Describe the content of this image."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/image.jpg"
      }
    }
  ]
}

Request Examples

Basic Chat
Streaming
Tool Calling
Image Understanding

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-flash",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful AI assistant."
      },
      {
        "role": "user",
        "content": "Explain how autonomous agents use tools to complete tasks."
      }
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

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-flash",
    "messages": [
      {
        "role": "user",
        "content": "Write a short product introduction for an AI assistant app."
      }
    ],
    "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-flash",
    "messages": [
      {
        "role": "user",
        "content": "What is the weather like in Singapore today?"
      }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "get_weather",
          "description": "Get the current weather for a location",
          "parameters": {
            "type": "object",
            "properties": {
              "location": {
                "type": "string",
                "description": "The city and country"
              }
            },
            "required": ["location"]
          }
        }
      }
    ]
  }'

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-flash",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Describe the content of this image."
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://example.com/image.jpg"
            }
          }
        ]
      }
    ]
  }'

Response Format

{
  "id": "chatcmpl_xxx",
  "object": "chat.completion",
  "created": 1774432125,
  "model": "agnes-2.5-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Autonomous agents use tools by understanding the user's goal, breaking it into steps, selecting the right tools, executing actions, and using the results to complete the task."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 35,
    "completion_tokens": 58,
    "total_tokens": 93
  }
}

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.

Thinking Mode

For coding, debugging, reasoning, and agent workflows, you can enable Thinking mode to improve task decomposition and problem-solving quality.

OpenAI-compatible Format
Anthropic-compatible Format

{
  "model": "agnes-2.5-flash",
  "messages": [
    {
      "role": "user",
      "content": "Help me write a Python script to process a CSV file."
    }
  ],
  "chat_template_kwargs": {
    "enable_thinking": true
  }
}

{
  "model": "agnes-2.5-flash",
  "messages": [
    {
      "role": "user",
      "content": "Help me refactor this TypeScript function and explain the changes."
    }
  ],
  "thinking": {
    "type": "enabled",
    "budget_tokens": 2048
  }
}

For regular coding tasks, start with budget_tokens: 2048. For complex debugging, refactoring, or multi-step agent workflows, increase the budget as needed.

Best Practices

Prompt Structure

[Role] + [Task] + [Context] + [Requirements] + [Output Format]

Product Copywriting

You are a product marketing expert. Write a concise App Store description for an AI assistant app. The tone should be clear, professional, and user-friendly.

Coding Tasks

Help me debug this React component. The issue is that the button state does not update after clicking. Explain the cause and provide the corrected code.

Agent Workflows

You are an autonomous research agent. Search for relevant information, summarize the key findings, and return the result in a structured format with source links.

Image Understanding Tasks

Analyze this screenshot. Identify the main UI elements, explain the possible issue, and provide suggestions to improve the user experience.

Limits and Pricing

Agnes 2.5 Flash is generally available. Availability, rate limits, and billing behavior follow the entitlement shown for your Agnes AI account and API key.

Item	Value
Context window	`512K`
Maximum output	`65.5K`

Type	Standard Price	Current Price
Input tokens	`$0.03 / 1M tokens`	`$0 / 1M tokens`
Output tokens	`$0.15 / 1M tokens`	`$0 / 1M tokens`

Integration Checklist

Use agnes-2.5-flash as the model name.

Basic chat completion requests must include model and messages.

Image inputs must use publicly accessible image_url values.

Set stream to true when you need streaming responses.

Get Started

Use Guides

Model

API Endpoint

Release Status

Upgrade Path

Overview

Core Capabilities

Chat Completions

Multi-turn Conversations

Image URL Input

Image Understanding

Tool Calling

Agent Workflows

Code-specialized Tasks

Streaming

Use Cases

AI Assistants

Autonomous Agents

Coding Assistants

Customer Support

Search and Q&A

Image Understanding

Upgrade from Agnes 2.0 Flash

API Reference

Endpoint

Headers

Request Parameters

Image URL Input

Request Examples

Response Format

Response Fields

Thinking Mode

Best Practices

Limits and Pricing

Integration Checklist

Model

API Endpoint

Release Status

Upgrade Path

​Overview

​Core Capabilities

Chat Completions

Multi-turn Conversations

Image URL Input

Image Understanding

Tool Calling

Agent Workflows

Code-specialized Tasks

Streaming

​Use Cases

AI Assistants

Autonomous Agents

Coding Assistants

Customer Support

Search and Q&A

Image Understanding

​Upgrade from Agnes 2.0 Flash

​API Reference

​Endpoint

​Headers

​Request Parameters

​Image URL Input

​Request Examples

​Response Format

​Response Fields

​Thinking Mode

​Best Practices

​Limits and Pricing

​Integration Checklist

Overview

Core Capabilities

Use Cases

Upgrade from Agnes 2.0 Flash

API Reference

Endpoint

Headers

Request Parameters

Image URL Input

Request Examples

Response Format

Response Fields

Thinking Mode

Best Practices

Limits and Pricing

Integration Checklist