Decart Realtime (Lucy)

Overview

Best for: Live AR-style filters, virtual try-on, and creative live streams.

At a glance

Price is Lucy Restyle 2 ($0.01/s); Lucy 2.5 is $1.20/min, fast mode $2.40/min. Billed at 720p; 1080p option exists. Free credit amount not stated.

Features

• realtime video-to-video
• text prompt and reference image control
• short-lived client tokens
• SDKs for JS, Python, Swift, Android
• auto-reconnect (5 retries)
• 1080p option on connect

Pricing

Free tier: New accounts get free credits (amount not stated). No subscription or minimum spend.

Source: docs.platform.decart.ai

Setup

1. Create an API key on platform.decart.ai.
2. Add a server route that mints short-lived client tokens restricted to the models you use.
3. npm install @decartai/sdk in the browser app.
4. Capture the webcam at the model's fps/size and call client.realtime.connect with a prompt.
5. Close the connection when the tab is hidden to stop billing.

Endpoint

WebRTC via @decartai/sdk (client.realtime.connect)

Authentication

API key server-side; short-lived client tokens in the browser

import { createDecartClient, models } from "@decartai/sdk";

// Browser: token comes from your server (serverClient.tokens.create)
const client = createDecartClient({
  apiKeyProvider: async () => {
    const r = await fetch("/api/realtime-token", { method: "POST" });
    return (await r.json()).apiKey;
  },
});

const model = models.realtime("lucy-2.5");
const cam = await navigator.mediaDevices.getUserMedia({
  video: { frameRate: model.fps, width: model.width, height: model.height },
});

const rt = await client.realtime.connect(cam, {
  model,
  onRemoteStream: (s) => { document.getElementById("out").srcObject = s; },
  initialState: { prompt: { text: "Turn me into a claymation character" } },
});

// Server (Express):
// const t = await serverClient.tokens.create({ expiresIn: 300,
//   allowedModels: ["lucy-2.5"] }); res.json(t);

Written from the current docs. Check the vendor's SDK version before you ship.

Warnings

Plus 9 warnings that apply to all avatars and live video APIs. See category warnings.

Limits

• Concurrent realtime sessions limited by account quota (Get Realtime Quota endpoint)
• Client tokens expire 60 s after minting by default

Models and products

Docs and sources

Docs

• Pricing
• Lucy 2.5 realtime
• JavaScript realtime SDK
• Streaming best practices

Sources used

• docs.platform.decart.ai/getting-started/pricing.md
• docs.platform.decart.ai/models/realtime/lucy-2.5.md
• docs.platform.decart.ai/sdks/javascript-realtime.md