Documentation Index
Fetch the complete documentation index at: https://chatjs.dev/docs/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Configure which AI models are available in your app and how they behave. All model configuration lives in chat.config.ts under config.ai.
Configuration Options
ai: {
gateway: "vercel"; // "vercel" | "openrouter" | "openai" | "openai-compatible"
providerOrder: string[]; // Provider sort order in model selector
disabledModels: AppModelId[]; // Models hidden from all users
curatedDefaults: AppModelId[]; // Default models enabled for new users
anonymousModels: AppModelId[]; // Models available to anonymous users
workflows: { // Default model for shared app workflows
chat: AppModelId;
title: AppModelId;
pdf: AppModelId;
chatImageCompatible: AppModelId;
};
tools: { // Per-tool model and enablement config
followupSuggestions: { enabled: boolean; default: AppModelId };
text: { polish: AppModelId };
sheet: { format: AppModelId; analyze: AppModelId };
code: { edits: AppModelId };
image: { enabled: boolean; default?: ImageModelId };
video: { enabled: boolean; default?: VideoModelId };
deepResearch: {
enabled: boolean;
defaultModel: AppModelId;
finalReportModel: AppModelId;
};
// ... plus webSearch, urlRetrieval, codeExecution, mcp (no model field)
};
}
Provider Order
Control the display order of providers in the model selector:
ai: {
providerOrder: ["openai", "google", "anthropic", "xai"],
}
Disabling Models
Hide specific models from all users:
ai: {
disabledModels: ["morph/morph-v3-large", "morph/morph-v3-fast"],
}
Curated Defaults
Models enabled by default for new users. Users can enable additional models in settings.
ai: {
curatedDefaults: [
"openai/gpt-5-nano",
"openai/gpt-5-mini",
"google/gemini-2.5-flash-lite",
"anthropic/claude-sonnet-4.5",
],
}
Anonymous Models
Restrict which models anonymous (non-authenticated) users can access:
ai: {
anonymousModels: [
"google/gemini-2.5-flash-lite",
"openai/gpt-5-mini",
"openai/gpt-5-nano",
"anthropic/claude-haiku-4.5",
],
}
Workflow Defaults
ai.workflows sets the default model for shared app workflows (tasks that don’t have a user-facing model picker):
| Field | Description |
|---|
chat | Main conversation model |
title | Generates chat titles |
pdf | PDF document analysis |
chatImageCompatible | Chat fallback model when image input is required |
ai: {
workflows: {
chat: "openai/gpt-5-mini",
title: "openai/gpt-5-nano",
pdf: "openai/gpt-5-mini",
chatImageCompatible: "openai/gpt-4o-mini",
},
}
ai.tools configures the default model for each tool. These are merged with the gateway defaults — only fields you provide override the defaults.
| Tool field | Description |
|---|
followupSuggestions.default | Generates follow-up questions |
text.polish | Text refinement |
sheet.format | Spreadsheet formatting |
sheet.analyze | Spreadsheet analysis |
code.edits | Code modifications |
image.default | Image generation (see Image Generation) |
video.default | Video generation (see Video Generation) |
deepResearch.defaultModel | Research and supervision agent (see Deep Research) |
deepResearch.finalReportModel | Final report synthesis for deep research |
ai: {
tools: {
followupSuggestions: { enabled: true, default: "google/gemini-2.5-flash-lite" },
text: { polish: "openai/gpt-5-mini" },
sheet: { format: "openai/gpt-5-mini", analyze: "openai/gpt-5-mini" },
code: { edits: "openai/gpt-5-mini" },
image: { enabled: true, default: "google/gemini-3-pro-image" },
video: { enabled: false },
deepResearch: {
enabled: true,
defaultModel: "google/gemini-2.5-flash-lite",
finalReportModel: "google/gemini-3-flash",
},
},
}
AI Providers
Available providers should be listed in config.services.aiProviders:
aiProviders: [
"OpenAI", "Anthropic", "xAI", "Google", "Meta",
"Mistral", "Alibaba", "Amazon", "Cohere", "DeepSeek",
"Perplexity", "Vercel", "Inception", "Moonshot", "Morph", "ZAI",
],
Image Models
Set the default image model in ai.tools.image.default (gateway-specific model ID). The generateImage tool resolves the model at runtime: if the user’s selected chat model supports image output (per the app model registry), it uses that; otherwise it uses this default. Resolution uses the dynamic gateway-based registry, not a static snapshot. See Image Generation for details.
