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

[AdirAmsalem]

Summary

Adds Python SDK support for the new lucy-2-v2v video-to-video editing model. Pairs with DecartAI/sdk#98 (JS SDK).

Usage

Video editing with a prompt

job = await client.queue.submit({
    "model": models.video("lucy-2-v2v"),
    "prompt": "Transform the scene into a cyberpunk city",
    "data": video_bytes,
})

With a reference image

job = await client.queue.submit({
    "model": models.video("lucy-2-v2v"),
    "prompt": "Apply this style to the video",
    "data": video_bytes,
    "reference_image": image_bytes,
    "enhance_prompt": True,
    "seed": 42,
})

With only a reference image (no prompt)

job = await client.queue.submit({
    "model": models.video("lucy-2-v2v"),
    "data": video_bytes,
    "reference_image": style_image,
})

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: 1280x720 (720p)
• FPS: 20
• Prompt + reference image: both allowed together