@sogni-ai/sogni-client 4.2.0-alpha.21 → 4.2.0-alpha.22

package/dist-esm/lib/validation.js

@@ -0,0 +1,138 @@
+import { ApiError } from '../ApiClient';
+const EXTENDED_IMAGE_SIZE_MODEL_IDS = new Set([
+    'z_image_bf16',
+    'z_image_turbo_bf16',
+    'qwen_image_edit_2511_fp8',
+    'qwen_image_edit_2511_fp8_lightning',
+    'qwen_image_2512_fp8',
+    'qwen_image_2512_fp8_lightning',
+    'flux2_dev_fp8'
+]);
+function getMaxCustomImageSize(modelId) {
+    if (modelId === 'gpt-image-2') {
+        return 3840;
+    }
+    if (modelId && EXTENDED_IMAGE_SIZE_MODEL_IDS.has(modelId)) {
+        return 2560;
+    }
+    return 2048;
+}
+export function validateCustomImageSize(value, { modelId, propertyName = 'Width and height' } = {}) {
+    return validateNumber(value, {
+        min: 256,
+        max: getMaxCustomImageSize(modelId),
+        propertyName
+    });
+}
+/**
+ * Validate video dimensions for Wan 2.2 models.
+ * Minimum dimension is 480px for both width and height.
+ */
+export function validateVideoSize(value, propertyName) {
+    return validateNumber(value, { min: 480, propertyName: `Video ${propertyName}` });
+}
+export function validateVideoDuration(value, min = 1, max = 10) {
+    return validateNumber(value, { min, max, propertyName: 'Video duration' });
+}
+export function validateNumber(value, { min, max, propertyName, defaultValue } = {}) {
+    const number = Number(value);
+    const hasDefaultValue = defaultValue !== undefined;
+    if (!propertyName) {
+        propertyName = 'Value';
+    }
+    if (isNaN(number)) {
+        if (hasDefaultValue) {
+            return defaultValue;
+        }
+        throw new Error(`${propertyName} must be a number, got ${value}`);
+    }
+    if (min !== undefined && number < min) {
+        if (hasDefaultValue) {
+            return defaultValue;
+        }
+        throw new Error(`${propertyName} must greater or equal ${min}, got ${number}`);
+    }
+    if (max !== undefined && number > max) {
+        if (hasDefaultValue) {
+            return defaultValue;
+        }
+        throw new Error(`${propertyName} must be less or equal ${max}, got ${number}`);
+    }
+    return number;
+}
+/**
+ * Validate teacacheThreshold for T2V and I2V models.
+ * Range: 0.0-1.0. 0.0 = disabled.
+ */
+export function validateTeacacheThreshold(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    const num = Number(value);
+    if (isNaN(num)) {
+        throw new Error(`teacacheThreshold must be a number, got ${value}`);
+    }
+    if (num < 0.0 || num > 1.0) {
+        throw new Error(`teacacheThreshold must be between 0.0 and 1.0 (got ${num})`);
+    }
+    return num;
+}
+export function isComfyModel(modelId) {
+    const COMFY_PREFIXES = ['z_image_', 'qwen_image_', 'flux2_', 'wan_', 'ace_step'];
+    return COMFY_PREFIXES.some((prefix) => modelId.startsWith(prefix));
+}
+/**
+ * Get the maximum number of context images supported by a model.
+ * - GPT Image 2: 16 images
+ * - Flux.2 Dev: 6 images
+ * - Qwen Image Edit: 3 images
+ * - Flux Kontext: 2 images
+ * - Default: 3 images
+ */
+export function getMaxContextImages(modelId) {
+    if (modelId === 'gpt-image-2') {
+        return 16;
+    }
+    if (modelId.startsWith('flux2_')) {
+        return 6;
+    }
+    if (modelId.startsWith('qwen_image_')) {
+        return 3;
+    }
+    if (modelId.includes('kontext')) {
+        return 2;
+    }
+    // Default fallback for other models that might support context images
+    return 3;
+}
+function validateOption(value, options, errorMessage) {
+    if (!options.includes(value)) {
+        throw new ApiError(400, {
+            status: 'error',
+            errorCode: 0,
+            message: errorMessage
+        });
+    }
+    return value;
+}
+/**
+ * Validate sampler value against allowed options.
+ * Returns the validated value unchanged - sogni-socket handles normalization.
+ */
+export function validateSampler(value, options) {
+    if (!options.sampler.allowed.length || !value) {
+        return null;
+    }
+    return validateOption(value, options.sampler.allowed, `Invalid sampler ${value}. Must be one of "${options.sampler.allowed.join('", "')}".`);
+}
+/**
+ * Validate scheduler value against allowed options.
+ * Returns the validated value unchanged - sogni-socket handles normalization.
+ */
+export function validateScheduler(value, options) {
+    if (!options.scheduler.allowed.length || !value) {
+        return null;
+    }
+    return validateOption(value, options.scheduler.allowed, `Invalid scheduler ${value}. Must be one of "${options.scheduler.allowed.join('", "')}".`);
+}
+//# sourceMappingURL=validation.js.map

