@leonardo-ai/sdk 4.20.0 → 4.21.2

package/README.md

@@ -57,10 +57,7 @@ bun add @leonardo-ai/sdk
 ### Yarn
 
 ```bash
-yarn add @leonardo-ai/sdk zod
-
-# Note that Yarn does not install peer dependencies automatically. You will need
-# to install zod as shown above.
+yarn add @leonardo-ai/sdk
 ```
 <!-- End SDK Installation [installation] -->
 
@@ -75,15 +72,47 @@ To get access to the API and fetch an API key, please sign up for [access](https
 
 ```typescript
 import { Leonardo } from "@leonardo-ai/sdk";
+import { SettingName } from "@leonardo-ai/sdk/sdk/models/shared";
 
 const leonardo = new Leonardo({
   bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
 });
 
 async function run() {
-  const result = await leonardo.initImages.deleteInitImageById("<id>");
+  const result = await leonardo.blueprints.executeBlueprint({
+    blueprintVersionId: "550e8400-e29b-41d4-a716-446655440000",
+    input: {
+      collectionIds: [],
+      nodeInputs: [
+        {
+          nodeId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+          settingName: SettingName.Text,
+          value: "A futuristic cityscape at sunset",
+        },
+        {
+          nodeId: "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+          settingName: SettingName.TextVariables,
+          value: [
+            {
+              name: "characterName",
+              value: "Luna",
+            },
+            {
+              name: "outfit",
+              value: "cyberpunk armor",
+            },
+          ],
+        },
+        {
+          nodeId: "c3d4e5f6-a7b8-9012-cdef-123456789012",
+          settingName: SettingName.ImageUrl,
+          value: "https://cdn.leonardo.ai/users/example/image.png",
+        },
+      ],
+      public: false,
+    },
+  });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -98,7 +127,20 @@ run();
 <details open>
 <summary>Available methods</summary>
 
-### [dataset](docs/sdks/dataset/README.md)
+### [ThreeDModelAssets](docs/sdks/threedmodelassets/README.md)
+
+* [delete3DModelById](docs/sdks/threedmodelassets/README.md#delete3dmodelbyid) - Delete 3D Model by ID
+* [uploadModelAsset](docs/sdks/threedmodelassets/README.md#uploadmodelasset) - Upload 3D Model
+
+### [Blueprints](docs/sdks/blueprints/README.md)
+
+* [executeBlueprint](docs/sdks/blueprints/README.md#executeblueprint) - Execute a Blueprint
+* [getBlueprintById](docs/sdks/blueprints/README.md#getblueprintbyid) - Get Blueprint by ID
+* [getBlueprintExecution](docs/sdks/blueprints/README.md#getblueprintexecution) - Get Blueprint Execution by ID
+* [getBlueprintExecutionGenerations](docs/sdks/blueprints/README.md#getblueprintexecutiongenerations) - Get Blueprint Execution Generations by Execution ID
+* [getBlueprintVersionsByBlueprintId](docs/sdks/blueprints/README.md#getblueprintversionsbyblueprintid) - Get Blueprint Versions by Blueprint ID
+
+### [Dataset](docs/sdks/dataset/README.md)
 
 * [createDataset](docs/sdks/dataset/README.md#createdataset) - Create a Dataset
 * [deleteDatasetById](docs/sdks/dataset/README.md#deletedatasetbyid) - Delete a Single Dataset by ID
@@ -106,7 +148,7 @@ run();
 * [uploadDatasetImage](docs/sdks/dataset/README.md#uploaddatasetimage) - Upload dataset image
 * [uploadDatasetImageFromGen](docs/sdks/dataset/README.md#uploaddatasetimagefromgen) - Upload a Single Generated Image to a Dataset
 
-### [elements](docs/sdks/elements/README.md)
+### [Elements](docs/sdks/elements/README.md)
 
 * [createElement](docs/sdks/elements/README.md#createelement) - Train a Custom Element
 * [deleteElementById](docs/sdks/elements/README.md#deleteelementbyid) - Delete a Single Custom Element by ID
@@ -114,22 +156,27 @@ run();
 * [getElementById](docs/sdks/elements/README.md#getelementbyid) - Get a Single Custom Element by ID
 * [listElements](docs/sdks/elements/README.md#listelements) - List Elements
 
-### [image](docs/sdks/image/README.md)
+### [Image](docs/sdks/image/README.md)
 
 * [createGeneration](docs/sdks/image/README.md#creategeneration) - Create a Generation of Images
 * [deleteGenerationById](docs/sdks/image/README.md#deletegenerationbyid) - Delete a Single Generation
 * [getGenerationById](docs/sdks/image/README.md#getgenerationbyid) - Get a Single Generation
 * [getGenerationsByUserId](docs/sdks/image/README.md#getgenerationsbyuserid) - Get generations by user ID
 
-### [initImages](docs/sdks/initimages/README.md)
+### [InitImages](docs/sdks/initimages/README.md)
 
 * [deleteInitImageById](docs/sdks/initimages/README.md#deleteinitimagebyid) - Delete init image
 * [getInitImageById](docs/sdks/initimages/README.md#getinitimagebyid) - Get single init image
 * [uploadCanvasInitImage](docs/sdks/initimages/README.md#uploadcanvasinitimage) - Upload Canvas Editor init and mask image
 * [uploadInitImage](docs/sdks/initimages/README.md#uploadinitimage) - Upload init image
 
+### [Media](docs/sdks/media/README.md)
 
-### [models](docs/sdks/models/README.md)
+* [deleteUploadedMediaById](docs/sdks/media/README.md#deleteuploadedmediabyid) - Delete uploaded media
+* [getUploadedMediaById](docs/sdks/media/README.md#getuploadedmediabyid) - Get uploaded media
+* [uploadMedia](docs/sdks/media/README.md#uploadmedia) - Upload media
+
+### [Models](docs/sdks/models/README.md)
 
 * [createModel](docs/sdks/models/README.md#createmodel) - Train a Custom Model
 * [deleteModelById](docs/sdks/models/README.md#deletemodelbyid) - Delete a Single Custom Model by ID
@@ -137,46 +184,45 @@ run();
 * [getModelById](docs/sdks/models/README.md#getmodelbyid) - Get a Single Custom Model by ID
 * [listPlatformModels](docs/sdks/models/README.md#listplatformmodels) - List Platform Models
 
-### [motion](docs/sdks/motion/README.md)
+### [Motion](docs/sdks/motion/README.md)
 
+* [createImageToVideoGeneration](docs/sdks/motion/README.md#createimagetovideogeneration) - Create a video generation from an image
 * [createSVDMotionGeneration](docs/sdks/motion/README.md#createsvdmotiongeneration) - Create SVD Motion Generation
+* [createTextToVideoGeneration](docs/sdks/motion/README.md#createtexttovideogeneration) - Create a video generation from a text prompt
+* [createVideoUpscale](docs/sdks/motion/README.md#createvideoupscale) - Upscale a generated video
 
-### [pricingCalculator](docs/sdks/pricingcalculator/README.md)
+### [PricingCalculator](docs/sdks/pricingcalculator/README.md)
 
 * [pricingCalculator](docs/sdks/pricingcalculator/README.md#pricingcalculator) - Calculating API Cost
 
-### [prompt](docs/sdks/prompt/README.md)
+### [Prompt](docs/sdks/prompt/README.md)
 
 * [promptImprove](docs/sdks/prompt/README.md#promptimprove) - Improve a Prompt
 * [promptRandom](docs/sdks/prompt/README.md#promptrandom) - Generate a Random prompt
 
-### [realtimeCanvas](docs/sdks/realtimecanvas/README.md)
+### [RealtimeCanvas](docs/sdks/realtimecanvas/README.md)
 
 * [createLCMGeneration](docs/sdks/realtimecanvas/README.md#createlcmgeneration) - Create LCM Generation
 * [performAlchemyUpscaleLCM](docs/sdks/realtimecanvas/README.md#performalchemyupscalelcm) - Perform Alchemy Upscale on a LCM image
 * [performInpaintingLCM](docs/sdks/realtimecanvas/README.md#performinpaintinglcm) - Perform inpainting on a LCM image
 * [performInstantRefine](docs/sdks/realtimecanvas/README.md#performinstantrefine) - Perform instant refine on a LCM image
 
-### [texture](docs/sdks/texture/README.md)
+### [Texture](docs/sdks/texture/README.md)
 
 * [createTextureGeneration](docs/sdks/texture/README.md#createtexturegeneration) - Create Texture Generation
 * [deleteTextureGenerationById](docs/sdks/texture/README.md#deletetexturegenerationbyid) - Delete Texture Generation by ID
 
-### [threeDModelAssets](docs/sdks/threedmodelassets/README.md)
-
-* [delete3DModelById](docs/sdks/threedmodelassets/README.md#delete3dmodelbyid) - Delete 3D Model by ID
-* [uploadModelAsset](docs/sdks/threedmodelassets/README.md#uploadmodelasset) - Upload 3D Model
-
-### [user](docs/sdks/user/README.md)
+### [User](docs/sdks/user/README.md)
 
 * [getUserSelf](docs/sdks/user/README.md#getuserself) - Get user information
 
-### [variation](docs/sdks/variation/README.md)
+### [Variation](docs/sdks/variation/README.md)
 
 * [createUniversalUpscalerJob](docs/sdks/variation/README.md#createuniversalupscalerjob) - Create using Universal Upscaler
 * [createVariationNoBG](docs/sdks/variation/README.md#createvariationnobg) - Create no background
 * [createVariationUnzoom](docs/sdks/variation/README.md#createvariationunzoom) - Create unzoom
 * [createVariationUpscale](docs/sdks/variation/README.md#createvariationupscale) - Create upscale
+* [getMotionVariationById](docs/sdks/variation/README.md#getmotionvariationbyid) - Get motion variation by ID
 * [getVariationById](docs/sdks/variation/README.md#getvariationbyid) - Get variation by ID
 
 </details>
@@ -191,49 +237,69 @@ run();
 <!-- Start Error Handling [errors] -->
 ## Error Handling
 
-If the request fails due to, for example 4XX or 5XX status codes, it will throw a `SDKError`.
+[`LeonardoError`](./src/sdk/models/errors/leonardoerror.ts) is the base class for all HTTP error responses. It has the following properties:
 
-| Error Type      | Status Code | Content Type |
-| --------------- | ----------- | ------------ |
-| errors.SDKError | 4XX, 5XX    | \*/\*        |
+| Property            | Type       | Description                                            |
+| ------------------- | ---------- | ------------------------------------------------------ |
+| `error.message`     | `string`   | Error message                                          |
+| `error.statusCode`  | `number`   | HTTP response status code eg `404`                     |
+| `error.headers`     | `Headers`  | HTTP response headers                                  |
+| `error.body`        | `string`   | HTTP body. Can be empty string if no body is returned. |
+| `error.rawResponse` | `Response` | Raw HTTP response                                      |
 
+### Example
 ```typescript
 import { Leonardo } from "@leonardo-ai/sdk";
-import { SDKValidationError } from "@leonardo-ai/sdk/sdk/models/errors";
+import * as errors from "@leonardo-ai/sdk/sdk/models/errors";
+import { SettingName } from "@leonardo-ai/sdk/sdk/models/shared";
 
 const leonardo = new Leonardo({
   bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
 });
 
 async function run() {
-  let result;
   try {
-    result = await leonardo.initImages.deleteInitImageById("<id>");
+    const result = await leonardo.blueprints.executeBlueprint({
+      blueprintVersionId: "550e8400-e29b-41d4-a716-446655440000",
+      input: {
+        collectionIds: [],
+        nodeInputs: [
+          {
+            nodeId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+            settingName: SettingName.Text,
+            value: "A futuristic cityscape at sunset",
+          },
+          {
+            nodeId: "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+            settingName: SettingName.TextVariables,
+            value: [
+              {
+                name: "characterName",
+                value: "Luna",
+              },
+              {
+                name: "outfit",
+                value: "cyberpunk armor",
+              },
+            ],
+          },
+          {
+            nodeId: "c3d4e5f6-a7b8-9012-cdef-123456789012",
+            settingName: SettingName.ImageUrl,
+            value: "https://cdn.leonardo.ai/users/example/image.png",
+          },
+        ],
+        public: false,
+      },
+    });
 
-    // Handle the result
     console.log(result);
-  } catch (err) {
-    switch (true) {
-      // The server response does not match the expected SDK schema
-      case (err instanceof SDKValidationError):
-        {
-          // Pretty-print will provide a human-readable multi-line error message
-          console.error(err.pretty());
-          // Raw value may also be inspected
-          console.error(err.rawValue);
-          return;
-        }
-        sdkerror.js;
-      // Server returned an error status code or an unknown content type
-      case (err instanceof SDKError): {
-        console.error(err.statusCode);
-        console.error(err.rawResponse.body);
-        return;
-      }
-      default: {
-        // Other errors such as network errors, see HTTPClientErrors for more details
-        throw err;
-      }
+  } catch (error) {
+    if (error instanceof errors.LeonardoError) {
+      console.log(error.message);
+      console.log(error.statusCode);
+      console.log(error.body);
+      console.log(error.headers);
     }
   }
 }
@@ -242,17 +308,26 @@ run();
 
 ```
 
-Validation errors can also occur when either method arguments or data returned from the server do not match the expected format. The `SDKValidationError` that is thrown as a result will capture the raw value that failed validation in an attribute called `rawValue`. Additionally, a `pretty()` method is available on this error that can be used to log a nicely formatted multi-line string since validation errors can list many issues and the plain error string may be difficult read when debugging.
+### Error Classes
+**Primary error:**
+* [`LeonardoError`](./src/sdk/models/errors/leonardoerror.ts): The base class for HTTP error responses.
+
+<details><summary>Less common errors (6)</summary>
+
+<br />
+
+**Network errors:**
+* [`ConnectionError`](./src/sdk/models/errors/httpclienterrors.ts): HTTP client was unable to make a request to a server.
+* [`RequestTimeoutError`](./src/sdk/models/errors/httpclienterrors.ts): HTTP request timed out due to an AbortSignal signal.
+* [`RequestAbortedError`](./src/sdk/models/errors/httpclienterrors.ts): HTTP request was aborted by the client.
+* [`InvalidRequestError`](./src/sdk/models/errors/httpclienterrors.ts): Any input used to create a request is invalid.
+* [`UnexpectedClientError`](./src/sdk/models/errors/httpclienterrors.ts): Unrecognised or unexpected error.
 
-In some rare cases, the SDK can fail to get a response from the server or even make the request due to unexpected circumstances such as network conditions. These types of errors are captured in the `sdk/models/errors/httpclienterrors.ts` module:
 
-| HTTP Client Error                                    | Description                                          |
-| ---------------------------------------------------- | ---------------------------------------------------- |
-| RequestAbortedError                                  | HTTP request was aborted by the client               |
-| RequestTimeoutError                                  | HTTP request timed out due to an AbortSignal signal  |
-| ConnectionError                                      | HTTP client was unable to make a request to a server |
-| InvalidRequestError                                  | Any input used to create a request is invalid        |
-| UnexpectedClientError                                | Unrecognised or unexpected error                     |
+**Inherit from [`LeonardoError`](./src/sdk/models/errors/leonardoerror.ts)**:
+* [`ResponseValidationError`](./src/sdk/models/errors/responsevalidationerror.ts): Type mismatch between the data returned from the server and the structure expected by the SDK. See `error.rawValue` for the raw value and `error.pretty()` for a nicely formatted multi-line string.
+
+</details>
 <!-- End Error Handling [errors] -->
 
 
@@ -270,19 +345,23 @@ The `HTTPClient` constructor takes an optional `fetcher` argument that can be
 used to integrate a third-party HTTP client or when writing tests to mock out
 the HTTP client and feed in fixtures.
 
-The following example shows how to use the `"beforeRequest"` hook to to add a
-custom header and a timeout to requests and how to use the `"requestError"` hook
-to log errors:
+The following example shows how to:
+- route requests through a proxy server using [undici](https://www.npmjs.com/package/undici)'s ProxyAgent
+- use the `"beforeRequest"` hook to add a custom header and a timeout to requests
+- use the `"requestError"` hook to log errors
 
 ```typescript
 import { Leonardo } from "@leonardo-ai/sdk";
+import { ProxyAgent } from "undici";
 import { HTTPClient } from "@leonardo-ai/sdk/lib/http";
 
+const dispatcher = new ProxyAgent("http://proxy.example.com:8080");
+
 const httpClient = new HTTPClient({
-  // fetcher takes a function that has the same signature as native `fetch`.
-  fetcher: (request) => {
-    return fetch(request);
-  }
+  // 'fetcher' takes a function that has the same signature as native 'fetch'.
+  fetcher: (input, init) =>
+    // 'dispatcher' is specific to undici and not part of the standard Fetch API.
+    fetch(input, { ...init, dispatcher } as RequestInit),
 });
 
 httpClient.addHook("beforeRequest", (request) => {
@@ -302,7 +381,7 @@ httpClient.addHook("requestError", (error, request) => {
   console.groupEnd();
 });
 
-const sdk = new Leonardo({ httpClient });
+const sdk = new Leonardo({ httpClient: httpClient });
 ```
 <!-- End Custom HTTP Client [http-client] -->
 
@@ -313,9 +392,10 @@ const sdk = new Leonardo({ httpClient });
 
 ### Override Server URL Per-Client
 
-The default server can also be overridden globally by passing a URL to the `serverURL: string` optional parameter when initializing the SDK client instance. For example:
+The default server can be overridden globally by passing a URL to the `serverURL: string` optional parameter when initializing the SDK client instance. For example:
 ```typescript
 import { Leonardo } from "@leonardo-ai/sdk";
+import { SettingName } from "@leonardo-ai/sdk/sdk/models/shared";
 
 const leonardo = new Leonardo({
   serverURL: "https://cloud.leonardo.ai/api/rest/v1",
@@ -323,9 +403,40 @@ const leonardo = new Leonardo({
 });
 
 async function run() {
-  const result = await leonardo.initImages.deleteInitImageById("<id>");
+  const result = await leonardo.blueprints.executeBlueprint({
+    blueprintVersionId: "550e8400-e29b-41d4-a716-446655440000",
+    input: {
+      collectionIds: [],
+      nodeInputs: [
+        {
+          nodeId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+          settingName: SettingName.Text,
+          value: "A futuristic cityscape at sunset",
+        },
+        {
+          nodeId: "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+          settingName: SettingName.TextVariables,
+          value: [
+            {
+              name: "characterName",
+              value: "Luna",
+            },
+            {
+              name: "outfit",
+              value: "cyberpunk armor",
+            },
+          ],
+        },
+        {
+          nodeId: "c3d4e5f6-a7b8-9012-cdef-123456789012",
+          settingName: SettingName.ImageUrl,
+          value: "https://cdn.leonardo.ai/users/example/image.png",
+        },
+      ],
+      public: false,
+    },
+  });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -350,15 +461,47 @@ This SDK supports the following security scheme globally:
 To authenticate with the API the `bearerAuth` parameter must be set when initializing the SDK client instance. For example:
 ```typescript
 import { Leonardo } from "@leonardo-ai/sdk";
+import { SettingName } from "@leonardo-ai/sdk/sdk/models/shared";
 
 const leonardo = new Leonardo({
   bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
 });
 
 async function run() {
-  const result = await leonardo.initImages.deleteInitImageById("<id>");
+  const result = await leonardo.blueprints.executeBlueprint({
+    blueprintVersionId: "550e8400-e29b-41d4-a716-446655440000",
+    input: {
+      collectionIds: [],
+      nodeInputs: [
+        {
+          nodeId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+          settingName: SettingName.Text,
+          value: "A futuristic cityscape at sunset",
+        },
+        {
+          nodeId: "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+          settingName: SettingName.TextVariables,
+          value: [
+            {
+              name: "characterName",
+              value: "Luna",
+            },
+            {
+              name: "outfit",
+              value: "cyberpunk armor",
+            },
+          ],
+        },
+        {
+          nodeId: "c3d4e5f6-a7b8-9012-cdef-123456789012",
+          settingName: SettingName.ImageUrl,
+          value: "https://cdn.leonardo.ai/users/example/image.png",
+        },
+      ],
+      public: false,
+    },
+  });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -388,6 +531,11 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 
 <summary>Available standalone functions</summary>
 
+- [`blueprintsExecuteBlueprint`](docs/sdks/blueprints/README.md#executeblueprint) - Execute a Blueprint
+- [`blueprintsGetBlueprintById`](docs/sdks/blueprints/README.md#getblueprintbyid) - Get Blueprint by ID
+- [`blueprintsGetBlueprintExecution`](docs/sdks/blueprints/README.md#getblueprintexecution) - Get Blueprint Execution by ID
+- [`blueprintsGetBlueprintExecutionGenerations`](docs/sdks/blueprints/README.md#getblueprintexecutiongenerations) - Get Blueprint Execution Generations by Execution ID
+- [`blueprintsGetBlueprintVersionsByBlueprintId`](docs/sdks/blueprints/README.md#getblueprintversionsbyblueprintid) - Get Blueprint Versions by Blueprint ID
 - [`datasetCreateDataset`](docs/sdks/dataset/README.md#createdataset) - Create a Dataset
 - [`datasetDeleteDatasetById`](docs/sdks/dataset/README.md#deletedatasetbyid) - Delete a Single Dataset by ID
 - [`datasetGetDatasetById`](docs/sdks/dataset/README.md#getdatasetbyid) - Get a Single Dataset by ID
@@ -406,12 +554,18 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 - [`initImagesGetInitImageById`](docs/sdks/initimages/README.md#getinitimagebyid) - Get single init image
 - [`initImagesUploadCanvasInitImage`](docs/sdks/initimages/README.md#uploadcanvasinitimage) - Upload Canvas Editor init and mask image
 - [`initImagesUploadInitImage`](docs/sdks/initimages/README.md#uploadinitimage) - Upload init image
+- [`mediaDeleteUploadedMediaById`](docs/sdks/media/README.md#deleteuploadedmediabyid) - Delete uploaded media
+- [`mediaGetUploadedMediaById`](docs/sdks/media/README.md#getuploadedmediabyid) - Get uploaded media
+- [`mediaUploadMedia`](docs/sdks/media/README.md#uploadmedia) - Upload media
 - [`modelsCreateModel`](docs/sdks/models/README.md#createmodel) - Train a Custom Model
 - [`modelsDeleteModelById`](docs/sdks/models/README.md#deletemodelbyid) - Delete a Single Custom Model by ID
 - [`modelsGetCustomModelsByUserId`](docs/sdks/models/README.md#getcustommodelsbyuserid) - Get a list of Custom Models by User ID
 - [`modelsGetModelById`](docs/sdks/models/README.md#getmodelbyid) - Get a Single Custom Model by ID
 - [`modelsListPlatformModels`](docs/sdks/models/README.md#listplatformmodels) - List Platform Models
+- [`motionCreateImageToVideoGeneration`](docs/sdks/motion/README.md#createimagetovideogeneration) - Create a video generation from an image
 - [`motionCreateSVDMotionGeneration`](docs/sdks/motion/README.md#createsvdmotiongeneration) - Create SVD Motion Generation
+- [`motionCreateTextToVideoGeneration`](docs/sdks/motion/README.md#createtexttovideogeneration) - Create a video generation from a text prompt
+- [`motionCreateVideoUpscale`](docs/sdks/motion/README.md#createvideoupscale) - Upscale a generated video
 - [`pricingCalculatorPricingCalculator`](docs/sdks/pricingcalculator/README.md#pricingcalculator) - Calculating API Cost
 - [`promptPromptImprove`](docs/sdks/prompt/README.md#promptimprove) - Improve a Prompt
 - [`promptPromptRandom`](docs/sdks/prompt/README.md#promptrandom) - Generate a Random prompt
@@ -428,6 +582,7 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 - [`variationCreateVariationNoBG`](docs/sdks/variation/README.md#createvariationnobg) - Create no background
 - [`variationCreateVariationUnzoom`](docs/sdks/variation/README.md#createvariationunzoom) - Create unzoom
 - [`variationCreateVariationUpscale`](docs/sdks/variation/README.md#createvariationupscale) - Create upscale
+- [`variationGetMotionVariationById`](docs/sdks/variation/README.md#getmotionvariationbyid) - Get motion variation by ID
 - [`variationGetVariationById`](docs/sdks/variation/README.md#getvariationbyid) - Get variation by ID
 
 </details>
@@ -441,13 +596,46 @@ Some of the endpoints in this SDK support retries.  If you use the SDK without a
 To change the default retry strategy for a single API call, simply provide a retryConfig object to the call:
 ```typescript
 import { Leonardo } from "@leonardo-ai/sdk";
+import { SettingName } from "@leonardo-ai/sdk/sdk/models/shared";
 
 const leonardo = new Leonardo({
   bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
 });
 
 async function run() {
-  const result = await leonardo.initImages.deleteInitImageById("<id>", {
+  const result = await leonardo.blueprints.executeBlueprint({
+    blueprintVersionId: "550e8400-e29b-41d4-a716-446655440000",
+    input: {
+      collectionIds: [],
+      nodeInputs: [
+        {
+          nodeId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+          settingName: SettingName.Text,
+          value: "A futuristic cityscape at sunset",
+        },
+        {
+          nodeId: "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+          settingName: SettingName.TextVariables,
+          value: [
+            {
+              name: "characterName",
+              value: "Luna",
+            },
+            {
+              name: "outfit",
+              value: "cyberpunk armor",
+            },
+          ],
+        },
+        {
+          nodeId: "c3d4e5f6-a7b8-9012-cdef-123456789012",
+          settingName: SettingName.ImageUrl,
+          value: "https://cdn.leonardo.ai/users/example/image.png",
+        },
+      ],
+      public: false,
+    },
+  }, {
     retries: {
       strategy: "backoff",
       backoff: {
@@ -460,7 +648,6 @@ async function run() {
     },
   });
 
-  // Handle the result
   console.log(result);
 }
 
@@ -471,6 +658,7 @@ run();
 If you'd like to override the default retry strategy for all operations that support retries, you can provide a retryConfig at SDK initialization:
 ```typescript
 import { Leonardo } from "@leonardo-ai/sdk";
+import { SettingName } from "@leonardo-ai/sdk/sdk/models/shared";
 
 const leonardo = new Leonardo({
   retryConfig: {
@@ -487,9 +675,40 @@ const leonardo = new Leonardo({
 });
 
 async function run() {
-  const result = await leonardo.initImages.deleteInitImageById("<id>");
+  const result = await leonardo.blueprints.executeBlueprint({
+    blueprintVersionId: "550e8400-e29b-41d4-a716-446655440000",
+    input: {
+      collectionIds: [],
+      nodeInputs: [
+        {
+          nodeId: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
+          settingName: SettingName.Text,
+          value: "A futuristic cityscape at sunset",
+        },
+        {
+          nodeId: "b2c3d4e5-f6a7-8901-bcde-f12345678901",
+          settingName: SettingName.TextVariables,
+          value: [
+            {
+              name: "characterName",
+              value: "Luna",
+            },
+            {
+              name: "outfit",
+              value: "cyberpunk armor",
+            },
+          ],
+        },
+        {
+          nodeId: "c3d4e5f6-a7b8-9012-cdef-123456789012",
+          settingName: SettingName.ImageUrl,
+          value: "https://cdn.leonardo.ai/users/example/image.png",
+        },
+      ],
+      public: false,
+    },
+  });
 
-  // Handle the result
   console.log(result);
 }
 

package/RUNTIMES.md

@@ -2,9 +2,9 @@
 
 This SDK is intended to be used in JavaScript runtimes that support ECMAScript 2020 or newer. The SDK uses the following features:
 
-* [Web Fetch API][web-fetch]
-* [Web Streams API][web-streams] and in particular `ReadableStream`
-* [Async iterables][async-iter] using `Symbol.asyncIterator`
+- [Web Fetch API][web-fetch]
+- [Web Streams API][web-streams] and in particular `ReadableStream`
+- [Async iterables][async-iter] using `Symbol.asyncIterator`
 
 [web-fetch]: https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
 [web-streams]: https://developer.mozilla.org/en-US/docs/Web/API/Streams_API
@@ -25,7 +25,7 @@ Runtime environments that are explicitly supported are:
 
 The following `tsconfig.json` options are recommended for projects using this
 SDK in order to get static type support for features like async iterables,
-streams and `fetch`-related APIs ([`for await...of`][for-await-of], 
+streams and `fetch`-related APIs ([`for await...of`][for-await-of],
 [`AbortSignal`][abort-signal], [`Request`][request], [`Response`][response] and
 so on):
 
@@ -38,11 +38,11 @@ so on):
 {
   "compilerOptions": {
     "target": "es2020", // or higher
-    "lib": ["es2020", "dom", "dom.iterable"],
+    "lib": ["es2020", "dom", "dom.iterable"]
   }
 }
 ```
 
 While `target` can be set to older ECMAScript versions, it may result in extra,
 unnecessary compatibility code being generated if you are not targeting old
-runtimes.
+runtimes.