feat: remove retired Lucy model IDs

examples/nextjs-realtime/README.md

@@ -47,4 +47,4 @@ This example uses `lucy-restyle-2` for style transformation. You can also use:
 
 - `lucy-restyle` - MirageLSD video restyling model (older)
 - `lucy` - Lucy for video editing (add objects, change elements)
-- `lucy-2` - Lucy 2 for video editing with reference image support (better quality)
+- `lucy-2.1` - Lucy 2.1 for video editing with reference image support

examples/react-vite/README.md

@@ -45,4 +45,4 @@ This example uses `lucy-restyle-2` for style transformation. You can also use:
 
 - `lucy-restyle` - MirageLSD video restyling model (older)
 - `lucy` - Lucy for video editing (add objects, change elements)
-- `lucy-2` - Lucy 2 for video editing with reference image support (better quality)
+- `lucy-2.1` - Lucy 2.1 for video editing with reference image support

examples/sdk-core/README.md

@@ -38,7 +38,7 @@ Image models use the synchronous Process API - they return immediately with a Bl
 Video models use the asynchronous Queue API - jobs are submitted and polled for completion.
 
 - `video/video-to-video.ts` - Transform existing video with a prompt (`lucy-clip`)
-- `video/video-editing.ts` - Edit video with prompt, reference image, or both (`lucy-2`)
+- `video/video-editing.ts` - Edit video with prompt, reference image, or both (`lucy-2.1`)
 - `video/long-form-video-restyle.ts` - Transform existing video with `lucy-restyle-2`
 - `video/manual-polling.ts` - Manual job status polling
 
@@ -50,7 +50,7 @@ See `examples/nextjs-realtime` or `examples/react-vite` for runnable demos.
 - `realtime/mirage-basic.ts` - Basic Mirage connection (style transformation)
 - `realtime/mirage-v2-basic.ts` - Mirage v2 connection (improved style transformation)
 - `realtime/lucy-v2v-720p.ts` - Lucy v2v realtime (video editing - add objects, change elements)
-- `realtime/lucy-2.ts` - Lucy 2 realtime (better quality video editing with reference image support)
+- `realtime/lucy-2.1.ts` - Lucy 2.1 realtime video editing with reference image support
 - `realtime/live-avatar.ts` - Live avatar (audio-driven avatar with playAudio or mic input)
 - `realtime/connection-events.ts` - Handling connection state and errors
 - `realtime/prompt-update.ts` - Updating prompt dynamically

examples/sdk-core/video/video-editing.ts

@@ -12,13 +12,13 @@ run(async () => {
     apiKey,
   });
 