package/dist-esm/lib/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/lib/validation.ts"],"names":[],"mappings":"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"}

package/dist-esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist-esm/types/ErrorData.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ErrorData.js.map

package/dist-esm/types/ErrorData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorData.js","sourceRoot":"","sources":["../../src/types/ErrorData.ts"],"names":[],"mappings":""}

package/dist-esm/types/json.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json.js.map

package/dist-esm/types/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/types/json.ts"],"names":[],"mappings":""}

package/dist-esm/types/token.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=token.js.map

package/dist-esm/types/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/types/token.ts"],"names":[],"mappings":""}

package/dist-esm/version.js

@@ -0,0 +1,3 @@
+import { version } from '../package.json';
+export const LIB_VERSION = version;
+//# sourceMappingURL=version.js.map

package/dist-esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/llms-full.txt

@@ -934,17 +934,8 @@ Sogni's generation APIs automatically:
 - Video-to-Video: "Restyle this video as anime"
 - Music Generation: "Compose a jazz song about the rain"
 
-SDK-LOCAL PUBLIC TOOL NAMES (`SogniTools.all`, client-managed execution):
-
-- `sogni_generate_image`
-- `sogni_edit_image`
-- `sogni_generate_video`
-- `sogni_sound_to_video`
-- `sogni_video_to_video`
-- `sogni_generate_music`
-
-HOSTED CREATIVE TOOL FAMILIES:
-The Sogni API can also inject hosted Sogni tool families into the same chat completions endpoint. The default `creative-tools` surface provides media, post-production, analysis, metadata, and synchronous composition tools; `sogni_tools: "creative-agent"` adds workflow control and asset-manifest tools:
+CANONICAL HOSTED CREATIVE-TOOL SURFACE (`SogniTools.all`, 22 tools):
+All tool calls execute server-side via `sogni.chat.hosted.create()` / `sogni.chat.runs.create()`. The default `creative-tools` value of `sogni_tools` injects this surface server-side; `sogni_tools: "creative-agent"` adds workflow control and asset-manifest tools on top.
 
 - `generate_image`, `edit_image`, `generate_video`, `generate_music`, `sound_to_video`, `video_to_video` — core media-generation tools with creative-agent naming.
 - `restore_photo`, `apply_style`, `refine_result`, `change_angle` — image-edit adapters backed by the shared image-edit workflow.
@@ -974,15 +965,15 @@ MEDIA-CONDITIONED TOOL INPUTS:
 - `reference_video_url`
   All media-conditioned tool inputs must be inline base64-encoded `data:` URIs. Remote `http(s)` URLs are not allowed. Tool image inputs accept PNG/JPEG only, tool audio inputs accept MP3/M4A/WAV only, and tool video inputs accept MP4 or MOV/QuickTime only.
 
-DEFAULT GENERATION MODELS (used by SDK-local platform tools):
+DEFAULT GENERATION MODELS (used by the canonical generation tools):
 | Tool | Model ID | Description |
 |------|----------|-------------|
