@picsart/ai-sdk 6.43.0 → 6.44.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/index.d.ts +10 -0
  2. package/index.js +47 -2
  3. package/package.json +1 -1
package/index.d.ts CHANGED
@@ -359,6 +359,15 @@ type ModelInputById = {
359
359
  imageUrls?: string[];
360
360
  safetyTolerance?: number;
361
361
  };
362
+ "flux-3-image-klein": {
363
+ prompt: string;
364
+ aspectRatio?: "auto" | "21:9" | "2:1" | "16:9" | "3:2" | "7:5" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "5:7" | "2:3" | "9:16" | "9:21" | "1:2";
365
+ resolution?: "768sq" | "1k" | "1.5k" | "2k" | "4k";
366
+ count?: 1 | 2 | 4 | 6 | 8 | 10;
367
+ imageUrls?: string[];
368
+ steps?: number;
369
+ safetyTolerance?: number;
370
+ };
362
371
  "flux-3-video": {
363
372
  prompt: string;
364
373
  aspectRatio?: "auto" | "21:9" | "2:1" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
@@ -3563,6 +3572,7 @@ declare const Models: {
3563
3572
  readonly Flux2Max: "flux-2-max";
3564
3573
  readonly Flux2Pro: "flux-2-pro";
3565
3574
  readonly Flux3Image: "flux-3-image";
3575
+ readonly Flux3ImageKlein: "flux-3-image-klein";
3566
3576
  readonly Flux3Video: "flux-3-video";
3567
3577
  readonly FluxKontextMax: "flux-kontext-max";
3568
3578
  readonly FluxKontextPro: "flux-kontext-pro";
package/index.js CHANGED
@@ -6529,6 +6529,49 @@ var { MODELS: MODELS21 } = defineModels("flux", [
6529
6529
  ...p.range("safetyTolerance", 0, 4, 2, { label: "Safety Tolerance" })
6530
6530
  }
6531
6531
  },
6532
+ {
6533
+ // Distilled "Klein" tier of FLUX 3 Image. Same contract as flux-3-image —
6534
+ // a pure pass-through, since every Command field already carries the SDK's
6535
+ // unified name (prompt, imageUrls, aspectRatio, resolution, count,
6536
+ // safetyTolerance) — with two deltas: a `steps` knob (1–16 denoising steps
6537
+ // for the distilled model; fewer is faster and it does not affect cost) and
6538
+ // a wider safetyTolerance range (0–7 vs the 0–4 of flux-3-image). As with
6539
+ // flux-3-image, supplying imageUrls switches the vendor into editing mode
6540
+ // (hence inputType 't2i'), `version` pins the endpoint contract and is not
6541
+ // surfaced, and `options` is dropped.
6542
+ id: "flux-3-image-klein",
6543
+ name: "Flux 3 Image Klein",
6544
+ workflow: "bfl/v1/flux-3-image-klein",
6545
+ mode: "image",
6546
+ inputType: "t2i",
6547
+ addedAt: "2026-10-16",
6548
+ badge: ["fast"],
6549
+ // Klein is the distilled/low-step tier, so it generates faster than
6550
+ // flux-3-image. Reuse that model's per-tier map as a safe upper bound —
6551
+ // over-estimating only finishes the bar early; tighten once stage
6552
+ // measurements land.
6553
+ estimatedTime: { "768sq": 110, "1k": 150, "1.5k": 195, "2k": 240, "4k": 360 },
6554
+ description: "Distilled, faster FLUX 3 Image \u2014 generate and edit with up to 10 references, with a steps control to trade speed for detail, natively up to 4K.",
6555
+ features: [
6556
+ feat("Multi-Image Input", "input"),
6557
+ feat("4K", "resolution")
6558
+ ],
6559
+ paramConfig: {
6560
+ ...params.prompt(),
6561
+ ...params.aspectRatio(flux3ImageAspectRatios, "auto"),
6562
+ ...params.resolution(flux3ImageResolutions, "1k"),
6563
+ ...params.count(),
6564
+ // Up to 10 references; the first one drives the output ratio while
6565
+ // aspectRatio is 'auto'.
6566
+ ...params.imageInput(10, "Reference Images", false, "reference"),
6567
+ // Denoising steps for the distilled Klein model: 1 (fastest) … 16.
6568
+ // Vendor default is 16; does not affect cost (priced per resolution tier).
6569
+ ...p.range("steps", 1, 16, 16, { label: "Steps" }),
6570
+ // Moderation level: 0 (strict) … 7 (permissive). Wider than the 0–4 of
6571
+ // flux-3-image.
6572
+ ...p.range("safetyTolerance", 0, 7, 2, { label: "Safety Tolerance" })
6573
+ }
6574
+ },
6532
6575
  {
6533
6576
  // Single workflow `flux/v1/video` derives its mode from the input it's
6534
6577
  // given: none → t2v, keyframe images → i2v, a start video → v2v. No
@@ -6571,13 +6614,13 @@ var { MODELS: MODELS21 } = defineModels("flux", [
6571
6614
  // payload builder needed. webhookUrl is polling plumbing, not surfaced
6572
6615
  // (same as flux-3-video).
6573
6616
  id: "flux-video-upscale",
6574
- name: "Flux Video Upscale",
6617
+ name: "Flux 3 Video Upscale",
6575
6618
  workflow: "flux/v1/video-upscale",
6576
6619
  mode: "video",
6577
6620
  inputType: "v2v",
6578
6621
  addedAt: "2026-08-28",
6579
6622
  estimatedTime: 180,
6580
- description: "Upscale videos toward 4K (1.5x\u20133x) in precise (source-faithful) or creative (detail-enhancing) mode. Source clips up to 20 seconds and 2K.",
6623
+ description: "FLUX 3 powered video upscale toward 4K (1.5x\u20133x) in precise (source-faithful) or creative (detail-enhancing) mode. Source clips up to 20 seconds and 2K.",
6581
6624
  features: [
6582
6625
  feat("Upscale", "quality"),
6583
6626
  feat("Video Required", "input"),
@@ -15089,6 +15132,7 @@ var Flux2Flex = "flux-2-flex";
15089
15132
  var Flux2Max = "flux-2-max";
15090
15133
  var Flux2Pro = "flux-2-pro";
15091
15134
  var Flux3Image = "flux-3-image";
15135
+ var Flux3ImageKlein = "flux-3-image-klein";
15092
15136
  var Flux3Video = "flux-3-video";
15093
15137
  var FluxKontextMax = "flux-kontext-max";
15094
15138
  var FluxKontextPro = "flux-kontext-pro";
@@ -15359,6 +15403,7 @@ var Models = {
15359
15403
  Flux2Max,
15360
15404
  Flux2Pro,
15361
15405
  Flux3Image,
15406
+ Flux3ImageKlein,
15362
15407
  Flux3Video,
15363
15408
  FluxKontextMax,
15364
15409
  FluxKontextPro,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@picsart/ai-sdk",
3
- "version": "6.43.0",
3
+ "version": "6.44.0",
4
4
  "type": "module",
5
5
  "description": "Type-safe SDK for 100+ AI models — image, video, audio, and text generation with Picsart",
6
6
  "license": "MIT",