Skip to content
decodecodeveloper docs
Studio → Connections and agents → Agents & automation

AI Providers

Connect the AI models that power Decopilot and your agents

What are AI providers?

AI Providers are the AI model services that power Decopilot and your agents. You connect a provider once at the organization level, and all your agents use it from there.

Studio supports multiple providers at the same time — you can mix and match.

Default models: one choice per purpose

You don't pick a model every time you start a task. Instead, Studio uses five default models, one for each kind of work:

DefaultWhat it's forTypical pick
FastQuick replies, short interactionsClaude Haiku, GPT-4 mini, Gemini Flash
SmartBalanced speed and capability — the everyday defaultClaude Sonnet, GPT-4o, Gemini Pro
ThinkingHardest reasoning, long planningClaude Opus, o-series, Gemini Ultra
ImageImage generationGPT Image, Imagen, etc.
Web researchWeb search and deep researchSonar, Perplexity, etc.

Configure these once under Settings → AI Providers → Default models. When an agent or Decopilot picks a tier, it routes to the model you set. Change a default and every agent picks up the new model immediately — no per-agent reconfiguration.

You can still override on a per-agent basis when needed, but the defaults cover the common case.

Deco AI Gateway

The Deco AI Gateway is the recommended provider. New organizations get credits to start with — no API keys to juggle — and it gives you access to 100+ models from many vendors behind a single connection. Pay as you go.

If you want to use your own keys later, add another provider; Studio will use whichever provider you set for each default model tier.

You can check your remaining gateway credit and top up directly from Settings → AI Providers.

Other providers

Click Connect provider under Settings → AI Providers to add any of:

ProviderNotes
OpenRouterOne account, hundreds of models from many vendors
LLMAPIOne API key, 400+ models across every provider
AnthropicDirect Anthropic key — Claude family
Google GeminiDirect Google AI Studio key — Gemini family
OpenAI-compatibleAny endpoint that speaks the OpenAI Chat Completions API

OpenAI-compatible presets

The OpenAI-compatible provider has branded presets for common deployments — pick one and Studio pre-fills the base URL. You can also choose Custom and paste any URL.

PresetWhat it's for
OpenAIDirect OpenAI API key — GPT-4, GPT-5, etc.
LiteLLMA LiteLLM gateway your team manages
OllamaOpen-source models running locally via Ollama
LM StudioOpen models running through LM Studio
vLLMYour team's self-hosted vLLM server
CustomAny other OpenAI-compatible endpoint (advanced)

Local-only providers

When Studio runs locally (via bunx decocms), two extra providers light up that delegate to a CLI installed on your machine:

ProviderNotes
Claude CodeDrives a claude CLI session — uses your existing Anthropic auth
CodexDrives a codex CLI session

These don't appear in the cloud product.

How a provider gets connected

API key — the most common method. Paste the key from your provider's dashboard. It's stored encrypted and never exposed to your team.

Sign in with browser — for providers that support it (Deco AI Gateway, OpenRouter). You'll be taken to the provider's login page, authorize access, and Studio handles the rest.

Local endpoint — for the Ollama, LM Studio, vLLM, LiteLLM, or Custom presets of OpenAI-compatible: paste the base URL where Studio can reach the server.

CLI activate — for Claude Code and Codex in local mode: Studio runs the CLI installed on your machine; no key is stored on Studio's side.

What models are available?

Once a provider is connected, you can browse its available models. Each model shows:

  • Its name and capabilities (text, vision, image generation, etc.)
  • Context window size
  • Pricing per token

Model availability may be filtered by your organization's model permission settings. If a model you expect isn't showing up, check with your org admin.

Fallback

If the provider behind a default tier is unavailable, Studio falls back to another connected provider automatically — so a transient outage at one vendor doesn't break your agents.


New organizations get Deco AI Gateway credits out of the box — you can start using Decopilot and your agents without configuring anything. See Decopilot or API Keys for managing programmatic access to Studio itself.