Changelog

​

Oasis 3 Preview, Realtime Quality & Python LiveKit

• Oasis 3 Preview - New realtime, promptable world model (oasis-3-preview): set a scene with a text prompt, stream driving actions (throttle + steering), and receive generated camera frames in realtime — a learned driving simulator you can run reinforcement learning in. Available via the dedicated decart-oasis Python gRPC SDK. See the Oasis 3 Preview guide and the RL training notebook, or try it live at oasis3-preview.decart.ai
• Lucy VTON 3 - New latest-generation virtual try-on model (lucy-vton-3) available on realtime and batch surfaces. lucy-vton-latest now resolves to lucy-vton-3. The previous lucy-vton-2 and lucy-2.1-vton remain live for pinned integrations. Available across JavaScript (v0.1.5), Python (v0.0.40), Android (0.7.4), and Swift (v0.6.3) SDKs
• Connection quality, preflight & glass-to-glass latency - Realtime SDKs now report network health on a shared good | fair | poor | critical scale. Run a preflight before connecting (checkConnectivity()) to gate the integration, react to in-session quality (onConnectionQuality) with the limiting factor (bandwidth, latency, loss, stall, cpu), or opt in to glass-to-glass latency (debugQuality: true) to measure real camera→display latency end-to-end. Available in JavaScript (v0.1.6), Android (0.7.5), and Swift (v0.6.4)
• Python realtime SDK moved to LiveKit - The Python realtime SDK (v0.1.0) completes the LiveKit migration after JavaScript, Android, and Swift. Input is now a caller-supplied livekit.rtc.LocalVideoTrack, on_remote_stream receives a livekit.rtc.RemoteVideoTrack, and a new preferred_video_codec option picks between h264 (default) and vp9. Install with pip install decart[realtime]

​

1080p Realtime & Mobile Mirroring

• 1080p realtime streams - New resolution option on realtime.connect() lets supported models deliver 1080p output. Available across JavaScript (v0.0.68), Python (v0.0.39), Android (0.6.1), and Swift (v0.6.1) SDKs. Defaults to 720p when omitted
• Front-camera mirroring on iOS & Android - New mirror option pre-flips selfie input so server-baked pixels (watermarks, overlays) render correctly without re-flipping on the receiving end. Now available on Android (0.6.0) and Swift (v0.6.0), in addition to JavaScript
• Lucy VTON 2 - New next-generation virtual try-on model (lucy-vton-2) available on realtime and batch surfaces. lucy-vton-latest now resolves to lucy-vton-2; the previous lucy-2.1-vton remains live
• 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
• Realtime SDKs now LiveKit-backed - The realtime media transport in the JavaScript (v0.1.0) and Android (0.7.0) SDKs moved to a LiveKit-managed WebRTC session for better reliability and to power LiveKit-based session subscribe; Swift followed in v0.6.2 in early June. The connect() interface is unchanged, but Android’s setPrompt is now a suspend function — callers must invoke it from a coroutine and handle thrown ack failures
• Files API for realtime reference images - The JavaScript SDK (v0.1.1) lets you upload a reference image once via client.files.upload(...) and pass the resulting file_… id by reference to connect() / set() / setImage(), instead of re-encoding the asset on every call
• Enterprise SSO for organizations - Organizations can now sign in via their corporate identity provider (Okta, Entra, Google Workspace, or any OIDC IdP). Org owners and admins self-serve provider registration and DNS TXT domain verification from organization settings; new SSO sign-ins are JIT-provisioned into the organization as members

​

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