Model Providers

In OpenAgent, Model Providers represent the compute backbone of your agents. The platform abstracts the complexities of individual LLM APIs, providing a unified interface to manage intelligence, failover, and cost across your organization.

Supported Providers

OpenAgent is designed for maximum flexibility, supporting a wide range of cloud-based and local intelligence engines. All providers are normalized into a unified interface for system prompts and tool calling.

---

Quick Setup

New deployments can configure their first model provider from the Quick Setup onboarding page instead of the full provider form. It presents the common providers as one-click cards; picking one pre-fills sensible defaults (a default model / Sub Type) so you only need to supply the credential.

Quick Setup covers most supported providers, including OpenAI, Claude, Gemini, DeepSeek, Grok, Mistral, MiniMax, OpenRouter, Alibaba Cloud, Moonshot, Silicon Flow, Volcano Engine, Baidu Cloud, Tencent Cloud, iFlytek, ChatGLM, Baichuan, StepFun, Yi, Cohere, Writer, Hugging Face, GitHub Models, Amazon Bedrock, Azure, Ollama, Local, OpenCode, and OpenAI Compatible.

Each card indicates what it needs — most only require an API Key, while local or self-hosted options (Ollama, Local, OpenAI Compatible, OpenCode) ask for a Provider URL instead, and enterprise types (Azure, Amazon Bedrock, Tencent Cloud) request their extra endpoint or region fields. For anything not listed, or to fine-tune advanced settings, use the full provider form described below.

---

Configuration

OpenAgent provides a unified form to connect these services. While most providers only require an API Key, some enterprise and local types have additional field mappings.

Provider-Specific Settings

---

Key Platform Features

OpenAgent provides several infrastructure-level capabilities that go beyond simple API wrapping.

1. Automated Failover (Child Models)

To ensure high availability, OpenAgent allows you to configure Child Model Providers at the Store level.

• If the primary provider returns a rate limit or a 5xx error, OpenAgent automatically routes the request to the next available child provider in your list.
• Example: Use DeepSeek V4 for cost-efficiency, with GPT-4.1 as a high-reliability fallback.

2. Context Logic Abstraction

OpenAgent handles the "dirty work" of different model families:

• Thinking Mode: Native support for reasoning models (o1, DeepSeek-R1, DeepSeek V4 Flash).
• Prompt Unification: Automatically formats system, user, and tool-call roles based on the provider's specific requirements.

Volcano Engine providers can stream reasoning content when Enable Thinking is turned on for the Provider. This reasoning is stored with the message detail and follows the Store's Hide Thinking display setting.

Alibaba Cloud Qwen-VL and QVQ models are treated as multimodal models, so image inputs and text tool outputs can be combined in vision-capable conversations.

Volcano Engine doubao-seedance models are treated as video generation models. OpenAgent creates a generation task, polls for completion, records token usage and cost, and returns the generated video URL when the task succeeds.

When a prompt or conversation history contains a supported document URL, OpenAgent can parse and cache the document text before calling the model. For OpenAI and Azure models this replacement is limited to local or private URLs; other providers can receive parsed content for supported document URLs.

3. Cost & Usage Tracking

By filling in the pricing fields in the Provider configuration, OpenAgent tracks expenditures at the organization level:

• Input/Output Price: Tracks cost per 1k tokens.
• Message Auditing: Every message stores the actual provider used and the calculated cost in the database for billing or reporting.

Unknown OpenAI-compatible model names no longer block message completion because of missing built-in pricing; OpenAgent records 0 cost unless custom input/output pricing is configured on the Provider.

4. OpenAI-Compatible API Access

Each Model Provider edit page shows an OpenAI-compatible API panel with copyable Base URL and Chat completions endpoint values. External clients can call these endpoints with Authorization: Bearer <provider key> to reach that provider directly, without creating Store chat history. See API Access for the full request semantics and the Store-key alternative.

---

Sampling Parameters

While OpenAgent exposes standard parameters (Temperature, Top-P, Min-P), the platform is designed to use Provider Defaults to ensure stable reasoning. Adjust these only if your specific agentic workflow requires high determinism or extreme creativity.