@picsart/ai-sdk 5.29.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.
@@ -2521,6 +2526,18 @@ interface GenerateTextResult {
     /** Credit usage reported by the platform — same structure as the pluggable APIs' GenAITaskResponse. */
     usage?: CreditUsage;
 }
+/** Input-transformation settings injected into the workflow payload as
+ *  `options.inputs_transformation` (GenAIOptions, alongside `drive`). */
+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. Opt-in — defaults to false, so an
+     * oversized input fails fast unless you set this; workers without input
+     * transformation ignore it.
+     */
+    downscaleOversizedImages?: boolean;
+}
 /** Options for individual generate() / submit() calls. */
 interface GenerateOptions {
     signal?: AbortSignal;
@@ -2539,6 +2556,10 @@ interface GenerateOptions {
     folder?: DriveFolder;
     /** Save result to Picsart Drive via backend. Injected into the workflow payload. */
     drive?: PayloadDriveOptions;
+    /** 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).
      * TODO(backend-autosave): temporary — remove once the backend stamps these.
@@ -3043,4 +3064,4 @@ declare const findModel: (ref: string) => ModelDefinition | undefined;
  */
 declare const KLING_DUAL_IMAGE_EFFECTS: ReadonlySet<string>;
 
-export { ALL_MODELS, type AiClient, ApiError, type ApiErrorCode, type ApiErrorInit, type ApiResponse, type ApiRunOptions, type ApiSchemas, type ApisClient, type AppIdentity, type AppType, type AuthenticatedFetch, type AvatarOption, type BooleanDescriptor, type BooleanEntry, type CatalogDescriptor, type CatalogEntry, type CatalogItem, type CatalogKind, type CatalogPage, type CatalogPageOptions, type CatalogPreview, type CatalogQuery, type CatalogResult, type CatalogSource, type CatalogsClient, type CatalogsOptions, type ClientConfig, type CreditRange, type CreditRangeContext, type CreditTier, type CreditUsage, DEFAULT_VISIBLE_RELEASES, type DeepLinkResult, type DriveAttributes, type DriveClient, type DriveConfig, type DriveFile, type DriveFileDetails, type DriveFolder, type DriveMediaItem, type DriveSaveResult, type EntryMeta, type EnumDescriptor, type EnumEntry, type EnumOption, type FileDescriptor, type FileEntry, type FlatParamEntry, type GenerateOptions, type GenerateResult, type GenerateResultItem, type GenerateTextResult, type GenerationContext, type GenerationFile, type GenerationMode, KLING_DUAL_IMAGE_EFFECTS, type ListOptions, type MediaModelId, type MediaTypeFilter, Model, type ModelDefinition, type ModelDescriptor, type ModelFilter$1 as ModelFilter, type ModelInput, type ModelInputById, type ModelMeta, type ModelParams, type ModelParamsAccessor, Models, type ObjectDescriptor, type ObjectEntry, type ParamDescriptor, type ParamEntry, type ParamOption, type PayloadDriveFolderOptions, type PayloadDriveOptions, type PricingOptions, type ProviderInfo, type RangeDescriptor, type RangeEntry, type ReleaseTag, type SaveParams, type SdkPayload, type SdkTransport, type TextDescriptor, type TextEntry, type TextModelId, type TextModelInputById, type ToolUsage, type TypedModelId, type UserReaction, type ValidationResult$1 as ValidationResult, type VoiceOption, type WorkflowJobHandle, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, isVisibleForReleases, parseGeneration, releaseOf, toAvatarOption, toVoiceOption };
+export { ALL_MODELS, type AiClient, ApiError, type ApiErrorCode, type ApiErrorInit, type ApiResponse, type ApiRunOptions, type ApiSchemas, type ApisClient, type AppIdentity, type AppType, type AuthenticatedFetch, type AvatarOption, type BooleanDescriptor, type BooleanEntry, type CatalogDescriptor, type CatalogEntry, type CatalogItem, type CatalogKind, type CatalogPage, type CatalogPageOptions, type CatalogPreview, type CatalogQuery, type CatalogResult, type CatalogSource, type CatalogsClient, type CatalogsOptions, type ClientConfig, type CreditRange, type CreditRangeContext, type CreditTier, type CreditUsage, DEFAULT_VISIBLE_RELEASES, type DeepLinkResult, type DriveAttributes, type DriveClient, type DriveConfig, type DriveFile, type DriveFileDetails, type DriveFolder, type DriveMediaItem, type DriveSaveResult, type EntryMeta, type EnumDescriptor, type EnumEntry, type EnumOption, type FileDescriptor, type FileEntry, type FlatParamEntry, type GenerateOptions, type GenerateResult, type GenerateResultItem, type GenerateTextResult, type GenerationContext, type GenerationFile, type GenerationMode, KLING_DUAL_IMAGE_EFFECTS, type ListOptions, type MediaModelId, type MediaTypeFilter, Model, type ModelDefinition, type ModelDescriptor, type ModelFilter$1 as ModelFilter, type ModelInput, type ModelInputById, type ModelMeta, type ModelParams, type ModelParamsAccessor, Models, type ObjectDescriptor, type ObjectEntry, type ParamDescriptor, type ParamEntry, type ParamOption, type PayloadDriveFolderOptions, type PayloadDriveOptions, type PayloadInputsTransformationOptions, type PricingOptions, type ProviderInfo, type RangeDescriptor, type RangeEntry, type ReleaseTag, type SaveParams, type SdkPayload, type SdkTransport, type TextDescriptor, type TextEntry, type TextModelId, type TextModelInputById, type ToolUsage, type TypedModelId, type UserReaction, type ValidationResult$1 as ValidationResult, type VoiceOption, type WorkflowJobHandle, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, isVisibleForReleases, parseGeneration, releaseOf, toAvatarOption, toVoiceOption };

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) {
@@ -10746,9 +10747,19 @@ function createClient(config) {
       folder: explicit?.folder ?? (folderPath ? { path: folderPath } : void 0)
     };
   }
-  function injectDriveOptions(payload, drive) {
-    if (!drive) return payload;
-    return { ...payload, options: { drive } };
+  function injectPayloadOptions(payload, drive, inputsTransformation) {
+    const record = payload;
+    const existing = record.options ?? {};
+    return {
+      ...record,
+      options: {
+        ...existing,
+        inputs_transformation: {
+          downscale_oversized_images: inputsTransformation?.downscaleOversizedImages ?? inputsTransformationConfig?.downscaleOversizedImages ?? false
+        },
+        ...drive ? { drive } : {}
+      }
+    };
   }
   return {
     // ── Simple path ──────────────────────────────────────────────────
@@ -10770,7 +10781,7 @@ function createClient(config) {
       }
       const { workflow, payload, contract } = prepareRequest(resolved, params2);
       const drive = buildDrivePayloadOptions(resolved, params2, options);
-      const finalPayload = injectDriveOptions(payload, drive);
+      const finalPayload = injectPayloadOptions(payload, drive, options?.inputsTransformation);
       const completed = await executeModel(resolved, workflow, finalPayload, options);
       return parseResult(completed, resolved, contract);
     },
@@ -10824,7 +10835,7 @@ function createClient(config) {
       const resolved = resolveModel(model);
       const { workflow, payload } = prepareRequest(resolved, params2);
       const drive = buildDrivePayloadOptions(resolved, params2, options);
-      const finalPayload = injectDriveOptions(payload, drive);
+      const finalPayload = injectPayloadOptions(payload, drive, options?.inputsTransformation);
       return client.submit({ workflow, payload: finalPayload, signal: options?.signal });
     },
     /** Check the current status of a submitted job. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picsart/ai-sdk",
-  "version": "5.29.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",