The Decart provider for the Vercel AI SDK adds image and video generation to any AI SDK project.
Prerequisites
Installation
npm install @decartai/ai-sdk-provider
Setup
Import the default provider instance:
import { decart } from '@decartai/ai-sdk-provider';
DECART_API_KEY environment variable by default.
Set your Decart API key as an environment variable:
export DECART_API_KEY="your-api-key"
createDecart():
import { createDecart } from '@decartai/ai-sdk-provider';
const decart = createDecart({
apiKey: 'your-api-key',
baseURL: 'https://api.decart.ai',
});
API key for authentication. Defaults to the DECART_API_KEY environment variable.
Custom URL prefix for API calls. Defaults to https://api.decart.ai.
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
Aspect ratio of the generated image. Supported values: 16:9 (landscape) and 9:16 (portrait).
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);
Image-to-video
Animate a static image into a video:
const { videos } = await generateVideo({
model: decart.video('lucy-pro-i2v'),
prompt: {
image: imageData,
text: 'The subject begins to walk forward slowly',
},
});
Motion control
Use lucy-motion with a trajectory to control camera or subject movement:
const { videos } = await generateVideo({
model: decart.video('lucy-motion'),
prompt: {
image: imageData,
text: 'The subject moves along the specified path',
},
providerOptions: {
decart: {
trajectory: [
{ frame: 0, x: 0.5, y: 0.5 },
{ frame: 12, x: 0.7, y: 0.9 },
{ frame: 25, x: 0.3, y: 0.1 },
],
},
},
});
Video models
| Model | Description |
|---|
lucy-pro-t2v | Text-to-video generation |
lucy-pro-i2v | Image-to-video generation |
lucy-dev-i2v | Image-to-video generation (dev) |
lucy-motion | Image-to-video with trajectory-based motion control |
Video settings
Aspect ratio of the generated video. Supported values: 16:9 (landscape) and 9:16 (portrait).
Seed value for reproducible results.
Video resolution. Supported values: 1280x720 (720p) and 854x480 (480p).
Provider options
Pass Decart-specific options via providerOptions.decart:
trajectory
Array<{ frame: number; x: number; y: number }>
Motion path for lucy-motion. Each point specifies a frame number and normalized x/y coordinates (0–1).
Override orientation directly instead of deriving it from aspectRatio.
Next steps
