Vercel AI SDK

Generate images and videos with Decart using the Vercel AI SDK.

The Decart provider for the Vercel AI SDK adds image and video generation to any AI SDK project.

Prerequisites

• A Decart API key
• Node.js 18+
• The ai package (npm i ai)

Installation

npm

npm install @decartai/ai-sdk-provider

Setup

Import the default provider instance:

import { decart } from '@decartai/ai-sdk-provider';

The provider reads your API key from the DECART_API_KEY environment variable by default.

Set your Decart API key as an environment variable:

export DECART_API_KEY="your-api-key"

Get your API key from platform.decart.ai. See authentication for details.

For custom configuration, use createDecart():

import { createDecart } from '@decartai/ai-sdk-provider';

const decart = createDecart({
  apiKey: 'your-api-key',
  baseURL: 'https://api.decart.ai',
});

apiKey · string

API key for authentication. Defaults to the DECART_API_KEY environment variable.

baseURL · string

Custom URL prefix for API calls. Defaults to https://api.decart.ai.

headers · Record<string, string>

Custom headers to include in requests.

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

Custom fetch implementation for intercepting requests or testing.

Image generation

Generate images with generateImage():

import { decart } from '@decartai/ai-sdk-provider';
import { generateImage } from 'ai';
import fs from 'fs';

const { image } = await generateImage({
  model: decart.image('lucy-pro-t2i'),
  prompt: 'A golden retriever sitting in a field of wildflowers at sunset',
});

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

Image models

Model	Description
lucy-pro-t2i	High-quality text-to-image generation

Image settings

aspectRatio · string

Aspect ratio of the generated image. Supported values: 16:9 (landscape) and 9:16 (portrait).

seed · number

Seed value for reproducible results.

Unsupported aspect ratios generate a warning and fall back to the default behavior.

const { image } = await generateImage({
  model: decart.image('lucy-pro-t2i'),
  prompt: 'A minimalist Japanese garden with cherry blossoms',
  aspectRatio: '16:9',
  seed: 42,
});

Video generation

Generate videos with experimental_generateVideo():

experimental_generateVideo is an experimental AI SDK API. The function signature may change in future releases.

Text-to-video

import { decart } from '@decartai/ai-sdk-provider';
import { experimental_generateVideo as generateVideo } from 'ai';
import fs from 'fs';

const { videos } = await generateVideo({
  model: decart.video('lucy-pro-t2v'),
  prompt: 'A horse galloping through a sunlit meadow',
});

fs.writeFileSync('video.mp4', videos[0].uint8Array);

Video models

Model	Description
lucy-pro-t2v	Text-to-video generation

Video settings

aspectRatio · string

Aspect ratio of the generated video. Supported values: 16:9 (landscape) and 9:16 (portrait).

seed · number

Seed value for reproducible results.

resolution · string

Video resolution. Supported values: 1280x720 (720p) and 854x480 (480p).

Provider options

Pass Decart-specific options via providerOptions.decart:

orientation · "landscape" | "portrait"

Override orientation directly instead of deriving it from aspectRatio.

Next steps

Models overview

Explore all available Decart models.

JavaScript SDK

Use Decart’s native SDK for full API access.

GitHub

View source code and contribute.