-| `sogni_generate_image` | z_image_turbo_bf16 | Z-Image Turbo, ultra-fast 8-step generation |
-| `sogni_edit_image` | workflow/model-dependent | Reference-guided image editing with edit-capable Qwen/Flux models |
-| `sogni_generate_video` | ltx23-22b-fp8_t2v_distilled / ltx23-22b-fp8_i2v_distilled / Seedance selectors | Text-to-video or image-to-video |
-| `sogni_sound_to_video` | ltx23-22b-fp8_a2v_distilled / ltx23-22b-fp8_ia2v_distilled | Audio-driven video generation |
-| `sogni_video_to_video` | ltx23-22b-fp8_v2v_distilled / seedance-2-0 / WAN animate models | Video transformation / motion transfer |
-| `sogni_generate_music` | ace_step_1.5_turbo | ACE-Step 1.5 Turbo, fast music generation |
+| `generate_image` | z_image_turbo_bf16 | Z-Image Turbo, ultra-fast 8-step generation |
+| `edit_image` | workflow/model-dependent | Reference-guided image editing with edit-capable Qwen/Flux models |
+| `generate_video` | ltx23-22b-fp8_t2v_distilled / ltx23-22b-fp8_i2v_distilled / Seedance selectors | Text-to-video or image-to-video |
+| `sound_to_video` | ltx23-22b-fp8_a2v_distilled / ltx23-22b-fp8_ia2v_distilled | Audio-driven video generation |
+| `video_to_video` | ltx23-22b-fp8_v2v_distilled / seedance-2-0 / WAN animate models | Video transformation / motion transfer |
+| `generate_music` | ace_step_1.5_turbo | ACE-Step 1.5 Turbo, fast music generation |
 
 PLATFORM TOOL WORKFLOW:
 
@@ -996,8 +987,8 @@ PLATFORM TOOL WORKFLOW:
 See `workflow_text_chat_sogni_tools.mjs` for a composition-pipeline example
 covering the core image/video/music flows. See `workflow_creative_agent_tools.mjs`
 for server-side hosted Sogni tool injection with `sogni_tools`.
-For the full built-in SDK tool surface, use `SogniTools.all` with
-`sogni.chat.tools.executeAll()` or `autoExecuteTools`.
+Pass `SogniTools.all` (or individual tool defs) to the LLM via `tools` and
+execute calls through `sogni.chat.hosted.create()` / `sogni.chat.runs.create()`.
 
 DURABLE CREATIVE WORKFLOWS:
 Use `sogni.creativeWorkflows` for `/v1/creative-agent/workflows` coverage:

package/llms.txt

@@ -456,18 +456,9 @@ Combine LLM tool calling with Sogni's generation APIs to create media from natur
 - **Video-to-Video** — "Restyle this video as anime"
 - **Music Generation** — "Compose a jazz song about the rain"
 
-SDK-local public tool names (`SogniTools.all`, client-managed execution):
+Canonical hosted creative-tool surface (`SogniTools.all`, 22 tools, executed server-side via `chat.hosted.create()` / `chat.runs.create()`):
 
-- `sogni_generate_image`
-- `sogni_edit_image`
-- `sogni_generate_video`
-- `sogni_sound_to_video`
-- `sogni_video_to_video`
-- `sogni_generate_music`
-
-Hosted creative tool families:
-
-- `generate_image`, `edit_image`, `generate_video`, `generate_music`, `sound_to_video`, `video_to_video`
+- `generate_image`, `edit_image`, `generate_video`, `generate_music`, `sound_to_video`, `video_to_video` (generation)
 - `restore_photo`, `apply_style`, `refine_result`, `change_angle` (image-edit adapters)
 - `animate_photo` (image-to-video with multi-source fan-out via `sourceImageIndices`; composed into one MP4 by default — opt out with `stitched: false`)
 - `stitch_video`, `orbit_video`, `dance_montage` (server-side composition into a single MP4)
