@picsart/ai-sdk 6.9.0 → 6.10.1

package/_vendor/workflows-types/index.d.ts

@@ -111,7 +111,7 @@ interface SpeakerVoiceConfig$2 {
     speaker: string;
     voiceConfig: VoiceConfig$2;
 }
-type GeminiModel$1 = "gemini-2.5-pro" | "gemini-2.5-flash" | "gemini-embedding-exp" | "gemini-3-pro" | "gemini-3-pro-preview" | "gemini-3.1-pro-preview" | "gemini-3.1-flash-lite" | "gemini-3.5-flash-lite" | "gemini-3.6-flash" | "gemini-3.7-flash" | "gemini-3.8-flash" | "gemini-3.1-flash-lite-preview";
+type GeminiModel$1 = "gemini-2.5-pro" | "gemini-2.5-flash" | "gemini-embedding-exp" | "gemini-2.5-flash-image" | "gemini-3-pro-image" | "gemini-3-pro-image-preview" | "gemini-3.1-flash-image" | "gemini-3.1-flash-image-preview" | "gemini-3-pro" | "gemini-3-pro-preview" | "gemini-3.1-pro-preview" | "gemini-3.1-flash-lite" | "gemini-3.5-flash-lite" | "gemini-3.6-flash" | "gemini-3.7-flash" | "gemini-3.8-flash" | "gemini-3.1-flash-lite-preview";
 interface GeminiResult$1 {
     id: string;
     status: "ACCEPTED" | "IN_PROGRESS" | "COMPLETED" | "FAILED";
@@ -476,7 +476,7 @@ interface SpeakerVoiceConfig$1 {
     speaker: string;
     voiceConfig: VoiceConfig$1;
 }
-type GeminiModel = "gemini-2.5-pro" | "gemini-2.5-flash" | "gemini-embedding-exp" | "gemini-3-pro" | "gemini-3-pro-preview" | "gemini-3.1-pro-preview" | "gemini-3.1-flash-lite" | "gemini-3.5-flash-lite" | "gemini-3.6-flash" | "gemini-3.7-flash" | "gemini-3.8-flash" | "gemini-3.1-flash-lite-preview";
+type GeminiModel = "gemini-2.5-pro" | "gemini-2.5-flash" | "gemini-embedding-exp" | "gemini-2.5-flash-image" | "gemini-3-pro-image" | "gemini-3-pro-image-preview" | "gemini-3.1-flash-image" | "gemini-3.1-flash-image-preview" | "gemini-3-pro" | "gemini-3-pro-preview" | "gemini-3.1-pro-preview" | "gemini-3.1-flash-lite" | "gemini-3.5-flash-lite" | "gemini-3.6-flash" | "gemini-3.7-flash" | "gemini-3.8-flash" | "gemini-3.1-flash-lite-preview";
 interface GeminiResult {
     id: string;
     status: "ACCEPTED" | "IN_PROGRESS" | "COMPLETED" | "FAILED";
@@ -776,7 +776,7 @@ interface ClaudeV1MessagesCommand {
     context_management?: ClaudeContextManagement;
     options?: GenAIOptions$2A;
 }
-type ClaudeV1Models = "claude-opus-4-8" | "claude-opus-5" | "claude-sonnet-4-5" | "claude-sonnet-4-6" | "claude-sonnet-5" | "claude-3-7-sonnet" | "claude-3-5-sonnet" | "claude-3-5-haiku-latest" | "claude-haiku-4-5" | "claude-sonnet-4-0" | "claude-opus-4-0" | "claude-opus-4-5" | "claude-fable-5" | "claude-fable-5-1";
+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";
 interface ClaudeMessageParam {
     role: string;
     content: ClaudeContentBlock[];
@@ -5568,6 +5568,7 @@ interface GeneratedImageResult$4 {
 interface SeedanceCommand {
     model?: SeedanceModelAlias;
     content?: ContentItem[];
+    draft?: boolean;
     resolution?: Resolution;
     ratio?: Ratio;
     output_format?: OutputFormat;
@@ -5585,9 +5586,10 @@ interface ContentItem {
     image_url?: ImageUrl;
     video_url?: VideoUrl;
     audio_url?: AudioUrl;
+    draft_task?: DraftTask;
     role?: FrameRole;
 }
-type ContentType = "text" | "image_url" | "video_url" | "audio_url";
+type ContentType = "text" | "image_url" | "video_url" | "audio_url" | "draft_task";
 interface ImageUrl {
     url: string;
 }
@@ -5597,6 +5599,11 @@ interface VideoUrl {
 interface AudioUrl {
     url: string;
 }
+interface DraftTask {
+    id: string;
+    video_input: boolean;
+    signature: string;
+}
 type FrameRole = "first_frame" | "last_frame" | "reference_image" | "reference_video" | "reference_audio";
 type Resolution = "480p" | "720p" | "1080p" | "4k";
 type Ratio = "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "adaptive";
@@ -5628,6 +5635,7 @@ interface GeneratedVideoResult$3 {
     video_url: string;
     last_frame_url?: string;
     output_format?: string;
+    draft_task?: Record<string, unknown>;
     mimeType?: string;
     driveFile?: Record<string, unknown>;
 }
@@ -8904,7 +8912,6 @@ interface SegmentAnythingSam3Command {
     prompt: string;
     score_threshold?: number;
     mask_threshold?: number;
-    model?: string;
 }
 interface SegmentAnythingSam3Response {
     id: string;
@@ -12118,6 +12125,96 @@ interface LTXV23ImageToVideoFastResponse {
     };
 }
 
+interface LTXV23ReframeVideoRequest {
+    resolution?: "720p" | "1080p";
+    aspect_ratio?: "1:1" | "4:5" | "5:4" | "9:16" | "16:9";
+    video_url: string;
+    options?: {
+        safety_checks?: {
+            enabled?: boolean;
+        };
+        drive?: {
+            name: string;
+            attributes?: Record<string, string>;
+            folder?: {
+                path?: string;
+                id?: string;
+            };
+        };
+    };
+}
+interface Ltx23ReframeResponse {
+    id: string;
+    status: "ACCEPTED" | "IN_PROGRESS" | "COMPLETED" | "FAILED";
+    result: LTXV23ReframeVideoResponse;
+}
+interface LTXV23ReframeVideoResponse {
+    video: {
+        content_type?: string | unknown;
+        fps?: number | unknown;
+        width?: number | unknown;
+        num_frames?: number | unknown;
+        file_size?: number | unknown;
+        file_name?: string | unknown;
+        duration?: number | unknown;
+        height?: number | unknown;
+        url: string;
+    };
+}
+
+interface LTX23QualityOutpaintInput {
+    guidance_scale?: number;
+    enable_prompt_expansion?: boolean;
+    num_inference_steps?: number;
+    prompt: string;
+    generate_audio?: boolean;
+    enable_safety_checker?: boolean;
+    frames_per_second?: number;
+    seed?: number | unknown;
+    video_url: string;
+    num_frames?: number;
+    resolution?: {
+        height?: number;
+        width?: number;
+    } | "auto" | "square_hd" | "square" | "portrait_4_3" | "portrait_16_9" | "landscape_4_3" | "landscape_16_9";
+    output_resolution?: "480p" | "720p" | "1080p";
+    negative_prompt?: string;
+    video_strength?: number;
+    aspect_ratio?: "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "9:21";
+    sync_mode?: boolean;
+    video_write_mode?: "fast" | "balanced" | "small";
+    video_quality?: "low" | "medium" | "high" | "maximum";
+    source_scale?: number;
+    options?: {
+        safety_checks?: {
+            enabled?: boolean;
+        };
+        drive?: {
+            name: string;
+            attributes?: Record<string, string>;
+            folder?: {
+                path?: string;
+                id?: string;
+            };
+        };
+    };
+}
+interface Ltx23QualityOutpaintResponse {
+    id: string;
+    status: "ACCEPTED" | "IN_PROGRESS" | "COMPLETED" | "FAILED";
+    result: LTX23QualityOutput;
+}
+interface LTX23QualityOutput {
+    prompt: string;
+    seed: number;
+    video: {
+        url: string;
+        content_type?: string | unknown;
+        file_size?: number | unknown;
+        file_name?: string | unknown;
+    };
+}
+
 interface WorkflowTypes {
     'check-text': {
         params: CheckTextCommand;
@@ -13227,6 +13324,14 @@ interface WorkflowTypes {
         params: LTXV25ImageToVideoFastRequest;
         result: LightricksLtx25ImageToVideoFastResponse;
     };
+    'ltx-2.3/reframe': {
+        params: LTXV23ReframeVideoRequest;
+        result: Ltx23ReframeResponse;
+    };
+    'ltx-2.3-quality/outpaint': {
+        params: LTX23QualityOutpaintInput;
+        result: Ltx23QualityOutpaintResponse;
+    };
 }
 
 export type { WorkflowTypes };

package/index.d.ts

@@ -862,6 +862,25 @@ type ModelInputById = {
         imageUrls?: string[];
         endFrame?: string;
     };
+    "ltx-v2.3-outpaint": {
+        prompt: string;
+        videoUrl: string;
+        negativePrompt?: string;
+        aspectRatio?: "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "9:21";
+        resolution?: "480p" | "720p" | "1080p";
+        numFrames?: number;
+        fps?: number;
+        sourceScale?: number;
+        videoStrength?: number;
+        cfgScale?: number;
+        numInferenceSteps?: number;
+        videoQuality?: "low" | "medium" | "high" | "maximum";
+        videoWriteMode?: "fast" | "balanced" | "small";
+        enhancePrompt?: boolean;
+        generateAudio?: boolean;
+        enableSafetyChecker?: boolean;
+        seed?: number;
+    };
     "ltx-v2.3-pro": {
         prompt: string;
         duration?: 6 | 8 | 10;
@@ -872,6 +891,11 @@ type ModelInputById = {
         imageUrls?: string[];
         endFrame?: string;
     };
+    "ltx-v2.3-reframe": {
+        videoUrl: string;
+        resolution?: "720p" | "1080p";
+        aspectRatio?: "16:9" | "9:16" | "1:1" | "4:5" | "5:4";
+    };
     "ltx-v2.3-retake": {
         prompt: string;
         duration?: number;
@@ -1583,7 +1607,7 @@ type ModelInputById = {
         videoUrls: [string, ...string[]];
     };
     "seedance-2.5": {
-        prompt: string;
+        prompt?: string;
         aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "adaptive";
         resolution?: "480p" | "720p" | "1080p";
         duration?: number;
@@ -1591,6 +1615,12 @@ type ModelInputById = {
         returnLastFrame?: boolean;
         outputFormat?: "mp4" | "mov";
         colorDepth?: "10bit" | "8bit";
+        draft?: boolean;
+        draftTask?: {
+            id: string;
+            video_input: boolean;
+            signature: string;
+        };
         imageUrls?: string[];
         videoUrls?: string[];
         audioUrls?: string[];
@@ -1605,6 +1635,7 @@ type ModelInputById = {
         returnLastFrame?: boolean;
         outputFormat?: "mp4" | "mov";
         colorDepth?: "10bit" | "8bit";
+        draft?: boolean;
         videoUrl: string;
         imageUrls?: string[];
     };
@@ -1616,10 +1647,11 @@ type ModelInputById = {
         generateAudio?: boolean;
         outputFormat?: "mp4" | "mov";
         colorDepth?: "10bit" | "8bit";
+        draft?: boolean;
         videoUrls: [string, ...string[]];
     };
     "seedance-2.5-without-moderation": {
-        prompt: string;
+        prompt?: string;
         aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "adaptive";
         resolution?: "480p" | "720p" | "1080p";
         duration?: number;
@@ -1627,6 +1659,12 @@ type ModelInputById = {
         returnLastFrame?: boolean;
         outputFormat?: "mp4" | "mov";
         colorDepth?: "10bit" | "8bit";
+        draft?: boolean;
+        draftTask?: {
+            id: string;
+            video_input: boolean;
+            signature: string;
+        };
         imageUrls?: string[];
         videoUrls?: string[];
         audioUrls?: string[];
@@ -1641,6 +1679,7 @@ type ModelInputById = {
         returnLastFrame?: boolean;
         outputFormat?: "mp4" | "mov";
         colorDepth?: "10bit" | "8bit";
+        draft?: boolean;
         videoUrl: string;
         imageUrls?: string[];
     };
@@ -1652,6 +1691,7 @@ type ModelInputById = {
         generateAudio?: boolean;
         outputFormat?: "mp4" | "mov";
         colorDepth?: "10bit" | "8bit";
+        draft?: boolean;
         videoUrls: [string, ...string[]];
     };
     "seedance-i2v": {
@@ -2683,6 +2723,17 @@ interface GenerateResultItemMetadata {
     /** URL of the generated video's last frame, when the model was asked for it
      *  (`returnLastFrame`, seedance) — the seed for frame-chaining flows. */
     lastFrameUrl?: string;
+    /** The draft a Seedance 2.5 Draft generation produced — pass it back
+     *  unchanged as `draftTask` to the matching `-draft-final` model to render
+     *  the final 1080p video (valid 7 days). Wire field names on purpose: the
+     *  worker signs it, so any change is rejected. */
+    draftTask?: SeedanceDraftTask;
+}
+/** A Seedance 2.5 draft reference, as the worker issues it. */
+interface SeedanceDraftTask {
+    id: string;
+    video_input: boolean;
+    signature: string;
 }
 
 /**
@@ -3121,7 +3172,9 @@ declare const Models: {
     readonly LtxV2Retake: "ltx-v2-retake";
     readonly LtxV23Extend: "ltx-v2.3-extend";
     readonly LtxV23Fast: "ltx-v2.3-fast";
+    readonly LtxV23Outpaint: "ltx-v2.3-outpaint";
     readonly LtxV23Pro: "ltx-v2.3-pro";
+    readonly LtxV23Reframe: "ltx-v2.3-reframe";
     readonly LtxV23Retake: "ltx-v2.3-retake";
     readonly LtxV25Fast: "ltx-v2.5-fast";
     readonly LtxV25Pro: "ltx-v2.5-pro";
@@ -3390,4 +3443,4 @@ declare const getModel: (id: string) => ModelDefinition | undefined;
  */
 declare const findModel: (ref: string) => ModelDefinition | undefined;
 
-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 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 GenerateResultItemMetadata, type GenerateTextResult, type GenerationContext, type GenerationEvent, GenerationEventType, type GenerationFile, type GenerationMode, type GenerationOptions, type GenerationProgress, type ListOptions, type MediaModelId, type MediaTypeFilter, Model, type ModelDefinition, type ModelDescriptor, type 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 TransportPollOptions, type TransportResult, type TypedModelId, type UserReaction, type ValidationResult, type VoiceOption, type WorkflowJobHandle, type WorkflowSubmitRequest, 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 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 GenerateResultItemMetadata, type GenerateTextResult, type GenerationContext, type GenerationEvent, GenerationEventType, type GenerationFile, type GenerationMode, type GenerationOptions, type GenerationProgress, type ListOptions, type MediaModelId, type MediaTypeFilter, Model, type ModelDefinition, type ModelDescriptor, type 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 SeedanceDraftTask, type TextDescriptor, type TextEntry, type TextModelId, type TextModelInputById, type ToolUsage, type TransportPollOptions, type TransportResult, type TypedModelId, type UserReaction, type ValidationResult, type VoiceOption, type WorkflowJobHandle, type WorkflowSubmitRequest, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, isVisibleForReleases, parseGeneration, releaseOf, toAvatarOption, toVoiceOption };

package/index.js

@@ -2111,6 +2111,10 @@ var LTX_RESOLUTIONS = ["1080p", "1440p", "2160p"];
 var LTX_23_AR = ["16:9", "9:16"];
 var LTX_23_FPS = [24, 25, 48, 50];
 var LTX_PROMPT_MAX = 5e3;
+var LTX_23_REFRAME_RESOLUTIONS = ["720p", "1080p"];
+var LTX_23_REFRAME_AR = ["16:9", "9:16", "1:1", "4:5", "5:4"];
+var LTX_23_OUTPAINT_RESOLUTIONS = ["480p", "720p", "1080p"];
+var LTX_23_OUTPAINT_AR = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16", "9:21"];
 var LTX_25_AR = ["16:9", "9:16"];
 var LTX_25_PRO_RESOLUTIONS = ["720p", "1080p"];
 var LTX_25_FAST_RESOLUTIONS = ["720p", "1080p", "1440p", "2160p"];
@@ -2412,6 +2416,60 @@ var { MODELS: MODELS2 } = defineModels("ltx", [
       ...params.videoInput("Source Video")
     }
   },
+  {
+    id: "ltx-v2.3-reframe",
+    name: "LTX 2.3 Reframe",
+    modelId: "fal-ai-ltx-2.3-reframe",
+    addedAt: "2026-09-23",
+    workflow: "ltx-2.3/reframe",
+    estimatedTime: 45,
+    mode: "video",
+    inputType: "v2v",
+    description: "Reframe a video into a new aspect ratio \u2014 the source is re-cropped and the newly exposed edges are generated to match. Takes no prompt.",
+    features: [feat("Video Input", "input"), feat("Aspect Ratio", "characteristic"), feat("Up to 1080p", "resolution")],
+    paramConfig: {
+      ...params.videoInput("Source Video", "asset", true),
+      ...params.resolution(LTX_23_REFRAME_RESOLUTIONS, "1080p"),
+      ...params.aspectRatio(LTX_23_REFRAME_AR)
+    }
+  },
+  {
+    // fal serves this one from the `ltx-2.3-quality` model id, hence the
+    // workflow path; `modelId` mirrors it so the pricing key reads the same.
+    id: "ltx-v2.3-outpaint",
+    name: "LTX 2.3 Outpaint",
+    modelId: "fal-ai-ltx-2.3-quality-outpaint",
+    addedAt: "2026-09-23",
+    workflow: "ltx-2.3-quality/outpaint",
+    estimatedTime: 180,
+    mode: "video",
+    inputType: "v2v",
+    description: "Expand a video past its original frame \u2014 the source stays put inside a wider canvas and the surrounding region is generated to match.",
+    features: [feat("Video Input", "input"), feat("Outpaint", "characteristic"), feat("Audio", "audio"), feat("Up to 1080p", "resolution")],
+    paramConfig: {
+      ...params.prompt({ maxLength: LTX_PROMPT_MAX }),
+      ...params.videoInput("Source Video", "asset", true),
+      ...params.negativePrompt(),
+      ...params.aspectRatio(LTX_23_OUTPAINT_AR),
+      ...params.resolution(LTX_23_OUTPAINT_RESOLUTIONS, "720p"),
+      ...p.range("numFrames", 9, 481, 121, { label: "Frames" }),
+      ...p.range("fps", 1, 60, 24, { label: "FPS" }),
+      // 1.0 fits the source as large as the canvas allows; lower values zoom it
+      // out and leave a wider generated border, which the vendor calls less stable.
+      ...p.range("sourceScale", 0.25, 1, 1, { step: 0.05, label: "Source Scale" }),
+      // How strongly the original content is preserved inside the new canvas.
+      ...p.range("videoStrength", 0, 1, 1, { step: 0.05, label: "Source Strength" }),
+      ...params.cfgScale(1, 20, 1),
+      ...p.range("numInferenceSteps", 8, 30, 15, { label: "Inference Steps" }),
+      ...p.enum("videoQuality", ["low", "medium", "high", "maximum"], "high", { label: "Video Quality" }),
+      ...p.enum("videoWriteMode", ["fast", "balanced", "small"], "balanced", { label: "Write Mode" }),
+      ...params.enhancePrompt(),
+      ...params.generateAudio(),
+      ...p.boolean("enableSafetyChecker", true, "Safety Checker"),
+      // Default-less on purpose: unset means the vendor picks a random seed.
+      ...params.seed()
+    }
+  },
   // ── LTX 2.5 ──────────────────────────────────────────────────────
   // One entry per tier: text-to-video on `workflow`, image-to-video on
   // `editWorkflow`. A start or end frame is what routes a call to the image
@@ -3993,7 +4051,61 @@ var seedance25OutputFormat = (ctx) => {
   if (ctx.outputFormat === "mov") return "mov";
   return ctx.colorDepth === "8bit" ? "mp4_8bit" : "mp4";
 };
-var buildSeedance25PayloadFor = (modelAlias) => (ctx) => {
+var SEEDANCE_25_DRAFT_RESOLUTION = "480p";
+var SEEDANCE_25_DRAFT_FINAL_RESOLUTION = "1080p";
+var withSeedance25DraftMode = (modelAlias, build) => (ctx) => {
+  const { draft, draftTask } = ctx;
+  if (draftTask) {
+    const sentContent = build(ctx).content ?? [];
+    return {
+      model: modelAlias,
+      content: [{ type: "draft_task", draft_task: draftTask }, ...sentContent],
+      resolution: ctx.resolution ?? SEEDANCE_25_DRAFT_FINAL_RESOLUTION,
+      output_format: seedance25OutputFormat(ctx),
+      ...ctx.returnLastFrame ? { return_last_frame: true } : {},
+      ...ctx.aspectRatio !== void 0 ? { ratio: ctx.aspectRatio } : {},
+      ...ctx.duration !== void 0 ? { duration: ctx.duration } : {},
+      ...ctx.generateAudio !== void 0 ? { generate_audio: ctx.generateAudio } : {},
+      ...draft !== void 0 ? { draft } : {}
+    };
+  }
+  const payload = build(ctx);
+  return draft ? { ...payload, draft: true, resolution: ctx.resolution ?? SEEDANCE_25_DRAFT_RESOLUTION } : payload;
+};
+var SEEDANCE_25_DRAFT_RESOLUTION_REASON = "Draft previews render at 480p only.";
+var SEEDANCE_25_DRAFT_FINAL_RESOLUTION_REASON = "The final video from a draft renders at 1080p only.";
+var SEEDANCE_25_DRAFT_REUSED_REASON = "A final from a draft reuses the draft's settings.";
+var seedance25DraftConstraints = [
+  {
+    when: { draft: { is: true } },
+    then: { resolution: { allowed: [SEEDANCE_25_DRAFT_RESOLUTION], reason: SEEDANCE_25_DRAFT_RESOLUTION_REASON } }
+  }
+];
+var seedance25DraftFinalConstraints = [
+  ...seedance25DraftConstraints,
+  {
+    when: { draftTask: { exists: true } },
+    then: {
+      resolution: { allowed: [SEEDANCE_25_DRAFT_FINAL_RESOLUTION], reason: SEEDANCE_25_DRAFT_FINAL_RESOLUTION_REASON },
+      draft: { disabled: true, reason: "A final video is rendered from a draft, not as one." },
+      ...Object.fromEntries([
+        "prompt",
+        "imageUrls",
+        "videoUrls",
+        "audioUrls",
+        "startFrame",
+        "endFrame",
+        "aspectRatio",
+        "duration",
+        "generateAudio"
+      ].map((key) => [
+        key,
+        { disabled: true, reason: SEEDANCE_25_DRAFT_REUSED_REASON }
+      ]))
+    }
+  }
+];
+var buildSeedance25PayloadFor = (modelAlias) => withSeedance25DraftMode(modelAlias, (ctx) => {
   const refImages = ctx.imageUrls ?? [];
   const refVideos = ctx.videoUrls ?? [];
   const refAudios = ctx.audioUrls ?? [];
@@ -4018,7 +4130,9 @@ var buildSeedance25PayloadFor = (modelAlias) => (ctx) => {
         role: "reference_audio"
       })),
       ...ctx.endFrame ? [{ type: "image_url", image_url: { url: ctx.endFrame }, role: "last_frame" }] : [],
-      { type: "text", text: ctx.prompt }
+      // The prompt is optional on 2.5 (media-only input is valid); an empty
+      // text item is not sent.
+      ...ctx.prompt?.trim() ? [{ type: "text", text: ctx.prompt }] : []
     ],
     ratio: usesFrame ? "adaptive" : ctx.aspectRatio ?? "16:9",
     duration: ctx.duration ?? 5,
@@ -4027,8 +4141,8 @@ var buildSeedance25PayloadFor = (modelAlias) => (ctx) => {
     output_format: seedance25OutputFormat(ctx),
     ...ctx.returnLastFrame ? { return_last_frame: true } : {}
   };
-};
-var buildSeedance25VideoEditPayloadFor = (modelAlias) => (ctx) => ({
+});
+var buildSeedance25VideoEditPayloadFor = (modelAlias) => withSeedance25DraftMode(modelAlias, (ctx) => ({
   model: modelAlias,
   content: [
     { type: "text", text: ctx.prompt },
@@ -4045,8 +4159,8 @@ var buildSeedance25VideoEditPayloadFor = (modelAlias) => (ctx) => ({
   generate_audio: ctx.generateAudio ?? true,
   output_format: seedance25OutputFormat(ctx),
   ...ctx.returnLastFrame ? { return_last_frame: true } : {}
-});
-var buildSeedance25VideoExtendPayloadFor = (modelAlias) => (ctx) => ({
+}));
+var buildSeedance25VideoExtendPayloadFor = (modelAlias) => withSeedance25DraftMode(modelAlias, (ctx) => ({
   model: modelAlias,
   content: [
     { type: "text", text: ctx.prompt },
@@ -4061,12 +4175,27 @@ var buildSeedance25VideoExtendPayloadFor = (modelAlias) => (ctx) => ({
   resolution: ctx.resolution ?? "1080p",
   generate_audio: ctx.generateAudio ?? true,
   output_format: seedance25OutputFormat(ctx)
-});
+}));
 var SEEDANCE_AR = ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive"];
 var SEEDANCE_25_FORMATS = ["mp4", "mov"];
 var SEEDANCE_25_COLOR_DEPTHS = ["10bit", "8bit"];
 var SEEDANCE_V2_DURATIONS = [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15];
 var SEEDANCE_25_DURATION = { min: 4, max: 30 };
+var seedance25DraftParam = p.boolean("draft", false, "Draft");
+var seedance25DraftTaskParam = {
+  draftTask: {
+    label: "Draft",
+    required: false,
+    descriptor: {
+      kind: "object",
+      fields: {
+        id: { kind: "text" },
+        video_input: { kind: "boolean", default: false },
+        signature: { kind: "text" }
+      }
+    }
+  }
+};
 var { MODELS: MODELS12 } = defineModels("seedance", [
   {
     id: "seedance-2.5",
@@ -4075,7 +4204,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     addedAt: "2026-08-06",
     workflow: "seedance",
     buildPayload: buildSeedance25PayloadFor("seedance_2_5"),
-    constraints: seedance25Constraints,
+    constraints: [...seedance25Constraints, ...seedance25DraftFinalConstraints],
     estimatedTime: 20,
     mode: "video",
     inputType: "t2v",
@@ -4083,7 +4212,9 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     description: "Latest cinematic video with audio, multi-reference input, and mp4/mov output in 10- or 8-bit. Up to 30s.",
     features: [feat("Reference Image", "frame"), feat("Start/End Frame", "frame"), feat("Audio", "audio"), feat("1080p", "resolution"), feat("4-30 sec", "duration")],
     paramConfig: {
-      ...params.prompt(),
+      // Optional on 2.5 (media-only input is valid) — and a final from a
+      // draft must not carry one (the vendor refuses it).
+      ...params.prompt({ required: false }),
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p", "1080p"], "1080p"),
       ...params.durationRange(SEEDANCE_25_DURATION.min, SEEDANCE_25_DURATION.max, 5),
@@ -4091,6 +4222,8 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
+      ...seedance25DraftParam,
+      ...seedance25DraftTaskParam,
       // 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),
@@ -4110,7 +4243,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     release: "preview",
     workflow: "seedance",
     buildPayload: buildSeedance25PayloadFor("seedance_2_5_without_moderation"),
-    constraints: seedance25Constraints,
+    constraints: [...seedance25Constraints, ...seedance25DraftFinalConstraints],
     estimatedTime: 20,
     mode: "video",
     inputType: "t2v",
@@ -4118,7 +4251,9 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     description: "Seedance 2.5 with vendor moderation disabled \u2014 cinematic video with audio, multi-reference input, and mp4/mov output in 10- or 8-bit. Up to 30s.",
     features: [feat("Reference Image", "frame"), feat("Start/End Frame", "frame"), feat("Audio", "audio"), feat("1080p", "resolution"), feat("4-30 sec", "duration")],
     paramConfig: {
-      ...params.prompt(),
+      // Optional on 2.5 (media-only input is valid) — and a final from a
+      // draft must not carry one (the vendor refuses it).
+      ...params.prompt({ required: false }),
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p", "1080p"], "1080p"),
       ...params.durationRange(SEEDANCE_25_DURATION.min, SEEDANCE_25_DURATION.max, 5),
@@ -4126,6 +4261,8 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
+      ...seedance25DraftParam,
+      ...seedance25DraftTaskParam,
       // 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),
@@ -4141,7 +4278,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     addedAt: "2026-08-06",
     workflow: "seedance",
     buildPayload: buildSeedance25VideoEditPayloadFor("seedance_2_5"),
-    constraints: seedance25ColorDepthConstraints,
+    constraints: [...seedance25ColorDepthConstraints, ...seedance25DraftConstraints],
     estimatedTime: 60,
     mode: "video",
     inputType: "v2v",
@@ -4158,6 +4295,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
+      ...seedance25DraftParam,
       // Every limit rides in `bounds`; the positional maxDuration / maxShortSide
       // / maxBytes args predate it and are skipped rather than duplicated.
       ...params.videoInput("Source Video", "reference", true, void 0, void 0, void 0, SEEDANCE_25_VIDEO_BOUNDS),
@@ -4172,7 +4310,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     release: "preview",
     workflow: "seedance",
     buildPayload: buildSeedance25VideoEditPayloadFor("seedance_2_5_without_moderation"),
-    constraints: seedance25ColorDepthConstraints,
+    constraints: [...seedance25ColorDepthConstraints, ...seedance25DraftConstraints],
     estimatedTime: 60,
     mode: "video",
     inputType: "v2v",
@@ -4189,6 +4327,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
+      ...seedance25DraftParam,
       // Every limit rides in `bounds`; the positional maxDuration / maxShortSide
       // / maxBytes args predate it and are skipped rather than duplicated.
       ...params.videoInput("Source Video", "reference", true, void 0, void 0, void 0, SEEDANCE_25_VIDEO_BOUNDS),
@@ -4202,7 +4341,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     addedAt: "2026-08-06",
     workflow: "seedance",
     buildPayload: buildSeedance25VideoExtendPayloadFor("seedance_2_5"),
-    constraints: seedance25ColorDepthConstraints,
+    constraints: [...seedance25ColorDepthConstraints, ...seedance25DraftConstraints],
     estimatedTime: 200,
     mode: "video",
     inputType: "v2v",
@@ -4219,6 +4358,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.generateAudio(),
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
+      ...seedance25DraftParam,
       ...params.videoInputs(10, "Source Videos", true, SEEDANCE_25_VIDEO_BOUNDS)
     }
   },
@@ -4230,7 +4370,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     release: "preview",
     workflow: "seedance",
     buildPayload: buildSeedance25VideoExtendPayloadFor("seedance_2_5_without_moderation"),
-    constraints: seedance25ColorDepthConstraints,
+    constraints: [...seedance25ColorDepthConstraints, ...seedance25DraftConstraints],
     estimatedTime: 200,
     mode: "video",
     inputType: "v2v",
@@ -4247,6 +4387,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.generateAudio(),
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
+      ...seedance25DraftParam,
       ...params.videoInputs(10, "Source Videos", true, SEEDANCE_25_VIDEO_BOUNDS)
     }
   },
@@ -9800,9 +9941,35 @@ var buildLtx25FastI2VPayload = (input) => ({
   ...input.cameraMotion && input.cameraMotion !== "none" ? { camera_motion: input.cameraMotion } : {},
   generate_audio: input.generateAudio ?? true
 });
+var buildLtx23ReframePayload = (input) => ({
+  video_url: input.videoUrl,
+  ...input.resolution ? { resolution: input.resolution } : {},
+  ...input.aspectRatio ? { aspect_ratio: input.aspectRatio } : {}
+});
+var buildLtx23OutpaintPayload = (input) => ({
+  prompt: input.prompt,
+  video_url: input.videoUrl,
+  ...input.negativePrompt ? { negative_prompt: input.negativePrompt } : {},
+  ...input.aspectRatio ? { aspect_ratio: input.aspectRatio } : {},
+  ...input.resolution ? { output_resolution: input.resolution } : {},
+  ...input.numFrames != null ? { num_frames: input.numFrames } : {},
+  ...input.fps != null ? { frames_per_second: input.fps } : {},
+  ...input.sourceScale != null ? { source_scale: input.sourceScale } : {},
+  ...input.videoStrength != null ? { video_strength: input.videoStrength } : {},
+  ...input.cfgScale != null ? { guidance_scale: input.cfgScale } : {},
+  ...input.numInferenceSteps != null ? { num_inference_steps: input.numInferenceSteps } : {},
+  ...input.videoQuality ? { video_quality: input.videoQuality } : {},
+  ...input.videoWriteMode ? { video_write_mode: input.videoWriteMode } : {},
+  ...input.seed != null ? { seed: input.seed } : {},
+  enable_prompt_expansion: input.enhancePrompt ?? true,
+  generate_audio: input.generateAudio ?? true,
+  enable_safety_checker: input.enableSafetyChecker ?? true
+});
 registerPayloads(MODELS2, {
   "ltx-v2.5-pro": buildLtx25ProT2VPayload,
-  "ltx-v2.5-fast": buildLtx25FastT2VPayload
+  "ltx-v2.5-fast": buildLtx25FastT2VPayload,
+  "ltx-v2.3-reframe": buildLtx23ReframePayload,
+  "ltx-v2.3-outpaint": buildLtx23OutpaintPayload
 });
 registerEditPayloads(MODELS2, {
   "ltx-v2.5-pro": buildLtx25ProI2VPayload,
@@ -10084,6 +10251,10 @@ var extractAllResults = (result) => {
   }
   return items.length > 0 ? items : void 0;
 };
+var isSeedanceDraftTask = (value) => {
+  const v = value;
+  return !!v && typeof v === "object" && typeof v.id === "string" && typeof v.video_input === "boolean" && typeof v.signature === "string";
+};
 function buildItemMetadata(parsed, item, _index, provider) {
   const meta = {};
   const top = parsed && typeof parsed === "object" ? parsed : void 0;
@@ -10092,6 +10263,10 @@ function buildItemMetadata(parsed, item, _index, provider) {
   if (provider === "elevenlabs" && typeof it?.generated_voice_id === "string") meta.generatedVoiceId = it.generated_voice_id;
   const lastFrame = it?.last_frame_url ?? top?.last_frame_url;
   if (typeof lastFrame === "string") meta.lastFrameUrl = lastFrame;
+  const draftTask = top?.draft_task;
+  if (provider === "seedance" && isSeedanceDraftTask(draftTask)) {
+    meta.draftTask = { id: draftTask.id, video_input: draftTask.video_input, signature: draftTask.signature };
+  }
   return Object.keys(meta).length > 0 ? meta : void 0;
 }
 function toCompletedStatus(handle, result, raw, usage) {
@@ -12472,7 +12647,9 @@ var LtxV2Fast = "ltx-v2-fast";
 var LtxV2Retake = "ltx-v2-retake";
 var LtxV23Extend = "ltx-v2.3-extend";
 var LtxV23Fast = "ltx-v2.3-fast";
+var LtxV23Outpaint = "ltx-v2.3-outpaint";
 var LtxV23Pro = "ltx-v2.3-pro";
+var LtxV23Reframe = "ltx-v2.3-reframe";
 var LtxV23Retake = "ltx-v2.3-retake";
 var LtxV25Fast = "ltx-v2.5-fast";
 var LtxV25Pro = "ltx-v2.5-pro";
@@ -12715,7 +12892,9 @@ var Models = {
   LtxV2Retake,
   LtxV23Extend,
   LtxV23Fast,
+  LtxV23Outpaint,
   LtxV23Pro,
+  LtxV23Reframe,
   LtxV23Retake,
   LtxV25Fast,
   LtxV25Pro,

package/package.json

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