@hautechai/sdk 2.41.0 → 2.43.0

package/README.md

@@ -85,12 +85,67 @@ sdk.ws.disconnect();
 
 Docs about how to use the SDK are available [here](https://docs.hautech.ai/)
 
+#### Seedream v5 Lite imagine operations
+
+```ts
+// Text-to-image
+const t2iOperation = await sdk.operations.run.imagine.seedream['5_lite_t2i'].v1({
+    input: {
+        prompt: 'A cinematic skyline at sunrise above a crystal bay',
+        width: 2048,
+        height: 2048,
+    },
+});
+
+// Image edit
+const editOperation = await sdk.operations.run.imagine.seedream['5_lite_edit'].v1({
+    input: {
+        prompt: 'Reimagine this scene as a watercolor illustration',
+        imageIds: ['existing-image-id'],
+    },
+});
+
+// Wait for the generated assets
+const finalizedT2i = await sdk.operations.wait(t2iOperation);
+const finalizedEdit = await sdk.operations.wait(editOperation);
+```
+
+Both variants accept dimensions up to 3072×3072. Pricing endpoints report a cost of **$0.04375 USD per run** for the text-to-image and edit models—use `sdk.pricing.list()` or `sdk.pricing.get('seedream.5_lite_t2i.v1')` / `sdk.pricing.get('seedream.5_lite_edit.v1')` to confirm the current catalog pricing.
+
+#### Google Nano Banana prompt-only vs. edit mode
+
+```ts
+// Prompt-only generation (no source images required)
+const promptOnly = await sdk.operations.run.google.nano_banana_pro.edit.v1({
+    input: {
+        prompt: 'Generate a high-fashion catalog shot of a model in neon streetwear',
+        // imageIds omitted on purpose
+    },
+});
+
+// Classic edit mode with at least one source image
+const editFromImage = await sdk.operations.run.google.nano_banana_pro.edit.v1({
+    input: {
+        prompt: 'Apply a cinematic golden-hour lighting pass to this asset',
+        imageIds: ['existing-image-id'],
+    },
+});
+```
+
+The backend Swagger DTO (`GoogleNanoBananaProEditV1Input`) intentionally marks `imageIds` as optional so prompt-only runs remain valid. Provide one or more IDs when you need edit behavior; omit the field when you want the model to generate a fresh asset purely from text.
+
 ### Uploading files
 
 - In browsers, prefer passing a `File` object to methods like `sdk.images.createFromFile` and `sdk.videos.createFromFile`. The `File.name` will be included in the multipart upload automatically.
 - If you pass a `Blob` in the browser, some environments may set the filename to a default value (e.g., `"blob"`). To control the filename when using a `Blob`, wrap it in an object with explicit metadata on server-side, or construct a `File` from the `Blob`.
 - In Node.js, when you pass a string path (e.g., `/path/to/image.png`), the SDK sets the multipart filename to the basename of the path (e.g., `image.png`). You can also pass an object with `{ stream, filename, contentType }` to control metadata explicitly.
 
+You can also expire uploads automatically by specifying a TTL when finalizing image uploads:
+
+```ts
+await sdk.images.createFromFile('/path/to/image.png', { ttlSeconds: 3600 });
+```
+
 ## Development
 
 ### Prerequisites