@@ -481,19 +472,19 @@ The default `creative-tools` surface includes the tools above. `sogni_tools: "cr
 
 Media-conditioned tools accept explicit inline base64 `data:` URIs such as `source_image_url`, `reference_image_url`, `reference_audio_url`, and `reference_video_url`. Remote `http(s)` URLs are not allowed for these tool inputs. Tool image inputs accept PNG/JPEG only, tool audio inputs accept MP3/M4A/WAV only, and tool video inputs accept MP4 or MOV/QuickTime only.
 
-The `workflow_text_chat_sogni_tools.mjs` example demonstrates the core image/video/music composition flows. `workflow_creative_agent_tools.mjs` demonstrates server-side hosted Sogni tool injection through `/v1/chat/completions`. For the full built-in SDK tool surface, use `SogniTools.all` with `sogni.chat.tools.executeAll()` or `autoExecuteTools`.
+The `workflow_text_chat_sogni_tools.mjs` example demonstrates the core image/video/music composition flows. `workflow_creative_agent_tools.mjs` demonstrates server-side hosted Sogni tool injection through `/v1/chat/completions`. Pass `SogniTools.all` (or individual tool defs) to the LLM and execute calls through `sogni.chat.hosted.create()` / `sogni.chat.runs.create()`.
 
 Durable creative workflows: the SDK exposes persistent multi-step workflows through `sogni.creativeWorkflows` (`startImageToVideo`, `list`, `get`, `events`, `streamEvents`, `cancel`) backed by `/v1/creative-agent/workflows`. They require API-key auth. See `workflow_creative_agent_workflows.mjs` for start/list/get/events/stream/cancel coverage.
 
 Default generation models used by platform tools:
 | Tool | Model | Description |
 |------|-------|-------------|
-| `sogni_generate_image` | z_image_turbo_bf16 | Z-Image Turbo, ultra-fast 8-step |
-| `sogni_edit_image` | workflow/model-dependent | Reference-guided image editing with edit-capable Qwen/Flux models |
-| `sogni_generate_video` | ltx23-22b-fp8_t2v_distilled / ltx23-22b-fp8_i2v_distilled / Seedance selectors | Text-to-video or image-to-video |
-| `sogni_sound_to_video` | ltx23-22b-fp8_a2v_distilled / ltx23-22b-fp8_ia2v_distilled | Audio-driven video generation |
-| `sogni_video_to_video` | ltx23-22b-fp8_v2v_distilled / seedance-2-0 / WAN animate models | Video transformation / motion transfer |
-| `sogni_generate_music` | ace_step_1.5_turbo | ACE-Step 1.5 Turbo, fast music |
+| `generate_image` | z_image_turbo_bf16 | Z-Image Turbo, ultra-fast 8-step |
+| `edit_image` | workflow/model-dependent | Reference-guided image editing with edit-capable Qwen/Flux models |
+| `generate_video` | ltx23-22b-fp8_t2v_distilled / ltx23-22b-fp8_i2v_distilled / Seedance selectors | Text-to-video or image-to-video |
+| `sound_to_video` | ltx23-22b-fp8_a2v_distilled / ltx23-22b-fp8_ia2v_distilled | Audio-driven video generation |
+| `video_to_video` | ltx23-22b-fp8_v2v_distilled / seedance-2-0 / WAN animate models | Video transformation / motion transfer |
+| `generate_music` | ace_step_1.5_turbo | ACE-Step 1.5 Turbo, fast music |
 
 ---
 

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "4.2.0-alpha.21",
+  "version": "4.2.0-alpha.22",
   "engines": {
     "node": ">=22"
   },
@@ -31,7 +31,18 @@
     "llm-friendly"
   ],
   "main": "dist/index.js",
+  "module": "dist-esm/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist-esm/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
   "files": [
     "CHANGELOG.md",
     "README.md",
@@ -39,15 +50,20 @@
     "llms.txt",
     "llms-full.txt",
     "dist/",
+    "dist-esm/",
     "src/"
   ],
   "scripts": {
-    "clean": "rimraf ./dist",
+    "clean": "rimraf ./dist ./dist-esm",
     "prepublishOnly": "npm run build",
-    "build": "npm run clean && tsc --project tsconfig.json",
-    "test:chat-routing": "npm run build && node scripts/check-chat-model-routing.cjs",
+    "build": "npm run clean && tsc --project tsconfig.json && tsc --project tsconfig.esm.json && node scripts/write-dist-esm-package-json.mjs",
+    "test:chat-routing": "npm run check:hosted-tool-validation && npm run build && node scripts/check-chat-model-routing.cjs",
+    "sync:hosted-tool-validation": "node scripts/sync-hosted-tool-validation.mjs",
+    "check:hosted-tool-validation": "node scripts/sync-hosted-tool-validation.mjs --check",
+    "sync:hosted-tools-manifest": "node scripts/sync-hosted-tools-manifest.mjs",
+    "check:hosted-tools-manifest": "node scripts/sync-hosted-tools-manifest.mjs --check",
     "watch": "npm run clean && tsc --watch --project tsconfig.json",
-    "watch:esm": "npm run clean && tsc --watch --project tsconfig.esm.json",
+    "watch:esm": "tsc --watch --project tsconfig.esm.json",
     "prettier": "prettier --check ./src",
     "prettier:fix": "prettier --write ./src",
     "release": "semantic-release",

package/src/Chat/ChatTools.ts

@@ -31,6 +31,19 @@ import {
 const DEFAULT_TIMEOUT = 30 * 60 * 1000;
 const MAX_SOGNI_TOOL_CALLS_PER_ROUND = 8;
 
+const DIRECT_PROJECT_DISPATCH_TOOL_NAMES: ReadonlySet<string> = new Set([
+  'generate_image',
+  'edit_image',
+  'generate_video',
+  'sound_to_video',
+  'video_to_video',
+  'generate_music'
+]);
+
+function hasDirectProjectDispatch(toolCall: ToolCall): boolean {
+  return DIRECT_PROJECT_DISPATCH_TOOL_NAMES.has(toolCall.function.name);
+}
+
 const MAX_INPUT_MEDIA_BYTES: Record<MediaType, number> = {
   image: 20 * 1024 * 1024,
   audio: 50 * 1024 * 1024,
@@ -87,21 +100,28 @@ class ChatToolsApi {
     const args = parseToolCallArguments(toolCall);
     const name = toolCall.function.name;
 
+    if (!hasDirectProjectDispatch(toolCall)) {
+      return this.makeErrorResult(
+        toolCall,
+        `Tool '${name}' must be executed via chat.hosted.create() or chat.runs.create().`
+      );
+    }
+
     try {
       assertHostedToolArguments(SogniTools.all, name, args);
 
       switch (name) {
-        case 'sogni_generate_image':
+        case 'generate_image':
           return await this.executeImageGeneration(toolCall, args, options);
-        case 'sogni_edit_image':
+        case 'edit_image':
           return await this.executeImageEdit(toolCall, args, options);
-        case 'sogni_generate_video':
+        case 'generate_video':
           return await this.executeVideoGeneration(toolCall, args, options);
-        case 'sogni_sound_to_video':
+        case 'sound_to_video':
           return await this.executeSoundToVideo(toolCall, args, options);
-        case 'sogni_video_to_video':
+        case 'video_to_video':
           return await this.executeVideoToVideo(toolCall, args, options);
-        case 'sogni_generate_music':
+        case 'generate_music':
           return await this.executeMusicGeneration(toolCall, args, options);
         default:
           return this.makeErrorResult(toolCall, `Unknown Sogni tool: ${name}`);
@@ -119,7 +139,7 @@ class ChatToolsApi {
       onToolProgress?: (toolCall: ToolCall, progress: ToolExecutionProgress) => void;
     }
   ): Promise<ToolExecutionResult[]> {
-    const sogniToolCallCount = toolCalls.filter((toolCall) => isSogniToolCall(toolCall)).length;
+    const sogniToolCallCount = toolCalls.filter(hasDirectProjectDispatch).length;
     if (sogniToolCallCount > MAX_SOGNI_TOOL_CALLS_PER_ROUND) {
       throw new Error(
         `Too many Sogni tool calls in a single round (${sogniToolCallCount}); maximum is ${MAX_SOGNI_TOOL_CALLS_PER_ROUND}`
@@ -276,7 +296,7 @@ class ChatToolsApi {
   ): Promise<ToolExecutionResult> {
     const modelId = await this.selectModel({
       mediaType: 'image',
-      requestedModel: resolveHostedToolModelSelector('sogni_generate_image', args)
+      requestedModel: resolveHostedToolModelSelector('generate_image', args)
     });
 
     const projectParams: Record<string, unknown> = {
@@ -318,12 +338,12 @@ class ChatToolsApi {
     const inputUrls = [...(sourceImageUrl ? [sourceImageUrl] : []), ...referenceImageUrls];
 
     if (inputUrls.length === 0) {
-      throw new Error('sogni_edit_image requires source_image_url or reference_image_urls');
+      throw new Error('edit_image requires source_image_url or reference_image_urls');
     }
 
     const modelId = await this.selectModel({
       mediaType: 'image',
-      requestedModel: resolveHostedToolModelSelector('sogni_edit_image', args),
+      requestedModel: resolveHostedToolModelSelector('edit_image', args),
       filter: isEditImageModel
     });
     const maxContextImages = getMaxContextImages(modelId);
@@ -379,7 +399,7 @@ class ChatToolsApi {
 
     const modelId = await this.selectModel({
       mediaType: 'video',
-      requestedModel: resolveHostedToolModelSelector('sogni_generate_video', args),
+      requestedModel: resolveHostedToolModelSelector('generate_video', args),
       workflows: workflowPreference,
       preferredModelIds
     });
@@ -455,7 +475,7 @@ class ChatToolsApi {
     options?: ToolExecutionOptions
   ): Promise<ToolExecutionResult> {
     if (!isNonEmptyString(args.reference_audio_url)) {
-      throw new Error('sogni_sound_to_video requires reference_audio_url');
+      throw new Error('sound_to_video requires reference_audio_url');
     }
 
     const hasReferenceImage = isNonEmptyString(args.reference_image_url);
@@ -465,7 +485,7 @@ class ChatToolsApi {
       : [PREFERRED_MODEL_IDS.video.a2v];
     const modelId = await this.selectModel({
       mediaType: 'video',
-      requestedModel: resolveHostedToolModelSelector('sogni_sound_to_video', args),
+      requestedModel: resolveHostedToolModelSelector('sound_to_video', args),
       workflows,
       preferredModelIds
     });
@@ -516,7 +536,7 @@ class ChatToolsApi {
     options?: ToolExecutionOptions
   ): Promise<ToolExecutionResult> {
     if (!isNonEmptyString(args.reference_video_url)) {
-      throw new Error('sogni_video_to_video requires reference_video_url');
+      throw new Error('video_to_video requires reference_video_url');
     }
 
     const controlMode = normalizeVideoControlMode(args.control_mode);
@@ -534,7 +554,7 @@ class ChatToolsApi {
         : [PREFERRED_MODEL_IDS.video.v2v];
     const modelId = await this.selectModel({
       mediaType: 'video',
-      requestedModel: resolveHostedToolModelSelector('sogni_video_to_video', args),
+      requestedModel: resolveHostedToolModelSelector('video_to_video', args),
       workflows,
       preferredModelIds
     });
@@ -615,7 +635,7 @@ class ChatToolsApi {
   ): Promise<ToolExecutionResult> {
     const modelId = await this.selectModel({
       mediaType: 'audio',
-      requestedModel: resolveHostedToolModelSelector('sogni_generate_music', args),
+      requestedModel: resolveHostedToolModelSelector('generate_music', args),
       preferredModelIds: [
         PREFERRED_MODEL_IDS.audio.aceStepTurbo,
         PREFERRED_MODEL_IDS.audio.aceStepSft