Prodia Provider

Prodia is a fast inference platform for generative AI, offering high-speed image generation with FLUX and Stable Diffusion models.

Setup

The Prodia provider is available via the @ai-sdk/prodia module. You can install it with

pnpm add @ai-sdk/prodia

Provider Instance

You can import the default provider instance prodia from @ai-sdk/prodia:

1
import { prodia } from '@ai-sdk/prodia';

If you need a customized setup, you can import createProdia and create a provider instance with your settings:

1
import { createProdia } from '@ai-sdk/prodia';
2

3
const prodia = createProdia({
4
  apiKey: 'your-api-key', // optional, defaults to PRODIA_TOKEN environment variable
5
  baseURL: 'custom-url', // optional
6
  headers: {
7
    /* custom headers */
8
  }, // optional
9
});

You can use the following optional settings to customize the Prodia provider instance:

• baseURL string

  Use a different URL prefix for API calls. The default prefix is https://inference.prodia.com/v2.

• apiKey string

  API key that is being sent using the Authorization header as a Bearer token. It defaults to the PRODIA_TOKEN environment variable.

• headers Record<string,string>

  Custom headers to include in the requests.

• fetch (input: RequestInfo, init?: RequestInit) => Promise<Response>

  Custom fetch implementation. You can use it as a middleware to intercept requests, or to provide a custom fetch implementation for e.g. testing.

Image Models

You can create Prodia image models using the .image() factory method. For more on image generation with the AI SDK see generateImage().

Basic Usage

1
import { writeFileSync } from 'node:fs';
2
import { prodia } from '@ai-sdk/prodia';
3
import { generateImage } from 'ai';
4

5
const { image } = await generateImage({
6
  model: prodia.image('inference.flux-fast.schnell.txt2img.v2'),
7
  prompt: 'A cat wearing an intricate robe',
8
});
9

10
const filename = `image-${Date.now()}.png`;
11
writeFileSync(filename, image.uint8Array);
12
console.log(`Image saved to ${filename}`);

Model Capabilities

Prodia offers fast inference for various image generation models. Here are the supported model types:

Image Size

You can specify the image size using the size parameter in WIDTHxHEIGHT format:

1
import { prodia } from '@ai-sdk/prodia';
2
import { generateImage } from 'ai';
3

4
const { image } = await generateImage({
5
  model: prodia.image('inference.flux-fast.schnell.txt2img.v2'),
6
  prompt: 'A serene mountain landscape at sunset',
7
  size: '1024x768',
8
});

Provider Options

Prodia image models support additional options through the providerOptions.prodia object:

1
import { prodia, type ProdiaImageProviderOptions } from '@ai-sdk/prodia';
2
import { generateImage } from 'ai';
3

4
const { image } = await generateImage({
5
  model: prodia.image('inference.flux-fast.schnell.txt2img.v2'),
6
  prompt: 'A cat wearing an intricate robe',
7
  providerOptions: {
8
    prodia: {
9
      width: 1024,
10
      height: 768,
11
      steps: 4,
12
      stylePreset: 'cinematic',
13
    } satisfies ProdiaImageProviderOptions,
14
  },
15
});

The following provider options are supported:

• width number - Output width in pixels (256–1920). When set, this overrides any width derived from size.
• height number - Output height in pixels (256–1920). When set, this overrides any height derived from size.
• steps number - Number of computational iterations (1–4). More steps typically produce higher quality results.
• stylePreset string - Apply a visual theme to the output image. Supported presets: 3d-model, analog-film, anime, cinematic, comic-book, digital-art, enhance, fantasy-art, isometric, line-art, low-poly, neon-punk, origami, photographic, pixel-art, texture, craft-clay.
• loras string[] - Augment the output with up to 3 LoRA models.
• progressive boolean - When using JPEG output, return a progressive JPEG.

Seed

You can use the seed parameter to get reproducible results:

1
import { prodia } from '@ai-sdk/prodia';
2
import { generateImage } from 'ai';
3

4
const { image } = await generateImage({
5
  model: prodia.image('inference.flux-fast.schnell.txt2img.v2'),
6
  prompt: 'A serene mountain landscape at sunset',
7
  seed: 12345,
8
});

Provider Metadata

The generateImage response includes provider-specific metadata in providerMetadata.prodia.images[]. Each image object may contain the following properties:

• jobId string - The unique identifier for the generation job.
• seed number - The seed used for generation. Useful for reproducing results.
• elapsed number - Generation time in seconds.
• iterationsPerSecond number - Processing speed metric.
• createdAt string - Timestamp when the job was created.
• updatedAt string - Timestamp when the job was last updated.

1
import { prodia } from '@ai-sdk/prodia';
2
import { generateImage } from 'ai';
3

4
const { image, providerMetadata } = await generateImage({
5
  model: prodia.image('inference.flux-fast.schnell.txt2img.v2'),
6
  prompt: 'A serene mountain landscape at sunset',
7
});
8

9
// Access provider metadata
10
const metadata = providerMetadata?.prodia?.images?.[0];
11
console.log('Job ID:', metadata?.jobId);
12
console.log('Seed:', metadata?.seed);
13
console.log('Elapsed:', metadata?.elapsed);