A TypeScript provider for the Vercel AI SDK that enables image generation using AUTOMATIC1111 Stable Diffusion WebUI
npm install automatic1111-provider---
title: Automatic1111
description: Automatic1111 Provider for the AI SDK
---
--api flag enabled. Start your AUTOMATIC1111 instance with:
bash
Windows
./webui.bat --api
Linux/Mac
./webui.sh --api
`
The Automatic1111 provider is available in the automatic1111-provider module. You can install it with:
`bash
pnpm
pnpm add automatic1111-provider
npm
npm install automatic1111-provider
yarn
npm install automatic1111-provider
`
Provider Instance
To create an Automatic1111 provider instance, use the createAutomatic1111 function:
`typescript
import { createAutomatic1111 } from 'automatic1111-provider';
const automatic1111 = createAutomatic1111({
baseURL: 'http://127.0.0.1:7860', // Your AUTOMATIC1111 instance
});
`
Image Models
The Automatic1111 provider supports image generation through the image() method:
`typescript
// Basic image generation
const imageModel = automatic1111.image('v1-5-pruned-emaonly');
// With custom model
const sdxlModel = automatic1111.image('sd_xl_base_1.0');
`
Examples
$3
`typescript
import { automatic1111 } from 'automatic1111-provider';
import { experimental_generateImage as generateImage } from 'ai';
const { images } = await generateImage({
model: automatic1111.image('v1-5-pruned-emaonly'),
prompt: 'A beautiful sunset over mountains',
size: '512x512',
});
`
$3
`typescript
const { images } = await generateImage({
model: automatic1111.image('realistic-vision-v4'),
prompt: 'Portrait of a wise old wizard with a long beard',
n: 2,
seed: 12345,
providerOptions: {
automatic1111: {
negative_prompt: 'blurry, ugly, deformed, low quality',
steps: 40,
cfg_scale: 8.5,
sampler_name: 'DPM++ SDE Karras',
styles: ['photorealistic', 'detailed'],
check_model_exists: true,
}
}
});
`
Provider Options
The Automatic1111 provider supports the following options for customizing image generation:
$3
| Option | Type | Default | Description |
|--------|------|---------|-------------|
| negative_prompt | string | undefined | What you don't want in the image |
| steps | number | 20 | Number of sampling steps |
| cfg_scale | number | 7 | CFG (Classifier Free Guidance) scale |
| sampler_name | string | "Euler a" | Sampling method |
| denoising_strength | number | undefined | Denoising strength for img2img (0.0-1.0) |
| styles | string[] | undefined | Apply predefined styles |
| check_model_exists | boolean | false | Verify model exists before generation |
Model Management
The provider automatically detects available models from your AUTOMATIC1111 instance. To use a model:
1. Place your .safetensors or .ckpt model files in the models/Stable-diffusion/` folder