TL;DR: The AI Gateway controls which language models power Ask Ballet, agents, and AI steps in your workspace. Choose Ballet Models (managed by Ballet) or bring your own AI provider credentials. Owners and Builders configure this in Settings → AI Gateway.

**TL;DR:** The AI Gateway controls which language models power Ask Ballet, agents, and AI steps in your workspace. Choose **Ballet Models** (managed by Ballet) or bring your own AI provider credentials. Owners and Builders configure this in **Settings → AI Gateway**.

 ![](https://docs.ballet.dev/api/attachments.redirect?id=4fcccd9b-c77b-4889-aa13-0e2314e7ab88 " =3022x1704")

## Who this is for

Owners and Builders configuring AI model access for the workspace.

## What is the AI Gateway?

The AI Gateway routes AI requests from the Console, agents, and playbook steps to a language model. It handles provider selection, routing, and usage tracking.

## What are Ballet Models?

**Ballet Models** are managed model endpoints provided by Ballet — no separate API key required. Usage counts against your workspace's AI credits and billing allowance.

## Can I bring my own provider?

Yes. Configure your own provider credentials in **Settings → AI Gateway** to route AI requests through your existing LLM accounts (e.g. OpenAI, Anthropic).

## Who can change AI Gateway settings?

Owners and Builders. Members do not access AI Gateway settings.

## How does this affect billing?

AI usage through Ballet Models counts toward your workspace's usage and billing. See [How does usage and billing work?](/doc/how-does-usage-and-billing-work-I5P6EqtRUR).

## Related articles

* [How does usage and billing work?](/doc/how-does-usage-and-billing-work-I5P6EqtRUR)
* [What are Agents?](/doc/what-are-agents-OKFRlcHoGP)
* [How do I build a playbook with the Console?](/doc/how-do-i-build-a-playbook-with-the-console-ask-ballet-oHptRP9mI4)




What is the AI Gateway / Ballet Models?

Roles, invites, AI Gateway, API tokens, and billing.

How do I create and use API tokens?

How do I invite users?

How does usage and billing work?

What are the roles and permissions (Owner/Builder/Member)?

Workspace and Admin

Build your first automation with Ask Ballet

Deterministic agents: Ballet's approach

Getting Started with Ballet

How do I join the early access program?

How do I navigate the Studio (sidebar + command palette)?

How do I sign in and access my workspace?

What happens during workspace onboarding?

What is Ballet?

What to expect as a design partner

What's the difference between Builder and Member mode?

Ballet vs Automation Anywhere

Ballet vs Claude Cowork

Ballet vs Moveworks (ServiceNow)

Ballet vs n8n

Ballet vs Power Automate

Ballet vs Temporal

Ballet vs UiPath

Ballet vs Workato

Ballet vs Zapier

Why Ballet

Getting Started

Building Playbooks

How do I build a playbook with the Console (Ask Ballet)?

How do I edit steps (Code and HTTP)?

How do I use the playbook workspace (Play / Code / History)?

How does the Plan vs Build flow work?

What are Allow vs Ask permission modes?

What is a playbook?

How do I manage Schedules?

How do I pause and resume a playbook run?

How do I read runs and run history?

How do I run a playbook?

How do I share run output?

Run from your environment via API

Running and Automating

What triggers can start a playbook (Manual, Schedule, Webhook)?

Connecting Tools

How do first-party integrations (Cursor, Freshdesk) work?

How do I connect an MCP server?

How do I connect CRM and support tools?

How do I connect Genesys Cloud?

How do I connect HubSpot?

How do I connect Salesforce?

How do I connect ServiceNow?

How do I connect Zendesk?

How do I store credentials with Secrets?

What is a connector and how do I browse the registry?

Ballet glossary

Concepts and Glossary

How do Collections and Git sync work?

What are Agents?

What are Skills?

What are Tools and the playground?

Recipe: Data sync and ETL to a warehouse

Recipe: Scheduled reports and readouts

Data Ops recipes

Recipe: AI code review on pull requests with Cursor

Recipe: Incident response and on-call paging

Recipe: Triage new errors into tracked issues

Engineering Ops recipes

Recipe: Invoice and expense processing

Recipe: Reconcile payments and payouts

Finance Ops recipes

Introduction

Recipe: Campaign performance report

Recipe: Competitor monitoring digest

Recipe: Content and marketing operations

Recipe: Generate a content brief

Marketing Ops recipes

Recipe: Automate new customer onboarding

Recipe: Enrich new leads automatically

Recipe: Score, route, and follow up on leads

RevOps recipes

Recipe: Auto-answer and deflect common tickets

Recipe: CSAT follow-up after ticket resolution

Recipe: Escalate SLA breaches and priority tickets

Recipe: Triage and route support tickets

Support Ops recipes

Playbook Recipes

How do I authenticate with the Ballet API?

How do I connect to Ballet's MCP endpoint?

How do I run a playbook over the REST API?

How do I stream playbook run events?

How do I trigger and react to playbooks with webhooks?

How do I wake a suspended run with reply or resume?

Developer foundations

How do I call Ballet playbooks from Google ADK?

How do I call Ballet playbooks from LangChain?

How do I call Ballet playbooks from Mastra?

How do I call Ballet playbooks from Pydantic AI?

How do I call Ballet playbooks from the Vercel AI SDK?

How do I use Ballet playbooks in an agent framework?

How do I call external APIs and SDKs from a playbook?

How do I connect external MCP servers to playbooks?

How do I use secrets and env vars in steps?

How do playbooks connect to external systems?

Developer Docs

Guide

Recipes

Developer

Ballet 

What is the AI Gateway / Ballet Models?

Share

Who this is for