feat: canonical model names, lucy-2.1, and deprecation warnings (#45)

* feat: canonical model names, lucy-2.1, and deprecation warnings

Add canonical model names (lucy-2, lucy-clip, lucy-restyle-2, lucy-image-2,
live-avatar, etc.) to match the updated API naming convention. Add new models
lucy-2.1 (realtime + batch) and lucy-2.1-vton (realtime). Deprecated model
names still work but now emit a DeprecationWarning guiding users to migrate.

* fix: format models.py with black

* feat: add -latest model aliases for server-side resolution

Add lucy-latest, lucy-vton-latest, lucy-restyle-latest, lucy-clip-latest,
lucy-motion-latest, and lucy-image-latest convenience aliases that always
point to the current latest version of each model family. These are resolved
server-side, so the SDK passes them through with no deprecation warnings.

Author: AdirAmsalem

README.md

@@ -34,7 +34,7 @@ async def main():
     async with DecartClient(api_key=os.getenv("DECART_API_KEY")) as client:
         # Edit an image
         result = await client.process({
-            "model": models.image("lucy-pro-i2i"),
+            "model": models.image("lucy-image-2"),
             "prompt": "Apply a painterly oil-on-canvas look while preserving the composition",
             "data": open("input.png", "rb"),
         })
@@ -53,7 +53,7 @@ For video editing jobs, use the queue API to submit jobs and poll for results:
 async with DecartClient(api_key=os.getenv("DECART_API_KEY")) as client:
     # Submit and poll automatically
     result = await client.queue.submit_and_poll({
-        "model": models.video("lucy-pro-v2v"),
+        "model": models.video("lucy-clip"),
         "prompt": "Restyle this footage with anime shading and vibrant neon highlights",
         "data": open("input.mp4", "rb"),
         "on_status_change": lambda job: print(f"Status: {job.status}"),
@@ -72,7 +72,7 @@ Or manage the polling manually:
 async with DecartClient(api_key=os.getenv("DECART_API_KEY")) as client:
     # Submit the job
     job = await client.queue.submit({
-        "model": models.video("lucy-pro-v2v"),
+        "model": models.video("lucy-clip"),
         "prompt": "Add cinematic teal-and-orange grading and gentle film grain",
         "data": open("input.mp4", "rb"),
     })

decart/client.py

@@ -37,14 +37,14 @@ class DecartClient:
 
         # Image editing (sync) - use process()
         image = await client.process({
-            "model": models.image("lucy-pro-i2i"),
+            "model": models.image("lucy-image-2"),
             "prompt": "Apply a painterly oil-on-canvas look while preserving the composition",
             "data": open("input.png", "rb"),
         })
 
         # Video editing (async) - use queue
         result = await client.queue.submit_and_poll({
-            "model": models.video("lucy-pro-v2v"),
+            "model": models.video("lucy-clip"),
             "prompt": "Restyle this footage with anime shading and vibrant neon highlights",
             "data": open("input.mp4", "rb"),
         })
@@ -84,7 +84,7 @@ def queue(self) -> QueueClient:
             ```python
             # Submit and poll automatically
             result = await client.queue.submit_and_poll({
-                "model": models.video("lucy-pro-v2v"),
+                "model": models.video("lucy-clip"),
                 "prompt": "Restyle this footage with anime shading and vibrant neon highlights",
                 "data": open("input.mp4", "rb"),
             })