vidspotai-shared 1.0.80 → 1.0.81

package/lib/services/aiGen/providers/alibaba/alibaba.js

@@ -13,32 +13,83 @@ const helpers_1 = require("./helpers");
 const helpers_2 = require("../../helpers");
 const utils_1 = require("../../../../utils");
 const logger_1 = require("../../../../utils/logger");
-// DashScope hosts Wan endpoints under three task-typed paths. We pick at submit
-// time based on which inputs are present (audio → s2v, image → i2v, else t2v).
-const ALIBABA_BASE = "https://dashscope-intl.aliyuncs.com/api/v1/services/aigc";
-const ENDPOINT_T2V = `${ALIBABA_BASE}/video-generation/video-synthesis`;
-const ENDPOINT_I2V = `${ALIBABA_BASE}/image2video/video-synthesis`;
-const ENDPOINT_S2V = `${ALIBABA_BASE}/sound2video/video-synthesis`;
-// All three share the same /tasks/{task_id} status endpoint.
-const ENDPOINT_TASK_STATUS = "https://dashscope-intl.aliyuncs.com/api/v1/tasks";
+const errors_1 = require("../../../../utils/errors");
+// Endpoint topology (verified 2026-06-06 against intl docs + live probes):
+//
+//   T2V + I2V        → /services/aigc/video-generation/video-synthesis   (async; X-DashScope-Async: enable)
+//   Wan/Qwen async   → /services/aigc/text2image/image-synthesis         (async; legacy qwen-image, qwen-image-plus)
+//   Wan async image  → /services/aigc/image-generation/generation        (async; wan2.7-image*, wan2.6-image)
+//   Qwen/Wan SYNC    → /services/aigc/multimodal-generation/generation   (sync; new qwen-image-2.0*, qwen-image-edit*, wan2.7-image* + edit)
+//
+// Both T2V and I2V use the SAME video endpoint — the model + presence of
+// img_url determines mode. The legacy split into /image2video/... and
+// /sound2video/... endpoints was wrong (Model not exist errors).
+//
+// S2V (wan2.2-s2v) is China-region only and cannot be reached with an intl
+// DashScope key; the model key is intentionally kept but rejected at submit
+// with a UserFacingError. Same for kolors-v2 (Kuaishou model, not Alibaba).
+const ALIBABA_BASE_URL = "https://dashscope-intl.aliyuncs.com/api/v1";
+const ALIBABA_BASE = `${ALIBABA_BASE_URL}/services/aigc`;
+const ENDPOINT_VIDEO_ASYNC = `${ALIBABA_BASE}/video-generation/video-synthesis`;
+const ENDPOINT_IMAGE_T2I_ASYNC = `${ALIBABA_BASE}/text2image/image-synthesis`;
+const ENDPOINT_IMAGE_GEN_ASYNC = `${ALIBABA_BASE}/image-generation/generation`;
+const ENDPOINT_MULTIMODAL_SYNC = `${ALIBABA_BASE}/multimodal-generation/generation`;
+const ENDPOINT_TASK_STATUS = `${ALIBABA_BASE_URL}/tasks`;
+// Model IDs that don't run on the intl `dashscope-intl.aliyuncs.com` endpoint.
+// We surface a clean PROVIDER_AUTH_ERROR rather than letting them fall through
+// and hit a 404 "Model not exist."
+const INTL_UNAVAILABLE_MODEL_IDS = new Set([
+    "wan2.2-s2v", // China region only (dashscope.aliyuncs.com)
+    "kolors-v2", // Kuaishou model; not hosted on DashScope intl
+]);
+// Image model classification — drives sync vs async endpoint dispatch.
+// Sync (multimodal-generation/generation, returns inline image URL):
+//   - Qwen 2.x sync line: qwen-image-2.0, qwen-image-2.0-pro, qwen-image-max,
+//     qwen-image-edit*, plus wan2.7-image / wan2.7-image-pro when used inline.
+// Async-via-image-generation (returns task_id, poll /tasks):
+//   - Wan image-gen line: wan2.7-image*, wan2.6-image.
+// Async-via-text2image (returns task_id, poll /tasks):
+//   - Legacy qwen-image, qwen-image-plus.
+function isSyncMultimodalImageModel(modelId) {
+    return (modelId.startsWith("qwen-image-2") ||
+        modelId.startsWith("qwen-image-max") ||
+        modelId.startsWith("qwen-image-edit") ||
+        modelId.startsWith("wan2.7-image"));
+}
+function isAsyncWanImageModel(modelId) {
+    return modelId.startsWith("wan2.7-image") || modelId.startsWith("wan2.6-image");
+}
 class AlibabaService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
     constructor() {
         super();
-        this.baseUrl = ENDPOINT_T2V; // legacy default; used by getCreditUsed only
+        // Used by getCreditUsed only. Real request paths are chosen per-call.
+        this.baseUrl = ENDPOINT_VIDEO_ASYNC;
         this.timeout = 60000; // 60 seconds
         if (!process.env.ALIBABA_API_KEY) {
-            throw new Error("Missing ALIBABA_API_KEY in environment variables");
+            // Classify as PROVIDER_AUTH_ERROR (UserFacingError → warn log, no Slack
+            // page per job). The DashScope key is single-Bearer and distinct from
+            // ALIBABA_CLOUD_ACCESS_KEY/SECRET (those are general Alibaba Cloud
+            // creds, not DashScope) — surface a hint so an operator knows what to
+            // provision instead of chasing a generic 500.
+            throw new errors_1.UserFacingError("Alibaba (DashScope) API key is not configured. Set ALIBABA_API_KEY (Bearer sk-* token from dashscope.aliyuncs.com) in the runtime env.", errors_1.USER_FACING_ERROR_CODES.PROVIDER_AUTH_ERROR);
         }
     }
