Skip to main content
With the Decart API, you can restyle entire videos using text prompts. Simply upload a video and describe the style you want to apply, and Lucy Restyle will transform your video while maintaining temporal consistency and motion throughout. Lucy Restyle excels at applying artistic styles, aesthetic transformations, and visual filters to videos of any length up to 10 minutes. Unlike other video models that are limited to short clips, Lucy Restyle supports long-form content, making it perfect for restyling full videos from start to finish in a single workflow.
Lucy Restyle supports videos up to 10 minutes in length, making it ideal for long-form content restyling.

​
Quick start

Here’s a simple example using Lucy Restyle, our long-form video restyling model. 
# Submit job
JOB_ID=$(curl -s -X POST https://api.decart.ai/v1/jobs/lucy-restyle-v2v \
  -H "X-API-KEY: $DECART_API_KEY" \
  -F "[email protected]" \
  -F "prompt=Transform to anime style with vibrant colors and cel shading" | jq -r '.job_id')

# Poll until completed
while true; do
  STATUS=$(curl -s -H "X-API-KEY: $DECART_API_KEY" \
    https://api.decart.ai/v1/jobs/$JOB_ID | jq -r '.status')
  echo "Status: $STATUS"
  [ "$STATUS" = "completed" ] && break
  [ "$STATUS" = "failed" ] && exit 1
  sleep 2
done

# Download result
curl -H "X-API-KEY: $DECART_API_KEY" \
  https://api.decart.ai/v1/jobs/$JOB_ID/content --output restyled-video.mp4

​
Parameters

  • data (required) — Input video file to restyle.
  • prompt (required) — Text description of the style to apply.
  • resolution (optional) — Output resolution: 720p (default: 720p).
  • seed (optional) — Random seed for reproducibility (0-4294967295).
  • enhance_prompt (optional) — Whether to enhance the prompt automatically (default: true).

​
Video Requirements

  • Format: MP4, WebM, or QuickTime
  • Duration: Up to 10 minutes
  • File Size: Maximum 100MB
  • Output Resolution:
    • 720p: 720×1280 (portrait) or 1280×720 (landscape)
For complete API documentation including response formats and error codes, see the API Reference.

​
What Makes Lucy Restyle Unique

Lucy Restyle is specifically designed for long-form video restyling. Unlike other video models that are limited to short clips (typically 5 seconds), Lucy Restyle can process videos up to 10 minutes in length while maintaining consistent style application and temporal coherence throughout. Key advantages:
  • Long-form support — Process entire videos, not just short clips
  • Temporal consistency — Maintains style coherence across the entire video duration
  • Motion preservation — Preserves original motion patterns while applying new styles
  • Prompt-controlled — Full control over the style transformation through text descriptions

​
Prompt Engineering for Video Restyling

Video restyling prompts should focus on visual style, aesthetic qualities, and artistic transformations rather than specific object changes. Your prompts describe how the video should look, not what should change. Effective restyling prompts are specific about style (artistic movements, visual aesthetics), descriptive about appearance (colors, textures, lighting), and clear about the transformation (what style to apply). Lucy Restyle interprets your style description and applies it consistently across all frames. Pro tip: Reference well-known artistic styles or visual aesthetics for best results. Include details about color palettes, textures, and lighting conditions.

​
Example Prompts

Artistic Styles:
  • “Transform to anime style with vibrant colors and cel shading”
  • “Apply impressionist painting style with soft brushstrokes and pastel colors”
  • “Convert to film noir aesthetic with high contrast black and white”
Visual Aesthetics:
  • “Apply warm sunset color grade with orange and pink tones throughout”
  • “Transform to cyberpunk style with neon lights and dark urban atmosphere”
  • “Convert to vintage 8mm film look with grain and color shifts”
Artistic Movements:
  • “Apply watercolor painting style with flowing colors and soft edges”
  • “Transform to pop art style with bold colors and high contrast”
  • “Convert to minimalist aesthetic with clean lines and muted colors”

​
Supported Style Types

​
✅ Best Performance

​
1. Artistic Style Transfer

Lucy Restyle excels at applying consistent artistic styles across entire videos.
  • Example: “Transform to anime style with vibrant colors and cel shading”
  • Example: “Apply impressionist painting style with soft brushstrokes”
  • Example: “Convert to watercolor painting aesthetic with flowing colors”

​
2. Visual Aesthetic Transformations

Strong results when applying specific visual aesthetics and color grading.
  • Example: “Apply warm sunset color grade with orange and pink tones”
  • Example: “Transform to cyberpunk style with neon lights and dark atmosphere”
  • Example: “Convert to vintage film look with grain and color shifts”

​
3. Lighting and Atmosphere

Reliable for changing lighting conditions and atmospheric effects.
  • Example: “Apply golden hour lighting with warm, soft illumination”
  • Example: “Transform to moody, dramatic lighting with high contrast shadows”
  • Example: “Convert to bright, airy aesthetic with soft diffused lighting”

​
⚠️ Considerations

​
4. Complex Scene Transformations

Works well but may require more specific prompts for complex scenes with multiple elements.
  • Tip: Be specific about which elements should be transformed and which should remain unchanged
  • Tip: Reference specific artistic movements or well-known visual styles for consistency

​
5. Temporal Consistency

The model maintains temporal consistency, but very rapid style changes may require multiple passes.
  • Tip: For best results, apply consistent styles throughout the video duration
  • Tip: Gradual style transitions work better than abrupt changes

​
Additional Optimization Tips

  • Style specificity: Reference well-known artistic movements or visual aesthetics for best results
  • Color descriptions: Include specific color palettes and tones in your prompts
  • Long-form advantage: Take advantage of the 10-minute limit for full video restyling
  • Consistent prompts: Use similar style descriptions for related videos to maintain brand consistency
Bottom line: Lucy Restyle performs best with detailed style descriptions that reference artistic movements, visual aesthetics, or specific color and lighting conditions. Focus on describing how the video should look rather than what should change.

​
Endpoint and Full API Reference

​
Next steps

Now that you know the basics of video restyling, you might want to check out one of these resources next.

Restyle a video in the Platform

Try out video restyling and other models in the interactive platform.

Full API reference

Check out all the options for video restyling in the API reference.

Video Editing

Learn how to edit videos with targeted changes using LucyEdit.