> ## Documentation Index > Fetch the complete documentation index at: https://docs.dartantic.ai/llms.txt > Use this file to discover all available pages before exploring further. # Providers > Providers for chat and embeddings models. The `dartantic_ai` package ships **10 built-in providers**. For **Flutter** apps that use Gemini through [Firebase AI Logic](https://firebase.google.com/docs/ai-logic), add the optional [`dartantic_firebase_ai`](https://pub.dev/packages/dartantic_firebase_ai) package and register it (see [Firebase AI](#firebase-ai-flutter-add-on) below). Additional OpenAI-compatible endpoints are available via the `openai_compat.dart` example. ## Provider Capabilities | Provider | Default Model | Default Embedding Model | Capabilities | Notes | | -------------------- | ----------------------------- | ------------------------ | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------- | | **OpenAI** | `gpt-4o` | `text-embedding-3-small` | Chat, Embeddings, Vision, Tools, Streaming | Full feature support | | **OpenAI Responses** | `gpt-5` | `text-embedding-3-small` | Chat, Embeddings, Vision, Tools, Streaming, Thinking | Includes built-in server-side tools | | **Anthropic** | `claude-sonnet-4-0` | - | Chat, Vision, Tools, Streaming, Thinking | Extended thinking with token budgets | | **Google** | `gemini-2.5-flash` | `text-embedding-004` | Chat, Embeddings, Vision, Tools, Streaming, Thinking | Extended thinking with dynamic budgets | | **Firebase AI** | `gemini-2.5-flash` | - | Chat, Vision, Tools, Streaming, Thinking, Media | Gemini via Firebase SDK (Flutter only) | | **Mistral** | `mistral-small-latest` | `mistral-embed` | Chat, Embeddings, Tools, Streaming | European servers | | **Cohere** | `command-r-08-2024` | `embed-v4.0` | Chat, Embeddings, Tools, Streaming | RAG-optimized | | **Ollama** | `qwen2.5:7b-instruct` | - | Chat, Tools, Streaming | Local models only | | **OpenRouter** | `google/gemini-2.5-flash` | - | Chat, Vision, Tools, Streaming | Multi-model gateway | | **xAI** | `grok-4-1-fast-non-reasoning` | - | Chat, Vision, Tools, Streaming | OpenAI-compatible chat completions; no embeddings or `temperature` in Dartantic | | **xAI Responses** | `grok-4-1-fast-non-reasoning` | - | Chat, Vision, Tools, Streaming, Thinking, Server-side tools, Media | Stateful Responses API; default image `grok-imagine-image`, video `grok-imagine-video` | **Note**: Together AI, Google-OpenAI, and Ollama-OpenAI have been moved to the `openai_compat.dart` example. You can still use them by registering them with `Agent.providerFactories`. ## Provider Configuration | Provider | Provider Prefix | Aliases | API Key | Provider Type | | -------------------- | ------------------ | -------------------- | -------------------- | ------------------------- | | **OpenAI** | `openai` | - | `OPENAI_API_KEY` | `OpenAIProvider` | | **OpenAI Responses** | `openai-responses` | - | `OPENAI_API_KEY` | `OpenAIResponsesProvider` | | **Anthropic** | `anthropic` | `claude` | `ANTHROPIC_API_KEY` | `AnthropicProvider` | | **Google** | `google` | `gemini`, `googleai` | `GEMINI_API_KEY` | `GoogleProvider` | | **Firebase AI** | `firebase` | - | None (Firebase) | `FirebaseAIProvider` | | **Mistral** | `mistral` | - | `MISTRAL_API_KEY` | `MistralProvider` | | **Cohere** | `cohere` | - | `COHERE_API_KEY` | `CohereProvider` | | **Ollama** | `ollama` | - | None (local) | `OllamaProvider` | | **OpenRouter** | `openrouter` | - | `OPENROUTER_API_KEY` | `OpenAIProvider` | | **xAI** | `xai` | `grok` | `XAI_API_KEY` | `XAIProvider` | | **xAI Responses** | `xai-responses` | `grok-responses` | `XAI_API_KEY` | `XAIResponsesProvider` | ## Firebase AI (Flutter add-on) Use [`dartantic_firebase_ai`](https://pub.dev/packages/dartantic_firebase_ai) when you want Gemini through the Firebase SDK (Firebase AI Logic), including App Check and Firebase Auth on the Vertex AI path. **Pure Dart** apps should keep using [`GoogleProvider`](/providers) with `GEMINI_API_KEY` instead. Add the package, call `Firebase.initializeApp()`, then register factories for each backend you need. Provider **name** is `firebase_ai`; model strings use the **aliases** below. | Backend | Prefix (alias) | Authentication / setup | | --------------------------------------------- | ----------------- | --------------------------------------------------------- | | Google AI (Gemini Developer API via Firebase) | `firebase-google` | Google AI API key in Firebase console; lighter setup | | Vertex AI (through Firebase) | `firebase-vertex` | Full Firebase project, billing; optional App Check / Auth | ```dart theme={null} import 'package:dartantic_ai/dartantic_ai.dart'; import 'package:dartantic_firebase_ai/dartantic_firebase_ai.dart'; import 'package:firebase_core/firebase_core.dart'; await Firebase.initializeApp(); Agent.providerFactories['firebase-google'] = () => FirebaseAIProvider(backend: FirebaseAIBackend.googleAI); Agent.providerFactories['firebase-vertex'] = () => FirebaseAIProvider(backend: FirebaseAIBackend.vertexAI); final dev = Agent('firebase-google:gemini-2.5-flash'); final prod = Agent('firebase-vertex:gemini-2.5-flash'); ``` **Platforms:** iOS, Android, macOS, and Web (Flutter only). Supports chat, streaming, tools, thinking, structured output, and media generation; **no** embeddings model. See the [`dartantic_firebase_ai` README](https://pub.dev/packages/dartantic_firebase_ai) for dependency versions and setup. ## Setup ```bash theme={null} # Set API keys export OPENAI_API_KEY="sk-..." export ANTHROPIC_API_KEY="sk-ant-..." export GEMINI_API_KEY="..." export XAI_API_KEY="..." ``` ## Usage ```dart theme={null} // Basic Agent('openai'); // With model Agent('anthropic:claude-3-5-sonnet'); // Chat + embeddings Agent('openai?chat=gpt-4o&embeddings=text-embedding-3-large'); // Extended thinking (OpenAI Responses, xAI Responses, Anthropic, Google) Agent('anthropic:claude-sonnet-4-5', enableThinking: true); // Server-side tools (OpenAI Responses) Agent('openai-responses:gpt-5'); // xAI Grok — OpenAI-compatible chat completions Agent('xai'); Agent('grok:grok-4-1-fast-non-reasoning'); // xAI Grok — Responses API (thinking, server-side tools, media models) Agent('xai-responses'); Agent('xai-responses:grok-4-1-fast-reasoning', enableThinking: true); ``` ## Find Providers ```dart theme={null} // All providers Agent.allProviders // By name (returns fresh instance) Agent.createProvider('claude') // → anthropic provider // For runtime capability discovery, use Provider.listModels() final provider = Agent.createProvider('openai'); await for (final model in provider.listModels()) { print('${model.name}: ${model.kinds}'); // Shows chat, embeddings, media, etc. } ``` ## Custom Config ```dart theme={null} final provider = OpenAIProvider( apiKey: 'key', baseUrl: Uri.parse('https://custom.api.com/v1'), ); Agent.forProvider(provider); ``` ## Custom Headers All providers support custom HTTP headers for enterprise scenarios like authentication proxies, request tracing, or compliance logging: ```dart theme={null} final provider = GoogleProvider( apiKey: apiKey, headers: { 'X-Request-ID': requestId, 'X-Tenant-ID': tenantId, }, ); final agent = Agent.forProvider(provider); ``` Custom headers flow through to all API calls and can override internal headers when needed. This works consistently across OpenAI, Google, Anthropic, Mistral, Ollama, and xAI providers. ## Check Capabilities Use `Provider.listModels()` for runtime capability discovery: ```dart theme={null} // List models and their capabilities final provider = Agent.createProvider('openai'); await for (final model in provider.listModels()) { print('${model.name}: ${model.kinds}'); // Output: gpt-4o: {chat}, text-embedding-3-small: {embeddings} } // Check if a specific model supports embeddings final models = await provider.listModels().toList(); final hasEmbeddings = models.any((m) => m.kinds.contains(ModelKind.embeddings)); if (hasEmbeddings) { final agent = Agent('openai'); final embed = await agent.embedQuery('test'); } else { print('Provider does not support embeddings'); } ``` ### Model Kinds Models are categorized by their kind via `ModelKind` (a model may report multiple kinds): * **`chat`** - Chat / completion models * **`embeddings`** - Text embedding models * **`media`** - Unified media generation (images, documents, audio, etc.) * **`image`** - Image generation or vision models * **`video`** - Video generation models * **`audio`** - Audio processing (e.g. speech-to-text) * **`tts`** - Text-to-speech * **`countTokens`** - Token counting * **`other`** - Other specialized model types ### Typed Output With Tools The `typedOutputWithTools` capability indicates a provider can handle both function calling and structured JSON output in the same request: | Provider | Support | Implementation | | ---------------- | ------- | ---------------------------------------- | | OpenAI | ✅ | Native `response_format` | | OpenAI Responses | ✅ | Native `response_format` | | Anthropic | ✅ | `return_result` tool | | Google | ✅ | Double agent orchestrator | | OpenRouter | ✅ | OpenAI-compatible | | xAI | ✅ | OpenAI-compatible | | xAI Responses | ✅ | Native `response_format` (Responses API) | | Ollama | ❌ | Coming soon | | Cohere | ❌ | API limitation | *Together AI, Google-OpenAI, and Ollama-OpenAI also support typed output with tools when registered via the `openai_compat.dart` example.* **Anthropic's approach** uses the `return_result` tool pattern. This is a special tool that allows the model to return a structured JSON response. This is handled automatically by the Anthropic provider. **Google's approach** uses a transparent two-phase workflow: Phase 1 executes tools, Phase 2 requests structured output. This is handled automatically by the Google provider. ## List Models ```dart theme={null} // List all models from a provider final provider = Agent.createProvider('openai'); await for (final model in provider.listModels()) { final status = model.stable ? 'stable' : 'preview'; print('${model.name}: ${model.displayName} [$status]'); } // Example output: // - openai:gpt-4-0613 (chat) // - openai:gpt-4 (chat) // - openai:gpt-3.5-turbo (chat) ``` ## Examples * [List all provider models](https://github.com/csells/dartantic_ai/blob/main/packages/dartantic_ai/example/bin/provider_models.dart) * [Multi-provider conversations](https://github.com/csells/dartantic_ai/blob/main/packages/dartantic_ai/example/bin/multi_provider.dart) * [Custom providers](https://github.com/csells/dartantic_ai/blob/main/packages/dartantic_ai/example/bin/custom_provider.dart)