@picsart/ai-sdk 6.18.0 → 6.19.0

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/_vendor/workflows-types/index.d.ts

@@ -149,7 +149,7 @@ interface ChatCompletionsCommand$1 {
     tools?: FunctionTool[];
     service_tier?: ServiceTier;
 }
-type ChatCompletionModels = "gpt-6-astra" | "gpt-6-sol" | "gpt-6-luna" | "gpt-5" | "gpt-5.1" | "gpt-5.2" | "gpt-5.2-pro" | "gpt-5.3-codex" | "gpt-5.4" | "gpt-5.4-pro" | "gpt-5.4-mini" | "gpt-5.4-nano" | "gpt-5.5" | "gpt-5.5-pro" | "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5-pro" | "gpt-5-mini" | "gpt-5-nano" | "gpt-5-search-api" | "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano" | "claude-sonnet-4-5" | "claude-sonnet-4-6" | "claude-sonnet-5" | "claude-opus-4-8" | "claude-opus-5" | "claude-haiku-4-5" | "claude-fable-5" | "claude-fable-5-1" | "gemini-3.1-pro-preview" | "gemini-3-flash-preview" | "gemini-3.8-flash" | "gemini-3.7-flash" | "gemini-3.6-flash" | "gemini-3.5-flash" | "gemini-3.5-flash-lite" | "gemini-3.1-flash-lite" | "gemini-2.5-flash" | "gemini-2.5-pro";
+type ChatCompletionModels = "gpt-6-astra" | "gpt-6-sol" | "gpt-6-luna" | "gpt-5" | "gpt-5.1" | "gpt-5.2" | "gpt-5.2-pro" | "gpt-5.3-codex" | "gpt-5.4" | "gpt-5.4-pro" | "gpt-5.4-mini" | "gpt-5.4-nano" | "gpt-5.5" | "gpt-5.5-pro" | "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5-pro" | "gpt-5-mini" | "gpt-5-nano" | "gpt-5-search-api" | "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano" | "claude-sonnet-4-5" | "claude-sonnet-4-6" | "claude-sonnet-5" | "claude-opus-4-8" | "claude-opus-5" | "claude-opus-5-5" | "claude-haiku-4-5" | "claude-fable-5" | "claude-fable-5-1" | "gemini-3.1-pro-preview" | "gemini-3-flash-preview" | "gemini-3.8-flash" | "gemini-3.7-flash" | "gemini-3.6-flash" | "gemini-3.5-flash" | "gemini-3.5-flash-lite" | "gemini-3.1-flash-lite" | "gemini-2.5-flash" | "gemini-2.5-pro";
 interface MessageParam {
     name?: string;
     role: "developer" | "system" | "user" | "assistant" | "tool";
@@ -206,7 +206,7 @@ interface ChatCompletionResponse {
 interface ChatCompletionResult {
     id: string;
     created: number;
-    model: "gpt-6-astra" | "gpt-6-sol" | "gpt-6-luna" | "gpt-5" | "gpt-5.1" | "gpt-5.2" | "gpt-5.2-pro" | "gpt-5.3-codex" | "gpt-5.4" | "gpt-5.4-pro" | "gpt-5.4-mini" | "gpt-5.4-nano" | "gpt-5.5" | "gpt-5.5-pro" | "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5-pro" | "gpt-5-mini" | "gpt-5-nano" | "gpt-5-search-api" | "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano" | "claude-sonnet-4-5" | "claude-sonnet-4-6" | "claude-sonnet-5" | "claude-opus-4-8" | "claude-opus-5" | "claude-haiku-4-5" | "claude-fable-5" | "claude-fable-5-1" | "gemini-3.1-pro-preview" | "gemini-3-flash-preview" | "gemini-3.8-flash" | "gemini-3.7-flash" | "gemini-3.6-flash" | "gemini-3.5-flash" | "gemini-3.5-flash-lite" | "gemini-3.1-flash-lite" | "gemini-2.5-flash" | "gemini-2.5-pro";
+    model: "gpt-6-astra" | "gpt-6-sol" | "gpt-6-luna" | "gpt-5" | "gpt-5.1" | "gpt-5.2" | "gpt-5.2-pro" | "gpt-5.3-codex" | "gpt-5.4" | "gpt-5.4-pro" | "gpt-5.4-mini" | "gpt-5.4-nano" | "gpt-5.5" | "gpt-5.5-pro" | "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5-pro" | "gpt-5-mini" | "gpt-5-nano" | "gpt-5-search-api" | "gpt-4o" | "gpt-4o-mini" | "gpt-4.1" | "gpt-4.1-mini" | "gpt-4.1-nano" | "claude-sonnet-4-5" | "claude-sonnet-4-6" | "claude-sonnet-5" | "claude-opus-4-8" | "claude-opus-5" | "claude-opus-5-5" | "claude-haiku-4-5" | "claude-fable-5" | "claude-fable-5-1" | "gemini-3.1-pro-preview" | "gemini-3-flash-preview" | "gemini-3.8-flash" | "gemini-3.7-flash" | "gemini-3.6-flash" | "gemini-3.5-flash" | "gemini-3.5-flash-lite" | "gemini-3.1-flash-lite" | "gemini-2.5-flash" | "gemini-2.5-pro";
     choices: Choice[];
     usage: Usage$1;
 }
@@ -776,7 +776,7 @@ interface ClaudeV1MessagesCommand {
     context_management?: ClaudeContextManagement;
     options?: GenAIOptions$2E;
 }
-type ClaudeV1Models = "claude-opus-4-8" | "claude-opus-5" | "claude-sonnet-4-5" | "claude-sonnet-4-6" | "claude-sonnet-5" | "claude-haiku-4-5" | "claude-fable-5" | "claude-fable-5-1";
+type ClaudeV1Models = "claude-opus-4-8" | "claude-opus-5" | "claude-opus-5-5" | "claude-sonnet-4-5" | "claude-sonnet-4-6" | "claude-sonnet-5" | "claude-haiku-4-5" | "claude-fable-5" | "claude-fable-5-1";
 interface ClaudeMessageParam {
     role: string;
     content: ClaudeContentBlock[];
@@ -9603,7 +9603,7 @@ interface CatalogPreviewModel {
 
 interface ImageSegmentationCommand {
     image_url: string;
-    model: "picsart-multimatting-v13" | "picsart-sky-v1" | "preview-picsart-multimatting-v13" | "preview-picsart-sky-v1";
+    model?: "picsart-multimatting-v13" | "picsart-sky-v1";
     segmentation_class?: "all" | "background" | "hair" | "skin" | "lips" | "eyes" | "clothes" | "glasses" | "teeth" | "foreground";
     options?: GenAIOptions$C;
 }

package/index.d.ts

@@ -1754,6 +1754,7 @@ type ModelInputById = {
             video_input: boolean;
             signature: string;
         };
+        omniReferenceTaskType?: "auto" | "reference" | "edit" | "extend";
         imageUrls?: string[];
         videoUrls?: string[];
         audioUrls?: string[];
@@ -1798,6 +1799,7 @@ type ModelInputById = {
             video_input: boolean;
             signature: string;
         };
+        omniReferenceTaskType?: "auto" | "reference" | "edit" | "extend";
         imageUrls?: string[];
         videoUrls?: string[];
         audioUrls?: string[];
@@ -2779,6 +2781,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

@@ -4453,6 +4453,7 @@ var buildSeedance25PayloadFor = (modelAlias) => withSeedance25DraftMode(modelAli
   const refVideos = ctx.videoUrls ?? [];
   const refAudios = ctx.audioUrls ?? [];
   const usesFrame = Boolean(ctx.startFrame || ctx.endFrame);
+  const { omniReferenceTaskType } = ctx;
   return {
     model: modelAlias,
     content: [
@@ -4482,7 +4483,8 @@ var buildSeedance25PayloadFor = (modelAlias) => withSeedance25DraftMode(modelAli
     resolution: ctx.resolution ?? "1080p",
     generate_audio: ctx.generateAudio ?? true,
     output_format: seedance25OutputFormat(ctx),
-    ...ctx.returnLastFrame ? { return_last_frame: true } : {}
+    ...ctx.returnLastFrame ? { return_last_frame: true } : {},
+    ...omniReferenceTaskType !== void 0 ? { omni_reference_task_type: omniReferenceTaskType } : {}
   };
 });
 var buildSeedance25VideoEditPayloadFor = (modelAlias) => withSeedance25DraftMode(modelAlias, (ctx) => ({
@@ -4501,6 +4503,7 @@ var buildSeedance25VideoEditPayloadFor = (modelAlias) => withSeedance25DraftMode
   resolution: ctx.resolution ?? "1080p",
   generate_audio: ctx.generateAudio ?? true,
   output_format: seedance25OutputFormat(ctx),
+  omni_reference_task_type: "edit",
   ...ctx.returnLastFrame ? { return_last_frame: true } : {}
 }));
 var buildSeedance25VideoExtendPayloadFor = (modelAlias) => withSeedance25DraftMode(modelAlias, (ctx) => ({
@@ -4517,7 +4520,8 @@ var buildSeedance25VideoExtendPayloadFor = (modelAlias) => withSeedance25DraftMo
   duration: ctx.duration ?? 15,
   resolution: ctx.resolution ?? "1080p",
   generate_audio: ctx.generateAudio ?? true,
-  output_format: seedance25OutputFormat(ctx)
+  output_format: seedance25OutputFormat(ctx),
+  omni_reference_task_type: "extend"
 }));
 var SEEDANCE_AR = ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive"];
 var SEEDANCE_25_FORMATS = ["mp4", "mov"];
@@ -4545,6 +4549,23 @@ var seedance25DraftTaskParam = {
     }
   }
 };
+var seedance25TaskTypeParam = {
+  omniReferenceTaskType: {
+    label: "Task Type",
+    required: false,
+    descriptor: {
+      kind: "enum",
+      valueType: "string",
+      options: [
+        { id: "auto", label: "Auto" },
+        { id: "reference", label: "Reference" },
+        { id: "edit", label: "Edit" },
+        { id: "extend", label: "Extend" }
+      ],
+      default: "auto"
+    }
+  }
+};
 var { MODELS: MODELS13 } = defineModels("seedance", [
   {
     id: "seedance-2.5",
@@ -4573,6 +4594,7 @@ var { MODELS: MODELS13 } = defineModels("seedance", [
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
       ...seedance25DraftParam,
       ...seedance25DraftTaskParam,
+      ...seedance25TaskTypeParam,
       // 2.5 lifts the reference caps to 30 images / 10 videos / 10 audios.
       ...params.imageInput(30, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS),
       ...params.videoInputs(10, "Reference Videos", false, SEEDANCE_25_VIDEO_BOUNDS),
@@ -4612,6 +4634,7 @@ var { MODELS: MODELS13 } = defineModels("seedance", [
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
       ...seedance25DraftParam,
       ...seedance25DraftTaskParam,
+      ...seedance25TaskTypeParam,
       // 2.5 lifts the reference caps to 30 images / 10 videos / 10 audios.
       ...params.imageInput(30, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS),
       ...params.videoInputs(10, "Reference Videos", false, SEEDANCE_25_VIDEO_BOUNDS),
@@ -13084,11 +13107,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.19.0",
   "type": "module",
   "description": "Type-safe SDK for 100+ AI models — image, video, audio, and text generation with Picsart",
   "license": "MIT",