-    async request(body, method = "POST", url = this.baseUrl) {
+    /**
+     * DashScope API call. `async` toggles the `X-DashScope-Async: enable` header
+     * — required for async endpoints (video-generation, image-generation,
+     * text2image), MUST be omitted for sync multimodal-generation.
+     */
+    async request(body, method = "POST", url = this.baseUrl, asyncMode = true) {
+        const headers = {
+            Authorization: `Bearer ${process.env.ALIBABA_API_KEY}`,
+            "Content-Type": "application/json",
+        };
+        if (asyncMode)
+            headers["X-DashScope-Async"] = "enable";
         const config = {
             method,
             url,
-            headers: {
-                Authorization: `Bearer ${process.env.ALIBABA_API_KEY}`,
-                "Content-Type": "application/json",
-                "X-DashScope-Async": "enable",
-            },
+            headers,
             timeout: this.timeout,
             data: method === "POST" ? body : undefined,
         };
@@ -51,10 +102,12 @@ class AlibabaService extends baseAiGenProvider_service_1.BaseAiGenProviderServic
         const modelId = modelConfig?.modelId;
         if (!modelId)
             throw new Error(`Unknown modelKey: ${params.modelKey}`);
-        // Endpoint selection: audio wins (S2V), then image (I2V), else T2V.
-        const isS2V = !!params.inputAudioUrl;
-        const isI2V = !isS2V && !!params.inputImageUrl;
-        const endpoint = isS2V ? ENDPOINT_S2V : isI2V ? ENDPOINT_I2V : ENDPOINT_T2V;
+        if (INTL_UNAVAILABLE_MODEL_IDS.has(modelId)) {
+            throw new errors_1.UserFacingError(`Model "${modelId}" is not available on the intl DashScope endpoint (dashscope-intl.aliyuncs.com). It is hosted only in the China region and requires a separate Beijing-region API key.`, errors_1.USER_FACING_ERROR_CODES.PROVIDER_AUTH_ERROR);
+        }
+        // T2V and I2V share a single endpoint. The model + presence of img_url
+        // determines mode. S2V is unavailable on intl (gated above).
+        const isI2V = !!params.inputImageUrl;
         const input = {};
         if (params.prompt)
             input.prompt = params.prompt;
@@ -62,21 +115,16 @@ class AlibabaService extends baseAiGenProvider_service_1.BaseAiGenProviderServic
             input.negative_prompt = params.negativePrompt;
         if (isI2V) {
             input.img_url = params.inputImageUrl;
-            // Wan 2.7 i2v supports first-last-frame interpolation
+            // wan2.7-i2v supports first-last-frame interpolation
             if (params.lastFrameImageUrl)
                 input.last_frame_url = params.lastFrameImageUrl;
         }
-        if (isS2V) {
-            input.audio_url = params.inputAudioUrl;
-            if (params.inputImageUrl)
-                input.image_url = params.inputImageUrl;
-        }
         const parameters = {
             duration: params.duration || 5,
             prompt_extend: params.promptOptimizer ?? true,
         };
-        // T2V requires explicit size; I2V/S2V derive from inputs.
-        if (!isI2V && !isS2V) {
+        // T2V requires explicit size; I2V derives dimensions from the input image.
+        if (!isI2V) {
             const size = (0, helpers_1.getAlibabaDimensions)(params.resolution, params.aspectRatio);
             if (!size) {
                 throw new Error(`Invalid resolution/aspect ratio combination: ${params.resolution} ${params.aspectRatio}`);
@@ -88,7 +136,7 @@ class AlibabaService extends baseAiGenProvider_service_1.BaseAiGenProviderServic
         if (params.watermark !== undefined)
             parameters.watermark = params.watermark;
         const body = { model: modelId, input, parameters };
-        const result = await this.request(body, "POST", endpoint);
+        const result = await this.request(body, "POST", ENDPOINT_VIDEO_ASYNC, true);
         // DashScope returns { output: { task_id, ... } } on async submit.
         const taskId = result?.output?.task_id || result?.request_id;
         if (!result || !taskId) {
@@ -161,38 +209,127 @@ class AlibabaService extends baseAiGenProvider_service_1.BaseAiGenProviderServic
         return { status: types_1.EVideoSceneStatus.PENDING };
     }
     /**
-     * DashScope image generation. Both Kolors and Qwen-Image are async on
-     * DashScope — submit returns a task_id, then poll /tasks/{id}. Image jobs
-     * typically finish in 5–15s, well inside our HTTP timeout, so we poll
-     * inline rather than going through BullMQ.
+     * DashScope image generation. Three dispatch paths (verified live 2026-06-06):
+     *
+     *   1. SYNC multimodal-generation/generation
+     *      Models: qwen-image-2.0, qwen-image-2.0-pro, qwen-image-max,
+     *              qwen-image-edit*, wan2.7-image, wan2.7-image-pro
+     *      Response: output.choices[0].message.content[].image (inline URLs)
+     *      Note: NO X-DashScope-Async header. Edit mode is triggered by including
+     *            {image: refUrl} entries in the user message content array.
+     *
+     *   2. ASYNC image-generation/generation (Wan async image)
+     *      Models: wan2.7-image*, wan2.6-image (when caller prefers async; we
+     *              currently route these through path 1 since they're available
+     *              there too).
      *
-     * Endpoint selection:
-     *   - Qwen-Image edit (modelId qwen-image-edit*): /image2image/image-synthesis
-     *   - Everything else (Qwen T2I, Kolors): /text2image/image-synthesis
+     *   3. ASYNC text2image/image-synthesis (legacy)
+     *      Models: qwen-image, qwen-image-plus
+     *      Response: output.results[].url
+     *
+     * Image jobs typically finish in 5–15s, well inside our HTTP timeout, so
+     * we poll inline rather than going through BullMQ.
      */
     async generateImage(params) {
         const modelConfig = aiModels_1.aiModelConfigs[params.modelKey];
         const modelId = modelConfig?.modelId;
         if (!modelId)
             throw new Error(`Unknown image modelKey: ${params.modelKey}`);
-        const isEdit = modelId.startsWith("qwen-image-edit");
-        const submitUrl = isEdit
-            ? `${ALIBABA_BASE}/image2image/image-synthesis`
-            : `${ALIBABA_BASE}/text2image/image-synthesis`;
+        if (INTL_UNAVAILABLE_MODEL_IDS.has(modelId)) {
+            throw new errors_1.UserFacingError(`Model "${modelId}" is not available on the intl DashScope endpoint. Use a different image provider.`, errors_1.USER_FACING_ERROR_CODES.PROVIDER_AUTH_ERROR);
+        }
+        const refs = [
+            ...(params.inputImageUrl ? [params.inputImageUrl] : []),
+            ...(params.inputImageUrls ?? []),
+        ];
+        const isEdit = modelId.startsWith("qwen-image-edit") ||
+            (refs.length > 0 && (modelId.startsWith("wan2.7-image") || modelId.startsWith("qwen-image-2")));
+        if (isEdit && !refs.length) {
+            throw new Error(`${modelId}: edit/reference mode requires at least one input image`);
+        }
+        let remoteUrls;
+        let providerRequestId;
+        if (isSyncMultimodalImageModel(modelId)) {
+            const result = await this.generateImageSync(modelId, params, refs);
+            remoteUrls = result.urls;
+            providerRequestId = result.requestId;
+        }
+        else if (isAsyncWanImageModel(modelId)) {
+            const result = await this.generateImageAsync(modelId, params, ENDPOINT_IMAGE_GEN_ASYNC);
+            remoteUrls = result.urls;
+            providerRequestId = result.taskId;
+        }
+        else {
+            // Legacy async path: qwen-image, qwen-image-plus.
+            const result = await this.generateImageAsync(modelId, params, ENDPOINT_IMAGE_T2I_ASYNC);
+            remoteUrls = result.urls;
+            providerRequestId = result.taskId;
+        }
+        if (!remoteUrls.length) {
+            throw new Error("DashScope image returned no URLs");
+        }
+        const bucket = (0, firebase_1.getBucket)();
+        const ts = Date.now();
+        const urls = [];
+        for (let i = 0; i < remoteUrls.length; i++) {
+            const remoteUrl = remoteUrls[i];
+            const bytes = Buffer.from(await (await axios_1.default.get(remoteUrl, { responseType: "arraybuffer", timeout: this.timeout })).data);
+            const path = `images/dashscope/${ts}-${Math.random().toString(36).slice(2, 8)}-${i}.png`;
+            const file = bucket.file(path);
+            await file.save(bytes, { contentType: "image/png" });
+            const [signed] = await file.getSignedUrl({ action: "read", expires: "03-09-2491" });
+            urls.push(signed);
+        }
+        return {
+            imageUrl: urls[0],
+            imageUrls: urls.length > 1 ? urls : undefined,
+            providerRequestId,
+        };
+    }
+    /**
+     * Sync multimodal-generation. Returns inline image URLs in
+     * `output.choices[0].message.content[].image`. No polling needed.
+     */
+    async generateImageSync(modelId, params, refs) {
+        const userContent = [];
+        // Image refs come first (DashScope convention); each as its own content entry.
+        for (const ref of refs.slice(0, 3)) {
+            userContent.push({ image: ref });
+        }
+        if (params.prompt)
+            userContent.push({ text: params.prompt });
+        const input = {
+            messages: [{ role: "user", content: userContent }],
+        };
+        const parameters = {};
+        if (params.negativePrompt)
+            parameters.negative_prompt = params.negativePrompt;
+        if (params.watermark !== undefined)
+            parameters.watermark = params.watermark;
+        if (params.promptOptimizer !== undefined)
+            parameters.prompt_extend = params.promptOptimizer;
+        if (params.seed !== undefined)
+            parameters.seed = params.seed;
+        if (params.aspectRatio)
+            parameters.size = params.aspectRatio;
+        if (params.imageSize)
+            parameters.size = params.imageSize;
+        const result = await this.request({ model: modelId, input, parameters }, "POST", ENDPOINT_MULTIMODAL_SYNC, false);
+        const choices = result?.output?.choices ?? [];
+        const content = choices[0]?.message?.content ?? [];
+        const urls = content
+            .map((c) => c?.image)
+            .filter((u) => typeof u === "string" && !!u);
+        return { urls, requestId: result?.request_id ?? "" };
+    }
+    /**
+     * Async submit + poll. Used by both image-generation/generation (Wan async)
+     * and text2image/image-synthesis (legacy Qwen).
+     */
+    async generateImageAsync(modelId, params, submitUrl) {
         const input = { prompt: params.prompt };
         if (params.negativePrompt)
             input.negative_prompt = params.negativePrompt;
-        if (isEdit) {
-            const refs = [
-                ...(params.inputImageUrl ? [params.inputImageUrl] : []),
-                ...(params.inputImageUrls ?? []),
-            ];
-            if (!refs.length) {
-                throw new Error("Qwen-Image edit requires at least one input image");
-            }
-            // Qwen edit accepts 1–3 refs as base_image_url.
-            input.base_image_url = refs.length === 1 ? refs[0] : refs.slice(0, 3);
-        }
         const parameters = {
             n: params.numImages ?? 1,
             ...(params.aspectRatio ? { size: params.aspectRatio } : {}),
@@ -203,18 +340,18 @@ class AlibabaService extends baseAiGenProvider_service_1.BaseAiGenProviderServic
                 ? { prompt_extend: params.promptOptimizer }
                 : { prompt_extend: true }),
         };
-        const submit = await this.request({ model: modelId, input, parameters }, "POST", submitUrl);
+        const submit = await this.request({ model: modelId, input, parameters }, "POST", submitUrl, true);
         const taskId = submit?.output?.task_id;
         if (!taskId) {
             throw new Error("DashScope image submit returned no task_id");
         }
-        // Poll up to 90s, every 2s. Image jobs are quick.
+        // Poll up to 90s, every 2s.
         const maxAttempts = 45;
         const intervalMs = 2000;
         let lastResult = null;
         for (let i = 0; i < maxAttempts; i++) {
             await new Promise((r) => setTimeout(r, intervalMs));
-            const poll = await this.request(null, "GET", `${ENDPOINT_TASK_STATUS}/${taskId}`);
+            const poll = await this.request(null, "GET", `${ENDPOINT_TASK_STATUS}/${taskId}`, false);
             const status = poll?.output?.task_status ?? poll?.status;
             if (status === "SUCCEEDED" || status === "succeeded") {
                 lastResult = poll;
@@ -228,27 +365,8 @@ class AlibabaService extends baseAiGenProvider_service_1.BaseAiGenProviderServic
             throw new Error("DashScope image task timed out after 90s");
         }
         const results = lastResult.output?.results ?? [];
-        const remoteUrls = results.map((r) => r.url).filter((u) => !!u);
-        if (!remoteUrls.length) {
-            throw new Error("DashScope image task returned no URLs");
-        }
-        const bucket = (0, firebase_1.getBucket)();
-        const ts = Date.now();
-        const urls = [];
-        for (let i = 0; i < remoteUrls.length; i++) {
-            const remoteUrl = remoteUrls[i];
-            const bytes = Buffer.from(await (await axios_1.default.get(remoteUrl, { responseType: "arraybuffer", timeout: this.timeout })).data);
-            const path = `images/dashscope/${ts}-${Math.random().toString(36).slice(2, 8)}-${i}.png`;
-            const file = bucket.file(path);
-            await file.save(bytes, { contentType: "image/png" });
-            const [signed] = await file.getSignedUrl({ action: "read", expires: "03-09-2491" });
-            urls.push(signed);
-        }
-        return {
-            imageUrl: urls[0],
-            imageUrls: urls.length > 1 ? urls : undefined,
-            providerRequestId: taskId,
-        };
+        const urls = results.map((r) => r.url).filter((u) => !!u);
+        return { urls, taskId };
     }
     getCreditUsed({ modelKey, resolution, aspectRatio, duration, multiClip = false, numImages = 1, }) {
         const modelConfig = aiModels_1.aiModelConfigs[modelKey];

package/lib/services/aiGen/providers/google/google.service.d.ts

@@ -13,6 +13,7 @@ export declare class GoogleService extends BaseAiGenProviderService {
     generateVideo(params: VideoGenerationParams): Promise<VideoGenerationResult>;
     checkVideoStatus({ task, outputFilename, outputFilePath, }: VideoStatusParams): Promise<VideoStatusResult>;
     generateImage(params: ImageGenerationParams): Promise<ImageGenerationResult>;
+    private _generateImage;
     /**
      * Lyria 2 (Vertex AI). Sync — POST {region}-aiplatform.googleapis.com/.../lyria-002:predict
      * returns base64-encoded WAV audio inline. Auth via ADC on the function service

package/lib/services/aiGen/providers/google/google.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/google/google.service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAoJlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;;IAO/C;;;;OAIG;YACW,kBAAkB;IA+B1B,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAyG3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0F3C,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAsGjC;;;;;;OAMG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAqEjC,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,UAAmB,EAAE,SAAiB,EAAE,SAAa,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,MAAM;CA8BvI"}
+{"version":3,"file":"google.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/google/google.service.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAmKlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;;IAO/C;;;;OAIG;YACW,kBAAkB;IA+B1B,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAyG3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0F3C,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;YAiBnB,cAAc;IAwG5B;;;;;;OAMG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAqEjC,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,UAAmB,EAAE,SAAiB,EAAE,SAAa,EAAE,SAAS,EAAE,EAAE,iBAAiB,GAAG,MAAM;CA8BvI"}

package/lib/services/aiGen/providers/google/google.service.js

@@ -141,6 +141,16 @@ function classifyGoogleApiError(err) {
             /use case is currently not supported/i.test(msg)) {
             return new errors_1.UserFacingError(msg, errors_1.USER_FACING_ERROR_CODES.CAPABILITY_MISMATCH);
         }
+        // Imagen + Nano-Banana surface Responsible-AI filter rejections as
+        // INVALID_ARGUMENT 400 with the literal text "filtered out because they
+        // violated Google's Responsible AI practices" (and a recommendation to
+        // rephrase). This is user content moderation, not a system bug — show the
+        // user the rephrase hint and skip the Slack page. Also matches the Veo
+        // RAI message ("violated Google's content policies") for the same reason.
+        if ((status === "INVALID_ARGUMENT" || httpCode === 400) &&
+            /(filtered out because they violated|violated Google's (?:Responsible AI|content) (?:practices|policies))/i.test(msg)) {
+            return new errors_1.UserFacingError("Your prompt was flagged by Google's safety filters. Please rephrase and try again.", errors_1.USER_FACING_ERROR_CODES.CONTENT_POLICY_VIOLATION);
+        }
     }
     catch {
         // Not JSON — fall through to non-JSON checks.
@@ -338,6 +348,24 @@ class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService
         return { status: types_1.EVideoSceneStatus.PENDING };
     }
     async generateImage(params) {
+        try {
+            return await this._generateImage(params);
+        }
+        catch (err) {
+            // The SDK's generateImages / generateContent throws ApiError instances
+            // whose .message is a JSON string. Route through classifyGoogleApiError
+            // so Imagen RAI safety filter rejections (the most common failure mode
+            // for image gen — "filtered out because they violated Google's
+            // Responsible AI practices") become UserFacingError(CONTENT_POLICY_VIOLATION)
+            // instead of leaking as raw provider JSON into the worker's Slack
+            // error channel.
+            const userFacing = classifyGoogleApiError(err);
+            if (userFacing)
+                throw userFacing;
+            throw err;
+        }
+    }
+    async _generateImage(params) {
         const modelConfig = aiModels_1.aiModelConfigs[params.modelKey];
         const modelId = modelConfig?.modelId;
         if (!modelId)

package/lib/services/aiGen/providers/pixverse/pixverse.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pixverse.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/pixverse/pixverse.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AASlB,qBAAa,eAAgB,SAAQ,wBAAwB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAKpE,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAsL3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmGjD,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAkDjD"}
+{"version":3,"file":"pixverse.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/pixverse/pixverse.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AA0FlB,qBAAa,eAAgB,SAAQ,wBAAwB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAKpE,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAmK3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0FjD,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAkDjD"}

package/lib/services/aiGen/providers/pixverse/pixverse.service.js

@@ -12,7 +12,70 @@ const types_1 = require("../../../../globals/types");
 const firebase_1 = require("../../../../libs/firebase");
 const helpers_2 = require("../../../../utils/helpers");
 const logger_1 = require("../../../../utils/logger");
+const errors_1 = require("../../../../utils/errors");
+const transientRetry_1 = require("../../transientRetry");
 const crypto_1 = __importDefault(require("crypto"));
+// PixVerse soft-failure ErrCodes (HTTP 200 body). 0 = success.
+//   500090 — insufficient balance on the openapi account (operator must top up)
+//   401xx  — auth (apiKey empty/invalid)
+const PIXVERSE_ERR_INSUFFICIENT_BALANCE = 500090;
+/**
+ * Classify a PixVerse HTTP failure (non-2xx). Returns:
+ *  - TransientHttpError for retryable cases (5xx, 429, and 404 — PixVerse's
+ *    CloudFlare edge has been observed serving "404 page not found" for
+ *    transiently-misrouted requests that succeed on retry, 2026-06-06 prod log)
+ *  - UserFacingError for 401/403 auth (deploy/config bug — fail fast, no Slack)
+ *  - raw Error for true 4xx (validation, etc.) — surface to Slack as bug
+ */
+function classifyPixVerseHttpError(status, body, op) {
+    if (status === 401 || status === 403) {
+        return new errors_1.UserFacingError(`PixVerse rejected the API key (HTTP ${status}). Ask an operator to verify PIXVERSE_API_KEY.`, errors_1.USER_FACING_ERROR_CODES.PROVIDER_AUTH_ERROR);
+    }
+    if (status >= 500 || status === 429 || status === 404) {
+        return new transientRetry_1.TransientHttpError(status, `PixVerse ${op} transient HTTP ${status}: ${body.slice(0, 200)}`);
+    }
+    return new Error(`PixVerse ${op} failed (${status}): ${body}`);
+}
+/**
+ * Classify a PixVerse 200-response with non-zero ErrCode. Insufficient-balance
+ * is an operator concern (account top-up), not a per-user bug — we surface it
+ * as UserFacingError(ACCOUNT_QUOTA_EXCEEDED) so it logs as warn (no Slack
+ * page-storm per job) AND the daily ops-channel digest still picks up that
+ * the account is empty. Other ErrCodes are real provider/protocol bugs.
+ */
+function classifyPixVerseApiError(errCode, errMsg, op) {
+    if (errCode === PIXVERSE_ERR_INSUFFICIENT_BALANCE) {
+        return new errors_1.UserFacingError("Video provider is temporarily unavailable. Please try a different model or retry shortly.", errors_1.USER_FACING_ERROR_CODES.ACCOUNT_QUOTA_EXCEEDED);
+    }
+    return new Error(`PixVerse ${op} API error (code ${errCode}): ${errMsg || "Unknown error"}`);
+}
+/**
+ * One-shot PixVerse POST/GET helper with shared transient-retry behavior.
+ * Returns the parsed JSON body, or throws a classified error.
+ */
+async function pixverseFetch(url, init, op) {
+    return (0, transientRetry_1.withTransientRetry)(`pixverse:${op}`, async () => {
+        const resp = await fetch(url, init);
+        if (!resp.ok) {
+            const errText = await resp.text();
+            throw classifyPixVerseHttpError(resp.status, errText, op);
+        }
+        const data = await resp.json();
+        if (data.ErrCode !== undefined && data.ErrCode !== 0) {
+            throw classifyPixVerseApiError(data.ErrCode, data.ErrMsg ?? "", op);
+        }
+        return data;
+    }, {
+        onRetry: ({ attempt, maxAttempts, backoffMs, err }) => {
+            logger_1.logger.warn(`PixVerse ${op} transient error — retrying`, {
+                attempt,
+                maxAttempts,
+                backoffMs,
+                message: err.message,
+            });
+        },
+    });
+}
 class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
     constructor() {
         super(...arguments);
@@ -43,7 +106,7 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
                 extendBody.negative_prompt = params.negativePrompt;
             if (params.seed !== undefined)
                 extendBody.seed = params.seed;
-            const resp = await fetch(`${this.baseUrl}/extend/generate`, {
+            const data = await pixverseFetch(`${this.baseUrl}/extend/generate`, {
                 method: "POST",
                 headers: {
                     "Content-Type": "application/json",
@@ -51,15 +114,7 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
                     "Ai-trace-id": traceId,
                 },
                 body: JSON.stringify(extendBody),
-            });
-            if (!resp.ok) {
-                const errText = await resp.text();
-                throw new Error(`PixVerse extendVideo failed (${resp.status}): ${errText}`);
-            }
-            const data = await resp.json();
-            if (data.ErrCode !== 0) {
-                throw new Error(`PixVerse API error: ${data.ErrMsg || "Unknown error"}`);
-            }
+            }, "extendVideo");
             const videoId = data?.Resp?.video_id;
             if (!videoId)
                 throw new Error("PixVerse extend did not return video_id");
@@ -94,7 +149,7 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
                 effectBody.water_mark = !params.watermark;
             if (params.motionMode)
                 effectBody.motion_mode = params.motionMode;
-            const resp = await fetch(`${this.baseUrl}/template/generate`, {
+            const data = await pixverseFetch(`${this.baseUrl}/template/generate`, {
                 method: "POST",
                 headers: {
                     "Content-Type": "application/json",
@@ -102,15 +157,7 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
                     "Ai-trace-id": traceId,
                 },
                 body: JSON.stringify(effectBody),
-            });
-            if (!resp.ok) {
-                const errText = await resp.text();
-                throw new Error(`PixVerse effect generation failed (${resp.status}): ${errText}`);
-            }
-            const data = await resp.json();
-            if (data.ErrCode !== 0) {
-                throw new Error(`PixVerse API error: ${data.ErrMsg || "Unknown error"}`);
-            }
+            }, "effectGeneration");
             const videoId = data?.Resp?.video_id;
             if (!videoId)
                 throw new Error("PixVerse effect did not return video_id");
@@ -165,7 +212,7 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
             body.image_url = params.inputImageUrl;
         }
         const endpoint = isImageToVideo ? `${this.baseUrl}/image/generate` : `${this.baseUrl}/text/generate`;
-        const resp = await fetch(endpoint, {
+        const data = await pixverseFetch(endpoint, {
             method: "POST",
             headers: {
                 "Content-Type": "application/json",
@@ -173,15 +220,7 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
                 "Ai-trace-id": traceId,
             },
             body: JSON.stringify(body),
-        });
-        if (!resp.ok) {
-            const errText = await resp.text();
-            throw new Error(`PixVerse generateVideo failed (${resp.status}): ${errText}`);
-        }
-        const data = await resp.json();
-        if (data.ErrCode !== 0) {
-            throw new Error(`PixVerse API error: ${data.ErrMsg || "Unknown error"}`);
-        }
+        }, "generateVideo");
         const videoId = data?.Resp?.video_id;
         if (!videoId) {
             throw new Error("PixVerse API did not return video_id");
@@ -196,21 +235,13 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
     // =========================================================
     async checkVideoStatus({ task, outputFilename, outputFilePath = "videos", }) {
         const traceId = crypto_1.default.randomUUID();
-        const resp = await fetch(`${this.baseUrl}/result/${task}`, {
+        const data = await pixverseFetch(`${this.baseUrl}/result/${task}`, {
             method: "GET",
             headers: {
                 "API-KEY": process.env.PIXVERSE_API_KEY,
                 "Ai-trace-id": traceId,
             },
-        });
-        if (!resp.ok) {
-            const errText = await resp.text();
-            throw new Error(`PixVerse checkVideoStatus failed (${resp.status}): ${errText}`);
-        }
-        const data = await resp.json();
-        if (data.ErrCode !== 0) {
-            throw new Error(`PixVerse API error: ${data.ErrMsg || "Unknown error"}`);
-        }
+        }, "checkVideoStatus");
         const status = data?.Resp?.status;
         // ---- Status Mapping ----
         switch (status) {

package/lib/services/aiGen/transientRetry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * True when an error from `fetch()` / SDK call is a transient network failure
+ * worth retrying. False for application-layer errors (4xx, validation, etc.).
+ */
+export declare function isTransientFetchError(err: unknown): boolean;
+/**
+ * Marker thrown by callers when they detect a transient HTTP response (5xx /
+ * 429 / opt-in 404) and want `withTransientRetry` to retry it. Caller is
+ * responsible for the classification — this util is response-shape agnostic.
+ */
+export declare class TransientHttpError extends Error {
+    readonly isTransientHttpError = true;
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export interface TransientRetryOptions {
+    /** Max attempts including the first try. Defaults to 3. */
+    maxAttempts?: number;
+    /** Base backoff in ms; doubled each retry. Defaults to 1000 (1s → 2s → 4s). */
+    baseBackoffMs?: number;
+    /** Logger function for warn-level retry notices. */
+    onRetry?: (info: {
+        attempt: number;
+        maxAttempts: number;
+        backoffMs: number;
+        err: Error;
+    }) => void;
+}
+/**
+ * Wraps `fn` with retry on transient errors. UserFacingError ALWAYS short-
+ * circuits (no retry, no logging — caller's responsibility to log appropriately).
+ * Non-transient errors short-circuit on the first attempt.
+ */
+export declare function withTransientRetry<T>(label: string, fn: () => Promise<T>, opts?: TransientRetryOptions): Promise<T>;
+//# sourceMappingURL=transientRetry.d.ts.map

package/lib/services/aiGen/transientRetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transientRetry.d.ts","sourceRoot":"","sources":["../../../src/services/aiGen/transientRetry.ts"],"names":[],"mappings":"AAwCA;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQ3D;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,oBAAoB,QAAQ;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK5C;AAED,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAC;CACnG;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,CAAC,CAAC,CA2BZ"}