-  console.log("Editing video with lucy-2...");
+  console.log("Editing video with lucy-2.1...");
 
   const inputVideo = fs.readFileSync("input.mp4");
 
   // Option 1: Use a text prompt
   const result = await client.queue.submitAndPoll({
-    model: models.video("lucy-2"),
+    model: models.video("lucy-2.1"),
     prompt: "Transform to watercolor painting style with soft brushstrokes",
     data: new Blob([inputVideo]),
     onStatusChange: (job) => {
@@ -29,7 +29,7 @@ run(async () => {
   // Option 2: Use a reference image to guide the edit (with empty prompt)
   // const referenceImage = fs.readFileSync("reference.png");
   // const result = await client.queue.submitAndPoll({
-  //   model: models.video("lucy-2"),
+  //   model: models.video("lucy-2.1"),
   //   prompt: "",
   //   reference_image: new Blob([referenceImage]),
   //   data: new Blob([inputVideo]),
@@ -41,7 +41,7 @@ run(async () => {
   // Option 3: Use both a prompt and a reference image together
   // const referenceImage = fs.readFileSync("reference.png");
   // const result = await client.queue.submitAndPoll({
-  //   model: models.video("lucy-2"),
+  //   model: models.video("lucy-2.1"),
   //   prompt: "Apply the style from the reference image",
   //   reference_image: new Blob([referenceImage]),
   //   data: new Blob([inputVideo]),

examples/tanstack-streamer/README.md

@@ -27,7 +27,7 @@ pnpm dev
 
 ## Features
 
-- Real-time webcam video transformation using `lucy-2`
+- Real-time webcam video transformation using `lucy-2.1`
 - Producer + subscriber streaming pattern
 - Shareable viewer link via subscribe token
 - Dynamic style prompt updates
@@ -38,7 +38,7 @@ pnpm dev
 
 | Route | Description |
 |-------|-------------|
-| `/` | **Producer** — streams your camera through `lucy-2`, shows styled output, and generates a shareable viewer link |
+| `/` | **Producer** — streams your camera through `lucy-2.1`, shows styled output, and generates a shareable viewer link |
 | `/watch?token=...` | **Subscriber** — watches the producer's styled stream (receive-only, no camera needed) |
 
 ## How it works
@@ -51,7 +51,7 @@ pnpm dev
 
 ## Models
 
-This example uses `lucy-2` for video editing with reference image support. You can also use:
+This example uses `lucy-2.1` for video editing with reference image support. You can also use:
 
 - `lucy-restyle` - MirageLSD video restyling model (older)
 - `lucy-restyle-2` - MirageLSD v2 for style transformation

examples/tanstack-streamer/src/routes/index.tsx

@@ -19,7 +19,7 @@ function ProducerPage() {
 
   const start = useCallback(async () => {
     try {
-      const model = models.realtime("lucy-2");
+      const model = models.realtime("lucy-2.1");
 
       setStatus("requesting-camera");
       const stream = await navigator.mediaDevices.getUserMedia({
@@ -94,7 +94,7 @@ function ProducerPage() {
     <div style={{ padding: "2rem", fontFamily: "system-ui, sans-serif" }}>
       <h1>Producer</h1>
       <p style={{ color: "#666" }}>
-        Streams your camera through <code>lucy-2</code> and generates a subscribe link for viewers.
+        Streams your camera through <code>lucy-2.1</code> and generates a subscribe link for viewers.
       </p>
 
       {status === "idle" && (

examples/ws-signaling-proxy/README.md

@@ -23,7 +23,7 @@ pnpm dev               # starts proxy on ws://localhost:8080
 Clients connect to:
 
 ```
-ws://localhost:8080/v1/stream?model=lucy_2_rt
+ws://localhost:8080/v1/stream?model=lucy-2.1
 ```
 
 ## Environment variables

examples/ws-signaling-proxy/src/index.ts

@@ -19,10 +19,10 @@ const server = createServer((_req, res) => {
 const wss = new WebSocketServer({ server });
 
 wss.on("connection", (clientWs: WebSocket, req) => {
-  // Accept Decart-style URLs: /v1/stream?api_key=...&model=lucy_2_rt
+  // Accept Decart-style URLs: /v1/stream?api_key=...&model=lucy-2.1
   // The proxy ignores api_key from the client and uses its own.
   const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
-  const model = url.searchParams.get("model") ?? "lucy_2_rt";
+  const model = url.searchParams.get("model") ?? "lucy-2.1";
 
   console.log(`[proxy] client connected from ${req.url} (model=${model})`);
 
@@ -37,7 +37,7 @@ wss.on("connection", (clientWs: WebSocket, req) => {
 
 server.listen(PORT, () => {
   console.log(`[proxy] listening on ws://localhost:${PORT}`);
-  console.log(`[proxy] connect with: ws://localhost:${PORT}/?model=lucy_2_rt`);
+  console.log(`[proxy] connect with: ws://localhost:${PORT}/?model=lucy-2.1`);
 });
 
 const shutdown = () => {

examples/ws-signaling-proxy/test/e2e.ts

@@ -37,7 +37,7 @@ test("e2e: signaling flow through proxy", { timeout: 30_000 }, async (t) => {
   });
 
   // Connect client
-  const ws = new WebSocket(`ws://localhost:${port}/v1/stream?model=lucy_2_rt`);
+  const ws = new WebSocket(`ws://localhost:${port}/v1/stream?model=lucy-2.1`);
   await new Promise<void>((r, e) => {
     ws.on("open", r);
     ws.on("error", e);

packages/sdk/AGENTS.md

@@ -66,13 +66,13 @@
 - `mirage` - Real-time video restyling model
 - `mirage_v2` - Real-time video restyling model (v2)
 - `lucy_v2v_720p_rt` - Real-time video editing model
-- `lucy_2_rt` - Real-time video editing model (supports reference image)
+- `lucy-2.1` - Real-time video editing model (supports reference image)
 
 ### Video Models (Queue API)
 - `lucy-pro-v2v` - video-to-video (Pro quality)
 - `lucy-motion` - motion-based image-to-video (trajectory-guided animation)
 - `lucy-restyle-v2v` - video restyling (video-to-video)
-- `lucy-2-v2v` - video-to-video editing (long-form, 720p)
+- `lucy-2.1` - video-to-video editing (long-form, 720p)
 
 ### Image Models (Process API)
 - `lucy-pro-i2i` - image-to-image (Pro quality)

packages/sdk/index.html

@@ -238,7 +238,7 @@ <h3>Configuration</h3>
                 <option value="mirage">Mirage</option>
                 <option value="mirage_v2" selected>Mirage v2</option>
                 <option value="lucy_v2v_720p_rt">Lucy v2v 720p RT</option>
-                <option value="lucy_2_rt">Lucy 2 RT</option>
+                <option value="lucy-2.1">Lucy 2.1 RT</option>
             </select>
         </div>
         <div class="control-group">
@@ -527,7 +527,7 @@ <h3>Console Logs</h3>
 
                 // Load initial reference image only when there's an actual prompt
                 let initialImage;
-                if (promptValue && (model.name === 'lucy_2_rt' || model.name === 'mirage_v2')) {
+                if (promptValue && (model.name === 'lucy-2.1' || model.name === 'mirage_v2')) {
                     const initialImageResponse = await fetch('./tests/fixtures/image.png');
                     initialImage = await initialImageResponse.blob();
                 }

packages/sdk/src/process/types.ts

@@ -99,7 +99,7 @@ export interface VideoEditInputs {
 }
 
 /**
- * Model-specific input documentation for lucy-2-v2v.
+ * Model-specific input documentation for Lucy 2.1 video editing models.
  * Requires prompt (can be empty string). Optional reference_image can also be provided.
  */
 export interface VideoEdit2Inputs {
@@ -163,7 +163,7 @@ export type ModelSpecificInputs<T extends ModelDefinition> = T["name"] extends "
   ? ImageEditingInputs
   : T["name"] extends "lucy-restyle-v2v" | "lucy-restyle-2"
     ? VideoRestyleInputs
-    : T["name"] extends "lucy-2-v2v" | "lucy-2" | "lucy-2.1" | "lucy-2.1-vton"
+    : T["name"] extends "lucy-2.1" | "lucy-2.1-vton"
       ? VideoEdit2Inputs
       : T["name"] extends "lucy-pro-v2v" | "lucy-clip"
         ? VideoEditInputs