@picsart/ai-sdk 5.30.0 → 5.31.0

package/index.d.ts

@@ -2482,6 +2482,11 @@ interface ClientConfig {
     apiUrl: string;
     /** Enable Drive integration — auto-save generations to a Drive folder. */
     drive?: DriveConfig;
+    /**
+     * Input-transformation defaults applied to every generation. A per-call
+     * `options.inputsTransformation` overrides this field by field.
+     */
+    inputsTransformation?: PayloadInputsTransformationOptions;
     /**
      * Voice/avatar catalog behavior. `{ preload: true }` loads the first page
      * of every catalog-bound param in the background at client creation.
@@ -2527,8 +2532,9 @@ interface PayloadInputsTransformationOptions {
     /**
      * Downscale input images that exceed the vendor's download size cap
      * (e.g. ByteDance's 30 MiB) and retry the generation once, instead of
-     * failing with an input-limit error. Defaults to true; workers without
-     * input transformation ignore it.
+     * failing with an input-limit error. Opt-in — defaults to false, so an
+     * oversized input fails fast unless you set this; workers without input
+     * transformation ignore it.
      */
     downscaleOversizedImages?: boolean;
 }
@@ -2550,8 +2556,9 @@ interface GenerateOptions {
     folder?: DriveFolder;
     /** Save result to Picsart Drive via backend. Injected into the workflow payload. */
     drive?: PayloadDriveOptions;
-    /** Input-transformation settings. Injected into the workflow payload; when
-     *  omitted, oversized-image downscaling defaults to enabled. */
+    /** Input-transformation settings for this call — overrides the client-level
+     *  `inputsTransformation`. When neither is set, oversized-image downscaling
+     *  stays off (opt-in). */
     inputsTransformation?: PayloadInputsTransformationOptions;
     /**
      * App identity stamped onto the saved generation (appId/appType).

package/index.js

@@ -10712,6 +10712,7 @@ function createClient(config) {
   const supportsSubmit = typeof transport.submit === "function";
   const apis = createApis(isConfig ? config : null);
   const catalogs = createCatalogs(transport, isConfig ? config.catalogs : void 0);
+  const inputsTransformationConfig = isConfig ? config.inputsTransformation : void 0;
   const driveConfig = isConfig ? config.drive : void 0;
   const driveClient = isConfig && driveConfig ? createDriveClient(resolveFetch(config), config.apiUrl, driveConfig.folder) : null;
   async function executeModel(model, workflow, payload, options) {
@@ -10754,7 +10755,7 @@ function createClient(config) {
       options: {
         ...existing,
         inputs_transformation: {
-          downscale_oversized_images: inputsTransformation?.downscaleOversizedImages ?? true
+          downscale_oversized_images: inputsTransformation?.downscaleOversizedImages ?? inputsTransformationConfig?.downscaleOversizedImages ?? false
         },
         ...drive ? { drive } : {}
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picsart/ai-sdk",
-  "version": "5.30.0",
+  "version": "5.31.0",
   "type": "module",
   "description": "Type-safe SDK for 100+ AI models — image, video, audio, and text generation with Picsart",
   "license": "MIT",