@picsart/ai-sdk 6.17.1 → 6.18.0

package/index.d.ts

@@ -183,6 +183,16 @@ type ModelInputById = {
     "eleven-audio-isolation": {
         audioUrl: string;
     };
+    "eleven-dialogue-v4": {
+        dialogue: Array<{
+            voiceId: string;
+            text: string;
+        }>;
+        stability?: number;
+        similarity?: number;
+        language?: string;
+        seed?: number;
+    };
     "eleven-dubbing": {
         audioUrl: string;
         language: string;
@@ -244,6 +254,22 @@ type ModelInputById = {
         useSpeakerBoost?: boolean;
         withTimestamps?: boolean;
     };
+    "eleven-v4": {
+        language?: string;
+        prompt: string;
+        voiceId?: string;
+        stability?: number;
+        similarityBoost?: number;
+        withTimestamps?: boolean;
+    };
+    "eleven-v4-turbo": {
+        language?: string;
+        prompt: string;
+        voiceId?: string;
+        stability?: number;
+        similarityBoost?: number;
+        withTimestamps?: boolean;
+    };
     "eleven-video-to-music": {
         videoUrls: [string, ...string[]];
         prompt?: string;
@@ -3225,6 +3251,7 @@ declare const Models: {
     readonly CreatifyAurora: "creatify-aurora";
     readonly CreatifyBoreal: "creatify-boreal";
     readonly ElevenAudioIsolation: "eleven-audio-isolation";
+    readonly ElevenDialogueV4: "eleven-dialogue-v4";
     readonly ElevenDubbing: "eleven-dubbing";
     readonly ElevenMultilingualStsV2: "eleven-multilingual-sts-v2";
     readonly ElevenMultilingualV2: "eleven-multilingual-v2";
@@ -3232,6 +3259,8 @@ declare const Models: {
     readonly ElevenStsV2: "eleven-sts-v2";
     readonly ElevenTextToDialogue: "eleven-text-to-dialogue";
     readonly ElevenV3: "eleven-v3";
+    readonly ElevenV4: "eleven-v4";
+    readonly ElevenV4Turbo: "eleven-v4-turbo";
     readonly ElevenVideoToMusic: "eleven-video-to-music";
     readonly ElevenVoiceCreate: "eleven-voice-create";
     readonly ElevenVoiceDesignV2: "eleven-voice-design-v2";

package/index.js

@@ -7146,7 +7146,7 @@ var buildElevenLabsVoicePreviewsPayload = (ctx) => ({
   voice_description: ctx.prompt,
   auto_generate_text: true
 });
-var voiceSettingsParams = (withSpeakerBoost) => ({
+var stabilityAndSimilarityParams = {
   stability: {
     label: "Stability",
     descriptor: { kind: "range", min: 0, max: 1, step: 0.05 }
@@ -7154,7 +7154,10 @@ var voiceSettingsParams = (withSpeakerBoost) => ({
   similarityBoost: {
     label: "Similarity",
     descriptor: { kind: "range", min: 0, max: 1, step: 0.05 }
-  },
+  }
+};
+var voiceSettingsParams = (withSpeakerBoost) => ({
+  ...stabilityAndSimilarityParams,
   // `style` is taken on GenerationContext by the image models' style *name*,
   // so the vendor's 0–1 style exaggeration gets a key of its own.
   styleExaggeration: {
@@ -7167,21 +7170,69 @@ var voiceSettingsParams = (withSpeakerBoost) => ({
   },
   ...withSpeakerBoost ? { useSpeakerBoost: { label: "Speaker Boost", descriptor: { kind: "boolean", default: true } } } : {}
 });
-var ttsParamConfig = (promptMaxLength, withLanguage) => ({
-  // language_code is honoured by eleven_v3 only — the vendor documents it as
+var ttsParamConfig = (promptMaxLength, opts) => ({
+  // language_code is honoured by eleven_v3 and v4 — the vendor documents it as
   // "not supported for multilingual_v2 models" (silently ignored there).
   // No accent param anywhere: no builder ever read it.
-  ...withLanguage ? params.language(false) : {},
+  ...opts.language ? params.language(false) : {},
   ...params.prompt({ maxLength: promptMaxLength }),
   ...params.voiceId([], DEFAULT_VOICE_ID, { catalog: VOICE_CATALOG }),
-  ...voiceSettingsParams(true),
+  ...opts.styleControls ? voiceSettingsParams(true) : stabilityAndSimilarityParams,
   // Timings come back beside the audio, for captions and lip sync. Off by
   // default: the vendor answers a different route that inlines the audio as
   // base64, and callers who do not need timings should not pay the decode.
   ...p.boolean("withTimestamps", false, "Character Timings")
 });
+var dialogueLinesParam = (maxLength) => ({
+  dialogue: {
+    label: "Dialogue",
+    required: true,
+    descriptor: {
+      kind: "object",
+      array: { min: 1 },
+      fields: {
+        // A plain id, not a catalog-bound picker: catalog loading resolves
+        // top-level params only. Every ElevenLabs model shares one voices
+        // task, so a caller lists them from any TTS model — e.g.
+        // `ai.catalogs.voices('eleven-v4')` — and uses the ids here.
+        voiceId: { label: "Voice ID", kind: "text", placeholder: DEFAULT_VOICE_ID },
+        text: { label: "Line", kind: "text", maxLength }
+      }
+    }
+  }
+});
 var { MODELS: MODELS24 } = defineModels("elevenlabs", [
   // ── TTS ───────────────────────────────────────────────────────────
+  {
+    id: "eleven-v4",
+    name: "Eleven v4",
+    modelId: "eleven_v4",
+    addedAt: "2026-09-29",
+    workflow: "elevenlabs/v1/text-to-speech",
+    estimatedTime: 10,
+    mode: "audio",
+    inputType: "tts",
+    badge: ["new", "popular"],
+    description: "Most expressive voice engine \u2014 audio tags direct the delivery, 90+ languages.",
+    features: [feat("Audio Tags", "characteristic"), feat("90+ Languages", "characteristic"), feat("Creative Control", "characteristic")],
+    paramConfig: ttsParamConfig(1e4, { language: true, styleControls: false })
+  },
+  {
+    // Same engine family tuned for latency; the vendor bills it at half the
+    // per-character rate of eleven_v4.
+    id: "eleven-v4-turbo",
+    name: "Eleven v4 Turbo",
+    modelId: "eleven_v4_turbo",
+    addedAt: "2026-09-29",
+    workflow: "elevenlabs/v1/text-to-speech",
+    estimatedTime: 6,
+    mode: "audio",
+    inputType: "tts",
+    badge: ["new", "fast"],
+    description: "Eleven v4 tuned for speed \u2014 the same audio tags and languages, lower latency.",
+    features: [feat("Audio Tags", "characteristic"), feat("90+ Languages", "characteristic"), feat("Low Latency", "characteristic")],
+    paramConfig: ttsParamConfig(1e4, { language: true, styleControls: false })
+  },
   {
     id: "eleven-v3",
     name: "Eleven v3",
@@ -7192,9 +7243,9 @@ var { MODELS: MODELS24 } = defineModels("elevenlabs", [
     mode: "audio",
     inputType: "tts",
     badge: ["popular"],
-    description: "Latest voice engine with expanded tone and pacing control.",
+    description: "Previous-generation expressive engine with expanded tone and pacing control.",
     features: [feat("Experimental", "characteristic"), feat("Creative Control", "characteristic")],
-    paramConfig: ttsParamConfig(5e3, true)
+    paramConfig: ttsParamConfig(5e3, { language: true, styleControls: true })
   },
   {
     id: "eleven-multilingual-v2",
@@ -7208,9 +7259,40 @@ var { MODELS: MODELS24 } = defineModels("elevenlabs", [
     badge: ["popular", "fast"],
     description: "Stable multilingual speech across 29+ languages with natural rhythm.",
     features: [feat("Stable", "characteristic"), feat("Professional", "characteristic")],
-    paramConfig: ttsParamConfig(1e4, false)
+    paramConfig: ttsParamConfig(1e4, { language: false, styleControls: true })
   },
   // ── Dialogue ──────────────────────────────────────────────────────
+  {
+    // Same pricing key as the v3 dialogue below: the worker bills every
+    // dialogue engine per minute under `eleven-text-to-dialogue`.
+    id: "eleven-dialogue-v4",
+    name: "Eleven Dialogue v4",
+    modelId: "eleven-text-to-dialogue",
+    addedAt: "2026-09-29",
+    workflow: "elevenlabs/v1/text-to-dialogue",
+    estimatedTime: 12,
+    mode: "audio",
+    inputType: "tts",
+    badge: ["new"],
+    description: "Multi-speaker conversation on the v4 engine \u2014 a voice per line, audio tags per line.",
+    features: [feat("Multi-Speaker", "characteristic"), feat("Audio Tags", "characteristic"), feat("90+ Languages", "characteristic")],
+    paramConfig: {
+      ...dialogueLinesParam(1e4),
+      // v4 reads the whole 0–1 range (no presets), and the dialogue endpoint
+      // names its similarity knob `similarity`, not `similarity_boost`.
+      // Both default-less: unset keeps the vendor's 0.5 / 0.75.
+      stability: {
+        label: "Stability",
+        descriptor: { kind: "range", min: 0, max: 1, step: 0.05 }
+      },
+      similarity: {
+        label: "Similarity",
+        descriptor: { kind: "range", min: 0, max: 1, step: 0.05 }
+      },
+      ...params.language(false),
+      ...params.seed(4294967295)
+    }
+  },
   {
     // `modelId` is the pricing-catalog key, not the vendor id: the worker
     // registers the operation as `eleven-text-to-dialogue` while the vendor
@@ -7226,33 +7308,7 @@ var { MODELS: MODELS24 } = defineModels("elevenlabs", [
     description: "Generate a multi-speaker conversation \u2014 a voice per line \u2014 in one take.",
     features: [feat("Multi-Speaker", "characteristic"), feat("Creative Control", "characteristic")],
     paramConfig: {
-      // One entry per spoken line, in order. The vendor publishes no cap on the
-      // number of lines, so none is invented here.
-      //
-      // The 5,000-character limit is the vendor's hard cap and applies to the
-      // dialogue AS A WHOLE, which a per-field maxLength cannot express — a
-      // single line simply cannot exceed it either. Probed against the live
-      // `elevenlabs/v1/text-to-dialogue` worker: 10,000 characters are refused
-      // with "Request text length (10000) exceeds the maximum text length of
-      // 5000 characters", while 2,600 generate fine. The docs' "keep it at or
-      // below 2,000" is guidance, not a limit. Note the far end is slow: a
-      // 5,000-character dialogue outruns the worker's 120s vendor timeout.
-      dialogue: {
-        label: "Dialogue",
-        required: true,
-        descriptor: {
-          kind: "object",
-          array: { min: 1 },
-          fields: {
-            // A plain id, not a catalog-bound picker: catalog loading resolves
-            // top-level params only. Every ElevenLabs model shares one voices
-            // task, so a caller lists them from any TTS model — e.g.
-            // `ai.catalogs.voices('eleven-v3')` — and uses the ids here.
-            voiceId: { label: "Voice ID", kind: "text", placeholder: DEFAULT_VOICE_ID },
-            text: { label: "Line", kind: "text", maxLength: 5e3 }
-          }
-        }
-      },
+      ...dialogueLinesParam(5e3),
       // The vendor takes any 0–1 double and defaults to 0.5; eleven_v3 reads the
       // three presets below, so the picker offers those instead of a slider
       // whose in-between values the engine rounds anyway.
@@ -7528,16 +7584,39 @@ var buildElevenLabsSTSPayload = (modelId) => (input) => ({
   remove_background_noise: input.removeBackgroundNoise ?? false,
   ...voiceSettings(input)
 });
-var buildElevenLabsDialoguePayload = (input) => ({
-  conversation: input.dialogue.map((line) => ({
-    voice_id: line.voiceId,
-    text: line.text
-  })),
-  model_id: "eleven_v3",
-  ...input.stability != null ? { settings: { stability: input.stability } } : {},
-  ...input.language ? { language_code: input.language } : {},
-  ...input.seed != null ? { seed: input.seed } : {}
-});
+var buildElevenLabsDialoguePayload = (catalogId, modelId) => (input) => {
+  const cap = dialogueCharacterCap(catalogId);
+  const total = input.dialogue.reduce((sum, line) => sum + line.text.length, 0);
+  if (total > cap) {
+    throw new ApiError(
+      `${catalogId}: the dialogue as a whole exceeds ${cap} characters (got ${total}).`,
+      { status: 400, code: "validation_error" }
+    );
+  }
+  const settings = {
+    ...input.stability != null ? { stability: input.stability } : {},
+    ...input.similarity != null ? { similarity: input.similarity } : {}
+  };
+  return {
+    conversation: input.dialogue.map((line) => ({
+      voice_id: line.voiceId,
+      text: line.text
+    })),
+    model_id: modelId,
+    ...Object.keys(settings).length > 0 ? { settings } : {},
+    ...input.language ? { language_code: input.language } : {},
+    ...input.seed != null ? { seed: input.seed } : {}
+  };
+};
+function dialogueCharacterCap(catalogId) {
+  const descriptor = MODELS24.find((m) => m.id === catalogId)?.paramConfig.dialogue?.descriptor;
+  const text = descriptor?.kind === "object" ? descriptor.fields.text : void 0;
+  const cap = text && "maxLength" in text ? text.maxLength : void 0;
+  if (typeof cap !== "number") {
+    throw new Error(`${catalogId}: dialogue entry declares no per-line maxLength to derive the cap from`);
+  }
+  return cap;
+}
 var buildElevenLabsTranscribePayload = (input) => ({
   audio_url: input.audioUrl,
   ...input.language ? { language_code: input.language } : {},
@@ -7555,11 +7634,14 @@ var buildElevenLabsVideoToMusicPayload = (input) => ({
 });
 registerPayloads(MODELS24, {
   "elevenlabs-music-v2": buildElevenLabsMusicPayload,
+  "eleven-v4": buildElevenLabsTTSPayload("eleven_v4"),
+  "eleven-v4-turbo": buildElevenLabsTTSPayload("eleven_v4_turbo"),
   "eleven-v3": buildElevenLabsTTSPayload("eleven_v3"),
   "eleven-multilingual-v2": buildElevenLabsTTSPayload("eleven_multilingual_v2"),
   "eleven-sts-v2": buildElevenLabsSTSPayload("eleven_english_sts_v2"),
   "eleven-multilingual-sts-v2": buildElevenLabsSTSPayload("eleven_multilingual_sts_v2"),
-  "eleven-text-to-dialogue": buildElevenLabsDialoguePayload,
+  "eleven-text-to-dialogue": buildElevenLabsDialoguePayload("eleven-text-to-dialogue", "eleven_v3"),
+  "eleven-dialogue-v4": buildElevenLabsDialoguePayload("eleven-dialogue-v4", "eleven_v4"),
   "eleven-speech-to-text": buildElevenLabsTranscribePayload,
   "eleven-video-to-music": buildElevenLabsVideoToMusicPayload
 });
@@ -13239,6 +13321,7 @@ var ClaudeSonnet5 = "claude-sonnet-5";
 var CreatifyAurora = "creatify-aurora";
 var CreatifyBoreal = "creatify-boreal";
 var ElevenAudioIsolation = "eleven-audio-isolation";
+var ElevenDialogueV4 = "eleven-dialogue-v4";
 var ElevenDubbing = "eleven-dubbing";
 var ElevenMultilingualStsV2 = "eleven-multilingual-sts-v2";
 var ElevenMultilingualV2 = "eleven-multilingual-v2";
@@ -13246,6 +13329,8 @@ var ElevenSpeechToText = "eleven-speech-to-text";
 var ElevenStsV2 = "eleven-sts-v2";
 var ElevenTextToDialogue = "eleven-text-to-dialogue";
 var ElevenV3 = "eleven-v3";
+var ElevenV4 = "eleven-v4";
+var ElevenV4Turbo = "eleven-v4-turbo";
 var ElevenVideoToMusic = "eleven-video-to-music";
 var ElevenVoiceCreate = "eleven-voice-create";
 var ElevenVoiceDesignV2 = "eleven-voice-design-v2";
@@ -13494,6 +13579,7 @@ var Models = {
   CreatifyAurora,
   CreatifyBoreal,
   ElevenAudioIsolation,
+  ElevenDialogueV4,
   ElevenDubbing,
   ElevenMultilingualStsV2,
   ElevenMultilingualV2,
@@ -13501,6 +13587,8 @@ var Models = {
   ElevenStsV2,
   ElevenTextToDialogue,
   ElevenV3,
+  ElevenV4,
+  ElevenV4Turbo,
   ElevenVideoToMusic,
   ElevenVoiceCreate,
   ElevenVoiceDesignV2,

package/package.json

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