Changelog

​

Origin-Scoped Client Tokens & Model Retirements

• Origin-scoped client tokens - New allowedOrigins option on client.tokens.create() pins a client token to a list of canonical web origins; mismatched browser-issued Origin headers are rejected at the realtime gateway. Available in the JavaScript SDK (v0.0.63) and the Python SDK (v0.0.37). See Client Tokens → Origin scoping
• Model retirements - LipSync Live, Live Avatar, Lucy Motion, Lucy v1 Realtime, and Lucy Restyle v1 Realtime are no longer served by the API. Their docs pages now redirect to the relevant category overviews and the SDKs no longer surface their model IDs. Migrate to lucy-2.1 (realtime + batch editing) or lucy-restyle-2 (realtime + batch restyling)
• Custom models in the Python SDK - The Python SDK now accepts an inline ModelDefinition for preview, experimental, or private models that aren’t in the built-in registry — matching the JavaScript SDK’s CustomModelDefinition

​

Lucy 2.1, Virtual Try-On & Team Accounts

• Lucy 2.1 - New flagship realtime and batch video editing model (lucy-2.1). Available across JavaScript, Python, Android, and Swift SDKs
• Virtual Try-On - Launched lucy-2.1-vton for realtime and batch virtual try-on, with a new e-commerce integration guide
• Canonical SDK model names - Unified model naming across all SDKs (e.g. lucy-2.1, lucy-image-2, lucy-restyle-2, lucy-clip, live-avatar) with deprecation warnings for legacy names
• -latest aliases - Use lucy-latest, lucy-vton-latest, lucy-restyle-latest, lucy-clip-latest, lucy-motion-latest, or lucy-image-latest to automatically target the newest model version without code changes
• Reference images for image editing - Added reference_image (file or URL) support to lucy-image-2 for image-to-image editing
• Team accounts - Create organizations with shared credits and billing, invite members by email, manage roles and ownership transfer, and scope API keys to an organization
• Auto top-up credits - Save a Stripe payment method and automatically refill credits when your balance drops below a threshold (now also available for organizations)
• Billing portal & receipts - Manage payment methods and invoices through a hosted Stripe portal, and download receipts directly from a redesigned transaction history
• API Terms of Service & DPA - Published formal API Terms of Service and Data Processing Addendum
• Realtime Playground - Added a mobile version selector and improved auto-sent image handling

​

Client Tokens v2, Android SDK & Model Simplification

• Client tokens v2 - Client tokens now support configurable TTL, model scoping, and per-session constraints for finer-grained client-side access control
• Android SDK - Published the Decart Android SDK with realtime (android-realtime) and batch (android-queue) APIs, upload progress callbacks, and Android code snippets across the Lucy 2 docs
• LipSync Live pricing and guides - Added full pricing and a complete guide for realtime lip syncing
• Simpler model names - Renamed models across docs and the platform with consistent naming, and separated flagship from legacy models in the sidebar
• Lucy Edit consolidation - Unified Lucy Edit v1 and v2 into a single docs page with a version selector
• Mirage → Lucy Restyle Live - Renamed Mirage to Lucy Restyle Live across docs, the platform, and all SDKs

​

Realtime SDK Overhaul & Lucy 2

• Lucy 2 Realtime - Launched Lucy 2 (lucy-2), a new realtime video-to-video model with character reference image support
• Session viewing - Other clients can now watch an active realtime session as read-only viewers using a subscribe token
• Unified set() method - Atomically replace session state (prompt and reference image) in a single call across JavaScript and Python SDKs
• Auto-reconnect - Realtime SDKs now automatically reconnect with exponential backoff when connections drop
• generationTick event - Track session duration and billing with a new periodic event during generation
• New connection states - Added "generating" and "reconnecting" states for better lifecycle visibility

​

Lucy 2 RT Preview, Reference Images & Avatar Live

• Lucy 2 RT (Preview) - Early access to Lucy 2 realtime at 720p@20FPS
• Reference images - Added reference image support for Lucy Restyle Live, Lucy Restyle, Lucy Pro, and Lucy Edit models in realtime
• Avatar Live - New model for audio-driven avatar animation with MP3 support
• Server proxy - New server proxy integration and Next.js proxy adapter for backend-to-backend SDK usage
• React Native support - JavaScript SDK now supports file uploads from React Native
• Python 3.10+ - Python SDK now requires Python 3.10 or later

​

Lucy Restyle & Client Tokens

• Lucy Restyle - New video restyling model (lucy-restyle-2) for transforming video aesthetics with up to 30-minute input
• Client tokens - New client tokens API for secure short-lived token creation in client-side apps
  • Unified generate endpoint - All model generation consolidated into a single API route
  • Image cropping - Crop uploaded images before processing in the Studio
  • Reduced image pricing - Lower pricing for image generation models

​

Queue API & AWS Marketplace

​

New Features

• Queue-based API - Introduced queue API pattern for video generation, enabling better handling of long-running jobs
• AWS Marketplace - Decart API Platform is now available on AWS Marketplace with integrated billing
• Showcase page - Added a new showcase page highlighting community creations and use cases
• Lucy Fast - Added Lucy Edit Fast model for quicker video-to-video transformations

​

API & SDK Updates

• Updated model routes and code examples for job submission workflow
• Improved error messages when content violates Terms of Service
• Updated video pricing for 720p resolution

​

Platform Improvements

• Enhanced billing page with AWS Marketplace support
• Improved credits reserve and deduction logic
• Better video expand functionality in the video player

​

Lip Syncing, Motion & Platform Redesign

​

New Features

• Lip Syncing - Added realtime lip-syncing capabilities to sync audio with video
• Lucy Motion - Introduced Lucy Motion model for object animation and movement
• Lucy Restyle Live v2 - Upgraded to Lucy Restyle Live v2 as the default realtime model with improved quality
• Video recording - Added ability to record sessions directly in the Realtime Playground

​

Platform Redesign

• Launched redesigned homepage with improved navigation
• New model page in Studio with better organization
• Redesigned sign-in page and authentication flow
• Mobile-optimized Realtime Playground experience
• Renamed “Studio” to “Models” for clarity

​

SDK & Documentation

• Released Python SDK documentation
• Added Swift SDK for iOS development
• Added comprehensive lip-syncing documentation
• Upgraded to Next.js 16 for improved performance

​

Developer Experience

• Idle detection with warning dialog in Realtime Playground
• Improved ephemeral API key handling
• Added preset functionality for quick model configuration
• GDPR-compliant analytics with consent management