> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.decart.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Changelog
> Product updates and announcements for the Decart API Platform
## Lucy 2.5
* **Lucy 2.5** - New latest-generation video editing model (`lucy-2.5`) available on realtime and batch surfaces. `lucy-latest` now resolves to `lucy-2.5`. The previous `lucy-2.1` remains live for pinned integrations. Supports text prompts, reference images, or both. See the [Lucy 2.5 guide](/models/realtime/lucy-2.5)
## 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`](https://pypi.org/project/decart-oasis/) Python gRPC SDK. See the [Oasis 3 Preview guide](/models/realtime/oasis-3) and the [RL training notebook](https://colab.research.google.com/github/DecartAI/decart-robotics/blob/main/notebook/train_oasis3_ppo_colab.ipynb), or try it live at [oasis3-preview.decart.ai](https://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` remains live for pinned integrations. Available across [JavaScript](/sdks/javascript) (v0.1.5), [Python](/sdks/python) (v0.0.40), [Android](/sdks/android) (0.7.4), and [Swift](/sdks/swift) (v0.6.3) SDKs
* **Lucy 2.1 VTON retirement** - `lucy-2.1-vton` and its `lucy-vton` alias are no longer served. Use `lucy-vton-3`, `lucy-vton-latest`, or pin to `lucy-vton-2` if you need the previous generation
* **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](/sdks/javascript-realtime#connection-quality) (v0.1.6), [Android](/sdks/android-realtime#connection-quality) (0.7.5), and [Swift](/sdks/swift-realtime#connection-quality) (v0.6.4)
* **Python realtime SDK moved to LiveKit** - The [Python](/sdks/python-realtime) 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](/sdks/javascript-realtime) (v0.0.68), [Python](/sdks/python-realtime) (v0.0.39), [Android](/sdks/android-realtime) (0.6.1), and [Swift](/sdks/swift-realtime) (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](/sdks/android-realtime#front-camera-mirroring) (0.6.0) and [Swift](/sdks/swift-realtime#front-camera-mirroring) (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`
* **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](/sdks/javascript) SDK (v0.0.63) and the [Python](/sdks/python) SDK (v0.0.37). See [Client Tokens → Origin scoping](/getting-started/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](/sdks/javascript-realtime) (v0.1.0) and [Android](/sdks/android-realtime) (0.7.0) SDKs moved to a LiveKit-managed WebRTC session for better reliability and to power LiveKit-based session subscribe; [Swift](/sdks/swift-realtime) 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](/sdks/javascript-realtime) (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](/sdks/javascript), [Python](/sdks/python), [Android](/sdks/android), and [Swift](/sdks/swift) SDKs
* **Virtual Try-On** - Launched [`lucy-2.1-vton`](/models/realtime/virtual-try-on) 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](/resources/api-terms) and [Data Processing Addendum](/resources/dpa)
* **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](/getting-started/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](/sdks/android) with realtime ([`android-realtime`](/sdks/android-realtime)) and batch ([`android-queue`](/sdks/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](/sdks/javascript-realtime#session-viewing-subscribe)
* **Unified `set()` method** - Atomically replace session state (prompt and reference image) in a single call across [JavaScript](/sdks/javascript-realtime#unified-state-update) and [Python](/sdks/python-realtime#unified-state-update) 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](/sdks/javascript) 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](/getting-started/client-tokens) 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](https://aws.amazon.com/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](/sdks/python) documentation
* Added [Swift SDK](/sdks/swift) 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