Overview

npm install @decartai/sdk
# or
pnpm add @decartai/sdk
# or
yarn add @decartai/sdk

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

const client = createDecartClient({
  apiKey: process.env.DECART_API_KEY,
});

// Edit a video using the Queue API
const result = await client.queue.submitAndPoll({
  model: models.video("lucy-2.1"),
  data: videoFile,
  prompt: "Transform into anime style",
  resolution: "720p",
  onStatusChange: (job) => {
    console.log(`Status: ${job.status}`);
  },
});

if (result.status === "completed") {
  const buffer = Buffer.from(await result.data.arrayBuffer());
  writeFileSync("output.mp4", buffer);
  console.log("Video saved!");
}

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

const client = createDecartClient({
  apiKey: process.env.DECART_API_KEY,
});

// On your backend — basic (60s TTL, unrestricted)
const { apiKey, expiresAt } = await client.tokens.create();

// Or scoped to specific models and origins with a longer TTL
const token = await client.tokens.create({
  expiresIn: 300,
  allowedModels: ["lucy-2.1"],
  allowedOrigins: ["https://app.example.com"], // browser-enforced; canonical origin
});
// Send token.apiKey to your frontend for secure client-side authentication

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

// Realtime models
models.realtime("lucy-2.1");              // Realtime video editing (latest)
models.realtime("lucy-vton-3");           // Virtual try-on (latest)
models.realtime("lucy-restyle-2");        // Realtime video restyling

// Video models
models.video("lucy-2.1");                // Video editing (latest)
models.video("lucy-vton-3");             // Virtual try-on (latest)
models.video("lucy-restyle-2");          // Video restyling

// Image models
models.image("lucy-image-2");            // Image editing

// Latest aliases — always point to the newest version
models.realtime("lucy-latest");           // Latest realtime editing model
models.video("lucy-latest");              // Latest video editing model
models.video("lucy-vton-latest");         // Latest virtual try-on model
models.video("lucy-restyle-latest");      // Latest video restyling model
models.image("lucy-image-latest");        // Latest image editing model

// Video editing requires 'data' field
await client.queue.submitAndPoll({
  model: models.video("lucy-2.1"),
  prompt: "Transform into anime style",
  data: videoFile, // ✅ Required
});

// Image editing requires 'data' field
await client.process({
  model: models.image("lucy-image-2"),
  prompt: "Change the background to a beach",
  data: imageFile, // ✅ Required
});