@sogni-ai/sogni-client 4.0.0-alpha.8 → 4.0.0

package/CHANGELOG.md

@@ -1,3 +1,278 @@
+# [4.0.0-alpha.44](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.43...v4.0.0-alpha.44) (2026-01-08)
+
+
+### Bug Fixes
+
+* videoStart release ([d9dd123](https://github.com/Sogni-AI/sogni-client/commit/d9dd1234c75e5166a94ef2aa7a705f6679c3d3ec))
+
+# [4.0.0-alpha.43](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.42...v4.0.0-alpha.43) (2026-01-07)
+
+
+### Bug Fixes
+
+* very long running video progress jobs aborting prematurely ([8860ae8](https://github.com/Sogni-AI/sogni-client/commit/8860ae87bfb8104a64585c3107f6d4da1c3b4615))
+
+# [4.0.0-alpha.42](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.41...v4.0.0-alpha.42) (2026-01-07)
+
+
+### Bug Fixes
+
+* fix for passing video s2v audioStart and audioDuration. Fix for broken animate-replace in examples due to default sam2 coordinates ([7b525cd](https://github.com/Sogni-AI/sogni-client/commit/7b525cd50d60ec8b3884db80ee39dca25e1aca97))
+
+# [4.0.0-alpha.41](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.40...v4.0.0-alpha.41) (2026-01-06)
+
+
+### Features
+
+* example script workflow enhancements ([94d14e4](https://github.com/Sogni-AI/sogni-client/commit/94d14e42a121976b1090fe797734f2f76e57da02))
+
+# [4.0.0-alpha.40](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.39...v4.0.0-alpha.40) (2026-01-06)
+
+
+### Bug Fixes
+
+* res_multistep support in SupportedComfySamplers to fix support for z-image. /examples script enhancements ([332e7b1](https://github.com/Sogni-AI/sogni-client/commit/332e7b1280272e05c7d897de22edea61482f5b7c))
+
+# [4.0.0-alpha.39](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.38...v4.0.0-alpha.39) (2026-01-05)
+
+
+### Bug Fixes
+
+* Add ForgeSampler, ComfySampler, ForgeScheduler, and ComfyScheduler to exports ([ad24b32](https://github.com/Sogni-AI/sogni-client/commit/ad24b326904f7ad67f43c34a0b758ce64e84a8f1))
+
+# [4.0.0-alpha.38](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.37...v4.0.0-alpha.38) (2026-01-05)
+
+
+### Features
+
+* Support Qwen, Z Image and Flux 2 models ([fd3acb7](https://github.com/Sogni-AI/sogni-client/commit/fd3acb7bdce5d7c81750e58fb79d14cf4f5f0b2f))
+
+
+### BREAKING CHANGES
+
+* `SupportedSamplers` and `SupportedSchedulers` removed
+`SupportedSamplers` and `SupportedSchedulers` are replaced with `SupportedComfySchedulers`, `SupportedComfySamplers`, `SupportedForgeSchedulers`, `SupportedForgeSamplers`
+
+* fix: Prettier formatting
+
+# [4.0.0-alpha.37](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.36...v4.0.0-alpha.37) (2026-01-05)
+
+
+### Bug Fixes
+
+* Replace frames with duration in project cost estimation ([b6c576e](https://github.com/Sogni-AI/sogni-client/commit/b6c576e70b66d2604441e1bd8e013fa435c0c099))
+
+# [4.0.0-alpha.36](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.35...v4.0.0-alpha.36) (2026-01-05)
+
+
+### Features
+
+* Add support for video duration options with validation and deprecate frames property ([fa11d79](https://github.com/Sogni-AI/sogni-client/commit/fa11d7905ef249a2e75a6d96c8a2bedda24005df))
+
+# [4.0.0-alpha.35](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.34...v4.0.0-alpha.35) (2025-12-31)
+
+
+### Bug Fixes
+
+* allow i2v workflow to use either referenceImage or referenceImageEnd ([b9f08ef](https://github.com/Sogni-AI/sogni-client/commit/b9f08efa91e92f58280b923c5815c9b6645c5452))
+
+# [4.0.0-alpha.34](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.33...v4.0.0-alpha.34) (2025-12-30)
+
+
+### Features
+
+* Add VideoProjectParams optional teacacheThreshold support ([7a68d4c](https://github.com/Sogni-AI/sogni-client/commit/7a68d4ccc8db8fa1ed410452321468d434927bd1))
+
+# [4.0.0-alpha.33](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.32...v4.0.0-alpha.33) (2025-12-19)
+
+
+### Bug Fixes
+
+* Add numberOfMedia parameter to video project estimation request ([b762e61](https://github.com/Sogni-AI/sogni-client/commit/b762e6130c94a1aa192047c9b14f54dc1acb0191))
+
+# [4.0.0-alpha.32](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.31...v4.0.0-alpha.32) (2025-12-18)
+
+
+### Bug Fixes
+
+* Prevent potential memory leak in Project.waitForCompletion ([010a1de](https://github.com/Sogni-AI/sogni-client/commit/010a1decd1f5168275c34f95ccdb7ca8092ac3e5))
+
+# [4.0.0-alpha.31](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.30...v4.0.0-alpha.31) (2025-12-17)
+
+
+### Features
+
+* Add project and job ETA properties ([66024cc](https://github.com/Sogni-AI/sogni-client/commit/66024cc26dac51bbd45dc5b4d7e68c5963f8c178))
+
+# [4.0.0-alpha.30](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.29...v4.0.0-alpha.30) (2025-12-17)
+
+
+### Features
+
+* Add video project cost estimation ([33c7533](https://github.com/Sogni-AI/sogni-client/commit/33c7533b90bfe7c23c465b38867d184b00561112))
+
+# [4.0.0-alpha.29](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.28...v4.0.0-alpha.29) (2025-12-16)
+
+
+### Bug Fixes
+
+* wan sample scripts for s2v and animate should all support custom prompts ([5a2dbf9](https://github.com/Sogni-AI/sogni-client/commit/5a2dbf963c8ff411dece0dec87b52117a0baea23))
+
+# [4.0.0-alpha.28](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2025-12-15)
+
+
+### Features
+
+* Expose array of projects that SogniClient instance is tracking currently ([38b6c0e](https://github.com/Sogni-AI/sogni-client/commit/38b6c0ec7ab3e6f621e42f9e512ede98f4b3a9da))
+
+# [4.0.0-alpha.27](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.26...v4.0.0-alpha.27) (2025-12-12)
+
+
+### Features
+
+* Add ability to query balance for Etherlink wallet ([60ef11b](https://github.com/Sogni-AI/sogni-client/commit/60ef11beec443837a044e24c11014bef8f804275))
+
+# [4.0.0-alpha.26](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.25...v4.0.0-alpha.26) (2025-12-12)
+
+
+### Bug Fixes
+
+* Comfy / Video jobs leverage jobETA for lastUpdate to ensure jobs do not have a client-side timeout prematurely ([db5e2a6](https://github.com/Sogni-AI/sogni-client/commit/db5e2a62256ccb0f704a50fdf7e1e0556e2aecaa))
+
+
+### Features
+
+* ensure video model passed with and height are at least 480 ([d0156aa](https://github.com/Sogni-AI/sogni-client/commit/d0156aa84785f98c60ee09e7c733e62940eb0b9e))
+
+# [4.0.0-alpha.25](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.24...v4.0.0-alpha.25) (2025-12-11)
+
+
+### Bug Fixes
+
+* Add sample parameters for Flux ([8e25924](https://github.com/Sogni-AI/sogni-client/commit/8e25924476a1faf1ac432a6490b4d52ac0cf4898))
+
+# [4.0.0-alpha.24](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.23...v4.0.0-alpha.24) (2025-12-11)
+
+
+### Features
+
+* final round of doc / example enhancements with new steps support for Wan video models ([95d5dfb](https://github.com/Sogni-AI/sogni-client/commit/95d5dfb61d5ed2878c04cd6cf7a0d75d9d0754e1))
+
+# [4.0.0-alpha.23](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.22...v4.0.0-alpha.23) (2025-12-10)
+
+
+### Features
+
+* Add credential management system for video examples ([e7fc1ab](https://github.com/Sogni-AI/sogni-client/commit/e7fc1abf85d32995c64c48a5f861cb3f99a4793b))
+* Enhance video example scripts with improved UX ([6a70c26](https://github.com/Sogni-AI/sogni-client/commit/6a70c26e2b30b5be7bcae88171bbd3956bbe91af))
+
+# [4.0.0-alpha.22](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.21...v4.0.0-alpha.22) (2025-12-10)
+
+
+### Features
+
+* Video support added with Wan 2.2 14B FP8 models supporting five workflows: text-to-video (t2v), image-to-video (i2v), sound-to-video (s2v), animate-move, and animate-replace ([e00e1e7](https://github.com/Sogni-AI/sogni-client/commit/e00e1e7879962047a6950013d53aa83748a66021))
+
+
+### BREAKING CHANGES
+
+* Project creation parameters changed
+- `type` is required when calling `sogni.projects.create(params)`, valid values are `image` and `video`. See code examples below.
+- `numberOfImages` renamed to `numberOfMedia`
+- `hasResultImage` in `Job` class is now `hasResultMedia`
+- `Job` and `Project` classes now have `type` property  that can be `image` or `video`
+
+# [4.0.0-alpha.21](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.20...v4.0.0-alpha.21) (2025-12-04)
+
+
+### Bug Fixes
+
+* Fix TypeScript error ([30ff62a](https://github.com/Sogni-AI/sogni-client/commit/30ff62ad5ccb3624bf8a26b70f65b4c0daa9c6ff))
+
+# [4.0.0-alpha.20](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.19...v4.0.0-alpha.20) (2025-12-04)
+
+
+### Bug Fixes
+
+* Better socket coordinator implementation. Handle socket disconnection properly ([2a1a922](https://github.com/Sogni-AI/sogni-client/commit/2a1a922a0dd41446c1dcf6ffeaccfe54556af5bb))
+
+# [4.0.0-alpha.19](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.18...v4.0.0-alpha.19) (2025-12-03)
+
+
+### Bug Fixes
+
+* Connect socket if client tries to send the message ([b5fa7bc](https://github.com/Sogni-AI/sogni-client/commit/b5fa7bc9599f30ff575521e76d76d42f031769fc))
+
+# [4.0.0-alpha.18](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.17...v4.0.0-alpha.18) (2025-12-02)
+
+
+### Bug Fixes
+
+* Pass error iin message ack ([7b73d87](https://github.com/Sogni-AI/sogni-client/commit/7b73d87fdd27634b75fe5aa0bbba43415d6e7dce))
+
+# [4.0.0-alpha.17](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.16...v4.0.0-alpha.17) (2025-12-02)
+
+
+### Bug Fixes
+
+* Initialization bug ([42b4e26](https://github.com/Sogni-AI/sogni-client/commit/42b4e26dad8f634eb6c17d172081d6c3d03a3d41))
+
+# [4.0.0-alpha.16](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.15...v4.0.0-alpha.16) (2025-12-02)
+
+
+### Bug Fixes
+
+* Make shared socket connection optional ([7ee2311](https://github.com/Sogni-AI/sogni-client/commit/7ee2311354071bbcc3087cad0a8c321cea28cd25))
+
+# [4.0.0-alpha.15](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.14...v4.0.0-alpha.15) (2025-12-02)
+
+
+### Bug Fixes
+
+* Avoid double initialization for WSCoordinator.ts ([1b7e973](https://github.com/Sogni-AI/sogni-client/commit/1b7e973cebd6b35667fa248656127b60125dd4f9))
+
+# [4.0.0-alpha.14](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.13...v4.0.0-alpha.14) (2025-12-01)
+
+
+### Bug Fixes
+
+* Move type definitions to dependencies from devDependencies ([95b5201](https://github.com/Sogni-AI/sogni-client/commit/95b520191593913bd0b74cd8cf41241eac16dd8e))
+
+# [4.0.0-alpha.13](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.12...v4.0.0-alpha.13) (2025-12-01)
+
+
+### Features
+
+* When using cookies auth in browser environment allow sharing one socket connection between multiple tabs ([794d6e1](https://github.com/Sogni-AI/sogni-client/commit/794d6e18d960c8758094f09b2bc516b8b08175d0))
+
+# [4.0.0-alpha.12](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.11...v4.0.0-alpha.12) (2025-10-30)
+
+
+### Features
+
+* Expose project cost in both Spark Points and Sogni tokens when estimating ([9d5f556](https://github.com/Sogni-AI/sogni-client/commit/9d5f556154013ae15e49e93e9941533e730502c5))
+
+# [4.0.0-alpha.11](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.10...v4.0.0-alpha.11) (2025-10-23)
+
+
+### Bug Fixes
+
+* Accept raw samplers and schedulers for backward compatibility ([8c04552](https://github.com/Sogni-AI/sogni-client/commit/8c04552667fe054e9a330a3aab8fd776060a0ed6))
+
+# [4.0.0-alpha.10](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.9...v4.0.0-alpha.10) (2025-10-21)
+
+
+### Bug Fixes
+
+* Fix project estimation. Export supported samplers and schedulers list ([502d4d1](https://github.com/Sogni-AI/sogni-client/commit/502d4d19529883b5272466a122720f2c6fd01e2e))
+
+# [4.0.0-alpha.9](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.8...v4.0.0-alpha.9) (2025-10-17)
+
+
+### Bug Fixes
+
+* Hide samplers that are not well tested ([0522bed](https://github.com/Sogni-AI/sogni-client/commit/0522bed6cfad5f8bc9c37d65c30b63b31aa0168a))
+
 # [4.0.0-alpha.8](https://github.com/Sogni-AI/sogni-client/compare/v4.0.0-alpha.7...v4.0.0-alpha.8) (2025-10-17)
 
 

package/README.md

@@ -1,8 +1,28 @@
 # Sogni SDK for JavaScript & Node.js
-This library provides an easy way to interact with the [Sogni AI Supernet](https://www.sogni.ai/supernet) - a DePIN protocol for creative AI. It is written in TypeScript and can be used 
+This library provides an easy way to interact with the [Sogni Supernet](https://www.sogni.ai/supernet) - a DePIN protocol for creative AI inference. It is written in TypeScript and can be used
 in both TypeScript and JavaScript projects such as backend Node.js and browser environments.
 
-Behind the scenes this SDK uses WebSocket connection for communication between clients, server, and workers. It harnesses an event-based API to interact with Supernet to make things super efficient.
+Behind the scenes this SDK uses a WebSocket connection for communication between clients, server, and workers. It harnesses an event-based API to interact with Supernet to make things super efficient.
+
+## Features
+- 🎨 **Image Generation** - Create images with the latest frontier Open Source models like Stable Diffusion, Z-Image Turbo, and Flux
+- 🎨 **Image Edit** - Modify, merge, restyle, and transform images using prompts and/or multiple reference images using powerful models like Qwen Image Edit.
+- 🎬 **Video Generation** - Generate videos using **Wan 2.2 14B FP8** models with five workflow types:
+  - Text-to-Video (t2v) - Generate videos from text prompts
+  - Image-to-Video (i2v) - Animate static images
+  - Sound-to-Video (s2v) - Generate videos synchronized with audio
+  - Animate-Move - Transfer motion from reference video to image subject
+  - Animate-Replace - Replace subjects in videos while preserving motion
+- ⚡ **Fast & Relaxed Networks** - Choose between high-speed GPU network or cost-effective Mac network
+- 🔄 **Real-time Progress** - Event-based API with progress tracking and live updates
+- 🎯 **Advanced Controls** - Fine-tune generation with samplers, schedulers, ControlNets, and more
+## Migration notes
+### v3.x.x to v4.x.x
+Version 4 adds support for video generation, including the new **Wan 2.2 14B FP8** model family with five workflow types (text-to-video, image-to-video, sound-to-video, animate-move, and animate-replace). There are the following breaking changes:
+- `type` is required when calling `sogni.projects.create(params)`, valid values are `image` and `video`. See code examples below.
+- `numberOfImages` renamed to `numberOfMedia`
+- `hasResultImage` in `Job` class is now `hasResultMedia`
+- `Job` and `Project` classes now have `type` property that can be `image` or `video`
 
 ## Installation
 Add library to your project using npm or yarn:
@@ -23,17 +43,17 @@ Your account is tied to a [Base](https://www.base.org/) Wallet that is created d
 
 ### Supernet Types
 There are 2 worker network types available:
-- `fast` - this network runs on high-end GPUs and is optimized for speed. It is more expensive than `relaxed` network.
-- `relaxed` - this network runs on Apple Mac devices and is optimized for cost. It is cheaper than `fast` network.
+- `fast` - this network runs on high-end GPUs and is optimized for speed. It is more expensive than `relaxed` network. **Required for video generation**.
+- `relaxed` - this network runs on Apple Mac devices and is optimized for cost. It is cheaper than `fast` network. Supports image generation only.
 
 In both options, the more complex your query is (the more steps), the higher the cost in tokens.
 
 ### Inference definitions: Projects and Jobs
-One request for image generation is called a **Project**. Project can generate one or more images. 
-Each image is represented by a **Job**.
+One request for image or video generation is called a **Project**. A project can generate one or more images or videos.
+Each generated image or video is represented by a **Job**.
 
-When you send a project to Supernet, it will be processed by one or more workers. The resulting images will be encrypted and 
-uploaded to Sogni servers where it will be stored for 24 hours. After this period images will be auto-deleted.
+When you send a project to Supernet, it will be processed by one or more workers. The resulting media will be encrypted and
+uploaded to Sogni servers where it will be stored for 24 hours. After this period, media files will be auto-deleted.
 
 ## Client initialization
 To initialize a client, you need to provide `appId`, and account credentials.
@@ -49,13 +69,13 @@ const options = {
   network: 'fast', // Network to use, 'fast' or 'relaxed'
 }
 
-const client = await SogniClient.createInstance(options);
+const sogni = await SogniClient.createInstance(options);
 // Login to Sogni account and establish WebSocket connection to Supernet
-await client.account.login(USERNAME, PASSWORD);
+await sogni.account.login(USERNAME, PASSWORD);
 // Now wait until list of available models is received.
 // This step is only needed if you want to create project immediately.
-const models = await client.projects.waitForModels();
-// You can get list of available models any time from `client.projects.availableModels`
+const models = await sogni.projects.waitForModels();
+// You can get list of available models any time from `sogni.projects.availableModels`
 ```
 **Important Note:** 
 - This sample assume you are using ES modules, which allow `await` on the top level, if you are CommomJS you will need to wrap `await` calls in an async function.
@@ -64,16 +84,44 @@ const models = await client.projects.waitForModels();
 
 ## Usage
 After calling `login` method, the client will establish a WebSocket connection to Sogni Supernet. Within a short period of time the
-client will receive the current balance and list of available models. After this you can start using the client to generate images.
+client will receive the current balance and list of available models. After this you can start using the client to generate images or videos.
 
-### Creating project
+It is advised to watch for `connected` and `disconnected` events on the client instance to be notified when the connection is established or lost:
+```typescript
+// Will be triggered when the client is connected to Supernet
+sogni.client.on('connected', ({network}) => {
+  console.log('Connected to Supernet:', network);
+});
+
+// Will be triggered when websocket connection is lost or the client is disconnected from Supernet
+sogni.client.on('disconnected', ({code, reason}) => {
+  console.log('Disconnected from Supernet:', code, reason);
+});
+```
+
+## Image Generation
+
+Sogni supports a wide range of models for image generation. You can find a list of available models in 
+`sogni.projects.availableModels` property during runtime or query it using `sogni.projects.getAvailableModels()` method.
+
+For a start, you can try FLUX.1 \[schnell\] with the following parameters:
+```javascript
+const fluxDefaults = {
+  modelId: 'flux1-schnell-fp8',
+  steps: 4,
+  guidance: 1
+}
+```
+
+### Creating an image project
 ```javascript
 // Find model that has the most workers
-const mostPopularModel = client.projects.availableModels.reduce((a, b) =>
+const mostPopularModel = sogni.projects.availableModels.reduce((a, b) =>
   a.workerCount > b.workerCount ? a : b
 );
 // Create a project using the most popular model
-const project = await client.projects.create({
+const project = await sogni.projects.create({
+  type: 'image',
   modelId: mostPopularModel.id,
   positivePrompt: 'A cat wearing a hat',
   negativePrompt:
@@ -81,7 +129,7 @@ const project = await client.projects.create({
   stylePrompt: 'anime',
   steps: 20, 
   guidance: 7.5, 
-  numberOfImages: 1,
+  numberOfMedia: 1,
   outputFormat: 'jpg' // Can be 'png' or 'jpg', defaults to 'png'
 });
 ```
@@ -94,7 +142,8 @@ In general, there are 2 ways to work with API:
 
 #### Using promises
 ```javascript
-const project = await client.projects.create({
+const project = await sogni.projects.create({
+  type: 'image',
   modelId: mostPopularModel.id,
   steps: 20,
   guidance: 7.5,
@@ -102,7 +151,7 @@ const project = await client.projects.create({
   negativePrompt:
     'malformation, bad anatomy, bad hands, missing fingers, cropped, low quality, bad quality, jpeg artifacts, watermark',
   stylePrompt: 'anime',
-  numberOfImages: 4
+  numberOfMedia: 4
 });
 
 project.on('progress', (progress) => {
@@ -117,7 +166,8 @@ console.log('Image URLs:', imageUrls);
 
 #### Using events
 ```javascript
-const project = await client.projects.create({
+const project = await sogni.projects.create({
+  type: 'image',
   modelId: mostPopularModel.id,
   steps: 20,
   guidance: 7.5,
@@ -125,7 +175,7 @@ const project = await client.projects.create({
   negativePrompt:
     'malformation, bad anatomy, bad hands, missing fingers, cropped, low quality, bad quality, jpeg artifacts, watermark',
   stylePrompt: 'anime',
-  numberOfImages: 4
+  numberOfMedia: 4
 });
 
 // Fired when one of project jobs completed, you can get the resultUrl from the job
@@ -192,9 +242,9 @@ Turbo and LCM models are designed for quality output in as little as 1 step. ([M
 TypeScript type definitions for project parameters can be found in [ProjectParams](https://sdk-docs.sogni.ai/interfaces/ProjectParams.html) docs.
 
 ### Detecting available output presets
-You can get a list of available output presets for a specific network and model using `client.projects.getOutputPresets` method.
+You can get a list of available output presets for a specific network and model using `sogni.projects.getOutputPresets` method.
 ```javascript
-const presets = await client.projects.getSizePresets('fast', 'flux1-schnell-fp8');
+const presets = await sogni.projects.getSizePresets('fast', 'flux1-schnell-fp8');
 console.log('Available output presets:', presets);
 ```
 Sample response:
@@ -290,17 +340,14 @@ Available sampler options:
 
 | Option          | Description                         |
 |-----------------|-------------------------------------|
-| `dfs_sd3`       | Discrete Flow Scheduler (SD3)       |
+| `dfs_sd3`       | Discrete Flow Sampler (SD3)         |
 | `dpm_pp`        | DPM Solver Multistep (DPM-Solver++) |
 | `dpm_pp_sde`    | DPM++ SDE                           |
 | `dpm_pp_2m`     | DPM++ 2M                            |
-| `dpm_pp_2m_sde` | DPM++ 2M SDE                        |
 | `euler`         | Euler                               |
 | `euler_a`       | Euler a                             |
-| `heun`          | Heun                                |
 | `lcm`           | LCM (Latent Consistency Model)      |
 | `pndm_plms`     | PNDM (Pseudo-linear multi-step)     |
-| `uni_pc`        | UniPC                               |
 
 **IMPORTANT:** Sampler compatibility depends on model and network. See [Samplers and Schedulers](https://docs.sogni.ai/sogni-studio/advanced/samplers-and-schedulers) docs for more info.
 
@@ -356,10 +403,11 @@ To use ControlNet in your project, you need to provide `controlNet` object with
 Example:
 ```javascript
 const cnImage = fs.readFileSync('./cn.jpg');
-const project = await client.projects.create({
+const project = await sogni.projects.create({
+  type: 'image',
   network: 'fast',
   modelId: 'coreml-cyberrealistic_v70_768',
-  numberOfImages: 1,
+  numberOfMedia: 1,
   positivePrompt: 'make men look older',
   steps: 20,
   guidance: 7.5,
@@ -400,5 +448,189 @@ export interface ControlNetParams {
 ```
 
 
-## Code examples
-You can find more code examples in the [examples](https://github.com/Sogni-AI/sogni-client/tree/main/examples) directory.
+## Video Generation with Wan 2.2 Models
+
+The Sogni SDK supports advanced video generation workflows powered by **Wan 2.2 14B FP8** models. These models are available on the `fast` network and support various video generation workflows.
+
+### Available Wan 2.2 Workflows
+
+The Wan 2.2 model family supports five distinct video generation workflows:
+
+1. **Text-to-Video (t2v)** - Generate videos from text prompts
+2. **Image-to-Video (i2v)** - Animate a static image into a video (First and Last Frame supported)
+3. **Sound-to-Video (s2v)** - Bring a character in an image to life with video and audio synchronization including lip syncing
+4. **Animate-Move** - Transfer character motion and emotion from a reference video to a subject from an image into a new video
+5. **Animate-Replace** - Replace a subject in a video while preserving motion
+
+### Model Variants
+
+Each workflow has two model variants optimized for different use cases:
+
+- **Speed variant** (with `_lightx2v` suffix) - Faster inference (4-step), good quality
+- **Quality variant** (without `_lightx2v`) - Slower inference, best quality
+
+Example model IDs:
+- `wan_v2.2-14b-fp8_t2v_lightx2v` (Text-to-Video, speed)
+- `wan_v2.2-14b-fp8_t2v` (Text-to-Video, quality)
+- `wan_v2.2-14b-fp8_i2v_lightx2v` (Image-to-Video, speed)
+- `wan_v2.2-14b-fp8_i2v` (Image-to-Video, quality)
+- `wan_v2.2-14b-fp8_s2v_lightx2v` (Sound-to-Video, speed)
+- `wan_v2.2-14b-fp8_s2v` (Sound-to-Video, quality)
+- `wan_v2.2-14b-fp8_animate-move_lightx2v` (Animate-Move, speed)
+- `wan_v2.2-14b-fp8_animate-replace_lightx2v` (Animate-Replace, speed)
+
+### Video Parameters
+
+When creating video projects, you can specify:
+
+- `fps` - Frames per second: 16 or 32 (default: 16)
+- `frames` - Number of frames: 17-161 (default: 81, which is ~5 seconds at 16fps)
+- `width` - Video width in pixels
+- `height` - Video height in pixels
+- `steps` - Increase inference steps to increase quality
+- `seed` - Random seed for reproducibility
+- `referenceImage` - Reference image for workflows that require it (i2v, s2v, animate-move, animate-replace)
+- `referenceVideo` - Reference video for animate workflows (animate-move, animate-replace)
+- `referenceAudio` - Reference audio for sound-to-video workflow
+
+### Text-to-Video Example
+
+```javascript
+const project = await sogni.projects.create({
+  type: 'video',
+  network: 'fast',
+  modelId: 'wan_v2.2-14b-fp8_t2v_lightx2v',
+  positivePrompt: 'A serene ocean wave crashing on a beach at sunset',
+  fps: 16,
+  frames: 81,
+  width: 512,
+  height: 512
+});
+
+const videoUrls = await project.waitForCompletion();
+console.log('Video URL:', videoUrls[0]);
+```
+
+### Image-to-Video Example
+
+```javascript
+const referenceImage = fs.readFileSync('./input-image.png');
+
+const project = await sogni.projects.create({
+  type: 'video',
+  network: 'fast',
+  modelId: 'wan_v2.2-14b-fp8_i2v_lightx2v',
+  positivePrompt: 'camera zooms in slowly',
+  referenceImage: referenceImage,
+  fps: 16,
+  frames: 81
+});
+
+const videoUrls = await project.waitForCompletion();
+```
+
+### Sound-to-Video Example
+
+```javascript
+const referenceImage = fs.readFileSync('./image.jpg');
+const referenceAudio = fs.readFileSync('./audio.m4a');
+
+const project = await sogni.projects.create({
+  type: 'video',
+  network: 'fast',
+  modelId: 'wan_v2.2-14b-fp8_s2v_lightx2v',
+  referenceImage: referenceImage,
+  referenceAudio: referenceAudio,
+  fps: 16,
+  frames: 81
+});
+
+const videoUrls = await project.waitForCompletion();
+```
+
+### Animate-Move Example
+
+Transfer motion from a reference video to a subject in an image:
+
+```javascript
+const referenceImage = fs.readFileSync('./subject.jpg');
+const referenceVideo = fs.readFileSync('./motion-source.mp4');
+
+const project = await sogni.projects.create({
+  type: 'video',
+  network: 'fast',
+  modelId: 'wan_v2.2-14b-fp8_animate-move_lightx2v',
+  referenceImage: referenceImage,
+  referenceVideo: referenceVideo,
+  fps: 16,
+  frames: 81
+});
+
+const videoUrls = await project.waitForCompletion();
+```
+
+### Animate-Replace Example
+
+Replace a subject in a video while preserving the original motion:
+
+```javascript
+const referenceImage = fs.readFileSync('./new-subject.jpg');
+const referenceVideo = fs.readFileSync('./original-video.mp4');
+
+const project = await sogni.projects.create({
+  type: 'video',
+  network: 'fast',
+  modelId: 'wan_v2.2-14b-fp8_animate-replace_lightx2v',
+  referenceImage: referenceImage,
+  referenceVideo: referenceVideo,
+  fps: 16,
+  frames: 81
+});
+
+const videoUrls = await project.waitForCompletion();
+```
+
+## Code Examples
+
+The [examples](https://github.com/Sogni-AI/sogni-client/tree/main/examples) directory contains working examples for all workflows:
+
+### Image Workflow Examples
+- **`workflow_text_to_image.mjs`** - Text-to-image generation with multiple model options
+- **`workflow_image_edit.mjs`** - Reference-based image generation using context images
+
+### Video Workflow Examples
+- **`workflow_text_to_video.mjs`** - Text-to-video generation with WAN 2.2 models
+- **`workflow_image_to_video.mjs`** - Animate static images into videos
+- **`workflow_sound_to_video.mjs`** - Audio-synchronized video generation with lip-sync
+- **`workflow_video_to_video.mjs`** - Motion transfer and character replacement (Animate-Move/Animate-Replace)
+
+### Basic Examples
+- **`promise_based.mjs`** - Image generation using promises/async-await
+- **`event_driven.js`** - Image generation using event listeners
+
+### Featured Models
+
+The workflow examples showcase a few powerful open-source frontier models supported by Sogni Supernet:
+
+| Model ID | Description | Use Case |
+|----------|-------------|----------|
+| `z_image_turbo_bf16` | **Z-Image Turbo** - Ultra-fast 4-step generation | Quick text-to-image prototyping and iteration |
+| `qwen_image_edit_2511_fp8_lightning` | **Qwen Image Edit Lightning** - Fast 4-step editing | Rapid reference-based image generation |
+| `qwen_image_edit_2511_fp8` | **Qwen Image Edit** - High quality 20-step editing | Professional image editing with context awareness |
+| `wan_v2.2-14b-fp8_t2v_lightx2v` | **Wan 2.2 T2V** - Text-to-video | Generate videos from text prompts |
+
+All workflow examples include:
+- Interactive model and parameter selection
+- Balance checking and cost confirmation
+- Real-time progress tracking with ETA
+- Error handling with detailed feedback
+- Automatic file download and preview
+
+Run any workflow example:
+```bash
+cd examples
+npm install
+node workflow_text_to_image.mjs
+node workflow_image_edit.mjs
+node workflow_text_to_video.mjs
+```