feat(video): Add lucy-2-v2v model

[AdirAmsalem]

Summary

Adds SDK support for the new lucy-2-v2v video-to-video editing model. Pairs with DecartAI/api#682.

Usage

Video editing with a prompt

const result = await decart.queue.submit({
  model: models.video("lucy-2-v2v"),
  prompt: "Transform the scene into a cyberpunk city",
  data: videoFile,
});

With a reference image

const result = await decart.queue.submit({
  model: models.video("lucy-2-v2v"),
  prompt: "Apply this style to the video",
  data: videoFile,
  reference_image: styleImage,
  enhance_prompt: true,
  seed: 42,
});

With only a reference image (no prompt)

const result = await decart.queue.submit({
  model: models.video("lucy-2-v2v"),
  data: videoFile,
  reference_image: styleImage,
});

At least one of prompt or reference_image is required. Both can be provided together.

REST API

POST /v1/jobs/lucy-2-v2v
Content-Type: multipart/form-data

Field	Type	Required	Description
data	file	✅	Video file to process
prompt	string	✅*	Text prompt for editing
reference_image	file	✅*	Reference image to guide the edit
seed	number		Seed for reproducibility
resolution	string		"720p" (default, only option)
enhance_prompt	boolean		Enhance prompt with AI (default: true)

*At least one of prompt or reference_image must be provided. Both can be used together.

Model specs

• Resolution: 1280×720 (720p)
• FPS: 20
• Prompt + reference image: both allowed together (unlike lucy-restyle-v2v which is mutually exclusive)

---

Note

Low Risk
Primarily additive model-registry and input-schema changes with new tests/examples; low risk aside from potential validation/schema regressions in shared model typing.

Overview
Adds first-class SDK support for the new video queue model lucy-2-v2v, including model registry metadata (endpoints, 1280×720@20fps) and Zod runtime validation.

Updates TypeScript input docs/types so lucy-2-v2v accepts data plus at least one of prompt or reference_image (allowing both together), and extends unit + e2e test coverage for prompt-only, reference-only, and combined inputs.

Includes a new runnable video/video-editing.ts example and updates example/docs listings (examples/sdk-core/README.md, AGENTS.md).

^{Written by Cursor Bugbot for commit 19de56a. This will update automatically on new commits. Configure here.}

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@decartai/sdk@98

commit: 89bec74

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}