@uploadista/flow-images-replicate

AI-powered image operations for Uploadista flows. Use Replicate's ML models for advanced image manipulation.

Overview

Replicate integration enables AI image operations:

- Background Removal: AI-powered background removal
- Upscaling: Enhance image resolution
- Style Transfer: Apply artistic styles
- Custom Models: Use any Replicate model
- Serverless: No GPU infrastructure needed

Perfect for advanced image processing workflows.

Installation

``bash
npm install @uploadista/flow-images-replicate


or


pnpm add @uploadista/flow-images-replicate
`

$3

- Replicate API token (get from replicate.com)
- Node.js 18+

Quick Start

`typescript
import { imageAiPlugin } from "@uploadista/flow-images-replicate";

const flow = {
nodes: [
{ id: "input", type: "input" },
{
id: "remove-bg",
type: "background-removal",
params: { model: "rembg" },
},
{ id: "s3", type: "s3" },
{ id: "output", type: "output" },
],
};
`

Features

- ✅ AI Models: Background removal, upscaling, effects
- ✅ No GPU Needed: Replicate handles compute
- ✅ Serverless: Pay per request
- ✅ Webhook Support: Async processing
- ✅ Custom Models: Use any Replicate model

Node Types

$3

`typescript
{
type: "remove-background",
params: {
model: "rembg", // AI model
returnFormat: "png",
},
}
`

$3

`typescript
{
type: "upscale",
params: {
scale: 4, // 2x, 4x upscaling
model: "real-esrgan",
},
}
`

$3

`typescript
{
type: "style-transfer",
params: {
style: "oil-painting",
model: "arbitrary-style-transfer",
},
}
`

Configuration

Set API token:

`typescript
export const config = {
replicate: {
apiToken: process.env.REPLICATE_API_TOKEN,
},
};
`

Use Cases

- Remove backgrounds from product photos
- Upscale low-resolution images
- Apply artistic effects
- Custom ML image processing
- Batch AI operations

Examples

$3

`typescript
const productFlow = {
nodes: [
{ id: "input", type: "input" },
{
id: "remove-bg",
type: "remove-background",
params: { model: "rembg" },
},
{
id: "upscale",
type: "upscale",
params: { scale: 2, model: "real-esrgan" },
},
{ id: "s3", type: "s3", params: { bucket: "products" } },
{ id: "output", type: "output" },
],
edges: [
{ from: "input", to: "remove-bg" },
{ from: "remove-bg", to: "upscale" },
{ from: "upscale", to: "s3" },
{ from: "s3", to: "output" },
],
};
`

$3

`typescript
const creativeFlow = {
nodes: [
{ id: "input", type: "input" },
{
id: "style",
type: "style-transfer",
params: {
style: "oil-painting",
model: "arbitrary-style-transfer",
},
},
{ id: "upscale", type: "upscale", params: { scale: 2 } },
{ id: "s3", type: "s3" },
{ id: "output", type: "output" },
],
};
`

Performance

| Operation | Time |
|-----------|------|
| Background removal | 5-15s |
| Upscaling (2x) | 10-20s |
| Style transfer | 15-30s |
| Async webhook | Variable |

All operations asynchronous via webhook.

Cost

Replicate pricing (varies by model):
- Background removal: ~$0.001-0.002 per image
- Upscaling: ~$0.01-0.05 per image
- Style transfer: ~$0.02-0.10 per image

Best Practices

$3

`typescript
// Use webhooks for long-running AI ops
{
type: "remove-background",
params: {
model: "rembg",
webhook: "https://yourapi.com/callbacks",
async: true,
},
}
`

$3

`typescript
// Process multiple images in parallel
const batch = [image1, image2, image3];
const results = yield* Effect.all(
batch.map((img) => removeBackground(img))
);
`

$3

`typescript
// AI models may fail or timeout
yield* removeBackground(image).pipe(
Effect.catch((error) => {
// Fallback to standard processing
return standardBackgroundRemoval(image);
})
);
``

Related Packages

- @uploadista/flow-images-nodes - Base types
- @uploadista/flow-images-sharp - Standard processing
- @uploadista/server - Upload server

License

See LICENSE in the main repository.

See Also

- Replicate Documentation - Replicate API
- FLOW_NODES.md - All available nodes
- Replicate Models - Available AI models