@picsart/ai-sdk 6.18.0 → 6.18.1

package/README.md

@@ -177,6 +177,16 @@ await ai.drive.save({
 const saveParams = ai.drive.buildSaveParams(generatedUrl, modelId, modelName, 'video', originalGenerationParams)
 ```
 
+When the request you submit is not the record you want kept (a render that sends
+only a reference to an earlier job, say), pass the inputs to record as
+`drive.generation`. Custom `attributes` still cannot replace them:
+
+```typescript
+await ai.submit(modelId, finalRequest, {
+  drive: { name: 'final.mp4', generation: { modelId, params: originalGenerationParams } },
+})
+```
+
 Legacy `model`/`prompt`/`textScript` saves are normalized at write time. URL-only
 uploads remain ordinary uploads: without generation context the SDK cannot infer
 model, prompt or settings. Existing Drive files are not backfilled. The backend preserves SDK-supplied metadata; it cannot reconstruct SDK input

package/index.d.ts

@@ -2779,6 +2779,13 @@ interface PayloadDriveOptions {
     attributes?: DriveAttributes;
     /** Target folder in Picsart Drive. */
     folder?: PayloadDriveFolderOptions;
+    /**
+     * Inputs to record as the file's provenance when they differ from the
+     * submitted request, e.g. a render that sends only a reference to an earlier
+     * job. Defaults to the model and params being generated. Never sent to the
+     * workflow; it only shapes `attributes`.
+     */
+    generation?: GenerationProvenance;
 }
 /**
  * Drive operations surface — returned by {@link createDriveClient} and exposed

package/index.js

@@ -13084,11 +13084,8 @@ function createClient(config) {
   function buildDrivePayloadOptions(model, params2, options) {
     const explicit = options?.drive;
     if (!driveConfig && !explicit) return void 0;
-    const attributes = buildGenerationAttributes({
-      modelId: model.id,
-      params: params2,
-      app: options?.app
-    });
+    const generation = explicit?.generation;
+    const attributes = buildGenerationAttributes(generation ? { ...generation, app: generation.app ?? options?.app } : { modelId: model.id, params: params2, app: options?.app });
     const folderPath = options?.folder?.name ?? driveConfig?.folder;
     return {
       // Named before the job runs, so the requested/declared format is the best hint.

package/package.json

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