@nodaro/shared 2.17.0 → 2.19.0

package/src/model-catalog.ts

@@ -228,6 +228,12 @@ const VIDEO_RATIOS_SEEDANCE_2 = ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "a
 // portrait-social and 21:9/9:21 cinematic (docs.kie.ai/market/happyhorse-1-1).
 // Kept separate so the wider set can't leak to models that don't support it.
 const VIDEO_RATIOS_HAPPYHORSE_11 = ["16:9", "9:16", "1:1", "4:3", "3:4", "4:5", "5:4", "21:9", "9:21"] as const
+// Wan 3.0 (standard + Prime) — the model's own six-ratio enum, `adaptive` first
+// because that is the KIE default ("automatically selects the ratio based on the
+// input media and intent"). Deliberately NO 21:9 — the Wan 3.0 enum rejects it,
+// so VIDEO_RATIOS_SEEDANCE_2 must NOT be reused here
+// (docs.kie.ai/market/wan/3-0-video and /3-0-video-prime — identical schemas).
+const VIDEO_RATIOS_WAN_3 = ["adaptive", "16:9", "4:3", "1:1", "3:4", "9:16"] as const
 
 // =============================================================================
 // IMAGE MODELS
@@ -1179,6 +1185,41 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
       { identifier: "gemini-omni-video:4k:vref", credits: 900, note: "video-edit 4K" },
     ],
   },
+  // Gemini Omni Flash 1.1 — the faster/cheaper Omni SKU (KIE
+  // `google/gemini-omni-flash-1-1`). Identical request surface to
+  // gemini-omni-video, so every capability below is deliberate PARITY with the
+  // sibling: same 4/6/8/10s ladder, same 720p/1080p + 4K bands, same
+  // features (the KIE schema also exposes first/last frame, but the pro
+  // sibling's frame path is unwired here too — no "end-frame" until it is).
+  // 360p is on the KIE enum but NOT exposed: it sits in the same credit band as
+  // 720p/1080p, so it could only hand the user a worse render at the same price.
+  "gemini-omni-flash": {
+    id: "gemini-omni-flash",
+    kind: "video",
+    modes: ["i2v", "t2v"] as const,   // V2V is served via the i2v handle, not a catalog mode
+    family: "Google",
+    label: "Gemini Omni Flash",
+    series: "Gemini",
+    description: "Google Gemini Omni Flash — faster/cheaper Omni tier: multimodal video with native audio, text/image-to-video + video-edit.",
+    useCases: ["cinematic", "fast"],
+    features: ["audio", "reference-image"],
+    aspectRatios: VIDEO_RATIOS_HV,
+    resolutions: ["720p", "1080p", "4k"],
+    durations: [4, 6, 8, 10],
+    pricing: [
+      { identifier: "gemini-omni-flash", credits: 270, note: "default — 8s 720p/1080p (the credit builder's duration fallback)" },
+      { identifier: "gemini-omni-flash:4", credits: 160, note: "720p/1080p 4s" },
+      { identifier: "gemini-omni-flash:6", credits: 210, note: "720p/1080p 6s" },
+      { identifier: "gemini-omni-flash:8", credits: 270, note: "720p/1080p 8s" },
+      { identifier: "gemini-omni-flash:10", credits: 320, note: "720p/1080p 10s" },
+      { identifier: "gemini-omni-flash:4k:4", credits: 370, note: "4K 4s" },
+      { identifier: "gemini-omni-flash:4k:6", credits: 420, note: "4K 6s" },
+      { identifier: "gemini-omni-flash:4k:8", credits: 480, note: "4K 8s" },
+      { identifier: "gemini-omni-flash:4k:10", credits: 530, note: "4K 10s" },
+      { identifier: "gemini-omni-flash:vref", credits: 420, note: "video-edit 720p/1080p" },
+      { identifier: "gemini-omni-flash:4k:vref", credits: 630, note: "video-edit 4K" },
+    ],
+  },
 
   // ── Kling ──
   "kling": {
@@ -1450,6 +1491,66 @@ const VIDEO_MODELS: Record<string, ModelCatalogEntry> = {
   },
 
   // ── Wan ──
+  // Wan 3.0 (standard + Prime) — a NEW generation, not a tier of the 2.x ladder.
+  // One id per SKU serves BOTH modes (no t2v twin, no alias): first/last frame
+  // OR an all-purpose reference mode (images/videos/audio, bound in the prompt
+  // as Image1/Video1/Audio1 — no space, unlike Wan 2.x), native audio behind a
+  // boolean `audio` lever, 2-30s at 480p/720p/1080p.
+  // `video-reference` is deliberately NOT declared: KIE accepts reference videos,
+  // but the extend chain is unwired and KIE caps input-video + output at 30s,
+  // which the segment bounds cannot express. Precedent: gemini-omni-video carries
+  // ref limits without the feature. The ref CAPS still live in
+  // VIDEO_REF_LIMITS_BY_PROVIDER (model-constants).
+  // `resolutions` is ascending (repo convention); the DEFAULT tier (720p) is
+  // declared explicitly in PRICING_DEFAULT_RESOLUTION, never by array position.
+  "wan-3": {
+    id: "wan-3",
+    kind: "video",
+    modes: ["i2v", "t2v"] as const,
+    family: "Alibaba",
+    label: "Wan 3.0",
+    series: "Wan",
+    description: "Wan 3.0 — multimodal: first/last frame or image/video/audio references, native audio, 2-30s at 480p/720p/1080p.",
+    useCases: ["motion", "narrative", "long-form"],
+    features: ["end-frame", "audio", "reference-image"],
+    aspectRatios: VIDEO_RATIOS_WAN_3,
+    durations: [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30],
+    resolutions: ["480p", "720p", "1080p"],
+    pricing: [
+      { identifier: "wan-3", credits: 200, note: "default 5s 720p — see :Ns:res variants for exact" },
+      { identifier: "wan-3:5s:720p", credits: 200, note: "5s 720p (the default tier)" },
+      { identifier: "wan-3:8s:480p", credits: 160, note: "8s 480p" },
+      { identifier: "wan-3:8s:720p", credits: 320, note: "8s 720p" },
+      { identifier: "wan-3:8s:1080p", credits: 640, note: "8s 1080p" },
+      { identifier: "wan-3:30s:480p", credits: 600, note: "30s 480p (max)" },
+      { identifier: "wan-3:30s:720p", credits: 1200, note: "30s 720p (max)" },
+      { identifier: "wan-3:30s:1080p", credits: 2400, note: "30s 1080p (max)" },
+    ],
+  },
+  "wan-3-prime": {
+    id: "wan-3-prime",
+    kind: "video",
+    modes: ["i2v", "t2v"] as const,
+    family: "Alibaba",
+    label: "Wan 3.0 Prime",
+    series: "Wan",
+    description: "Wan 3.0 Prime — Alibaba's high-speed Wan 3.0 tier: same multimodal surface and 2-30s range, faster turnaround at a higher per-second rate.",
+    useCases: ["fast", "motion", "narrative"],
+    features: ["end-frame", "audio", "reference-image"],
+    aspectRatios: VIDEO_RATIOS_WAN_3,
+    durations: [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30],
+    resolutions: ["480p", "720p", "1080p"],
+    pricing: [
+      { identifier: "wan-3-prime", credits: 320, note: "default 5s 720p — see :Ns:res variants for exact" },
+      { identifier: "wan-3-prime:5s:720p", credits: 320, note: "5s 720p (the default tier)" },
+      { identifier: "wan-3-prime:8s:480p", credits: 250, note: "8s 480p" },
+      { identifier: "wan-3-prime:8s:720p", credits: 510, note: "8s 720p" },
+      { identifier: "wan-3-prime:8s:1080p", credits: 1010, note: "8s 1080p" },
+      { identifier: "wan-3-prime:30s:480p", credits: 920, note: "30s 480p (max)" },
+      { identifier: "wan-3-prime:30s:720p", credits: 1890, note: "30s 720p (max)" },
+      { identifier: "wan-3-prime:30s:1080p", credits: 3780, note: "30s 1080p (max)" },
+    ],
+  },
   "wan-i2v": {
     id: "wan-i2v",
     kind: "video",

package/src/model-constants.ts

@@ -139,6 +139,13 @@ export const MAX_VIDEO_PROMPT_CHARS_BY_PROVIDER: Record<string, number> = {
   // (docs.kie.ai/market/bytedance/seedance-2-5).
   "seedance-2-5": 30000,
   "gemini-omni-video": 20000,
+  // Gemini Omni Flash 1.1 — same 20000-char prompt surface as the pro sibling
+  // (docs.kie.ai/market/google/gemini-omni-flash-1-1).
+  "gemini-omni-flash": 20000,
+  // Wan 3.0 / 3.0 Prime — 20000 chars, excess truncated by the provider
+  // (docs.kie.ai/market/wan/3-0-video and /3-0-video-prime).
+  "wan-3": 20000,
+  "wan-3-prime": 20000,
   "bytedance-lite": 10000,
   "bytedance-pro": 10000,
   "bytedance-pro-fast": 10000,
@@ -295,6 +302,35 @@ export const NATIVE_NEGATIVE_VIDEO_PROVIDERS = new Set<string>([
   "wan-s2v",
 ])
 
+/**
+ * The `[style]` section header, verbatim. A composed prompt that ends with that
+ * section has NO terminator (`@nodaro/prompts`' `prompt-style-section.ts` owns
+ * the shape and the reasoning), so a `"\n"`-joined `Avoid:` would read as one
+ * more look clause under its header. Duplicated rather than imported because
+ * `@nodaro/prompts` depends on THIS package and never the reverse; the two are
+ * pinned together behaviourally by that package's
+ * `__tests__/style-section-boundary.test.ts`, which runs the real composer
+ * through this clamp.
+ */
+const STYLE_SECTION_HEADER_LINE = "[style]:\n"
+
+/**
+ * The `Avoid: …` suffix `applyVideoNegativePrompt` folds into a prompt, with the
+ * separator the base prompt calls for: a blank line when the base ends INSIDE an
+ * unterminated `[style]` section, a single newline otherwise.
+ *
+ * `base` omitted = the WIDEST form, which is what a caller reserving room before
+ * the prompt exists must budget for (`effectiveVideoPromptCeiling`).
+ */
+export function videoNegativeSuffix(negativePrompt: string, base?: string): string {
+  const gapAt = base?.lastIndexOf("\n\n") ?? -1
+  const lastBlock = base === undefined ? undefined : (gapAt >= 0 ? base.slice(gapAt + 2) : base)
+  const separator = lastBlock === undefined || lastBlock.startsWith(STYLE_SECTION_HEADER_LINE)
+    ? "\n\n"
+    : "\n"
+  return `${separator}Avoid: ${negativePrompt}`
+}
+
 /**
  * Apply the negative prompt to a video-provider request.
  *
@@ -306,6 +342,8 @@ export const NATIVE_NEGATIVE_VIDEO_PROVIDERS = new Set<string>([
  * Otherwise, the helper appends `Avoid: <negativePrompt>` to the prompt
  * (consistent with `buildImagePrompt` in `prompt-builder.ts`) so the model
  * still sees the negative intent, and returns `nativeNegativePrompt = undefined`.
+ * The line is separated by {@link videoNegativeSuffix}, which closes an open
+ * `[style]` section with a blank line rather than reading as a look clause.
  *
  * Empty / missing negative is a no-op.
  *
@@ -338,7 +376,10 @@ export function applyVideoNegativePrompt(
   // assembler), then clamp the whole to the model cap.
   const base = prompt && prompt.trim().length > 0 ? prompt : ""
   if (!base) return { prompt: `Avoid: ${neg}`.slice(0, promptMax), nativeNegativePrompt: undefined }
-  const avoid = `\nAvoid: ${neg}`
+  // The separator is decided on the WHOLE base: the clamp below can only cut the
+  // tail, and a cut either leaves the `[style]` section behind or lands inside
+  // it, so the suffix never needs to grow after the reservation.
+  const avoid = videoNegativeSuffix(neg, base)
   const room = Math.max(0, promptMax - avoid.length)
   const injected = `${base.slice(0, room)}${avoid}`.slice(0, promptMax)
   return { prompt: injected, nativeNegativePrompt: undefined }
@@ -716,6 +757,11 @@ export const IMAGE_TO_VIDEO_PROVIDERS = [
   "runway-kie",
   "kling-3-omni",
   "gemini-omni-video",
+  "gemini-omni-flash",
+  // Wan 3.0 family — one id per SKU serves BOTH modes (no t2v twin, no alias),
+  // so each id is listed in this array AND in TEXT_TO_VIDEO_PROVIDERS.
+  "wan-3",
+  "wan-3-prime",
   "ltx-2.3-pro",
   "ltx-2.3-fast",
   // xAI Grok Imagine Video 1.5 — KIE i2v (image_urls required). Also listed in
@@ -754,6 +800,12 @@ export const TEXT_TO_VIDEO_PROVIDERS = [
   "happyhorse",
   "runway-kie",
   "gemini-omni-video",
+  "gemini-omni-flash",
+  // Wan 3.0 family — REAL t2v (prompt-only runs are the documented default
+  // mode), so they belong in this main section and must NOT be gated by
+  // VIDEO_PROVIDERS_REQUIRING_IMAGE.
+  "wan-3",
+  "wan-3-prime",
   "ltx-2.3-pro",
   "ltx-2.3-fast",
   // ── i2v-only providers (image required) ──────────────────────────────────
@@ -1211,6 +1263,12 @@ export const DURATION_PRICED_PROVIDERS = new Set([
   "happyhorse",
   "happyhorse-i2v",
   "happyhorse-ref2v",
+  // Wan 3.0 family — per-second billing at three resolution rates. NOTE:
+  // gemini-omni-flash is deliberately ABSENT (like gemini-omni-video): the
+  // Gemini Omni branch in buildVideoCreditModelIdentifier early-returns before
+  // this gate is consulted.
+  "wan-3",
+  "wan-3-prime",
 ])
 
 /**
@@ -1268,6 +1326,75 @@ export function normalizeMinimaxH3Resolution(resolution: string | undefined): "7
   return resolution?.trim().toLowerCase() === "768p" ? "768P" : MINIMAX_H3_DEFAULT_RESOLUTION
 }
 
+/**
+ * Wan 3.0 family — the KIE "wan/3-0-video" market model and its high-speed
+ * "wan/3-0-video-prime" sibling. The two share a BYTE-IDENTICAL input schema
+ * (first/last frame OR an all-purpose reference mode with images/videos/audio,
+ * native `audio` boolean, 2-30s, 480P/720P/1080P, six aspect ratios with
+ * `adaptive` as the default); only the per-second rate differs. Prime is the
+ * FASTER tier at a higher rate — never describe it as "higher quality".
+ *
+ * Exact-membership set — NEVER match on a "wan" prefix: "wan", "wan-i2v",
+ * "wan-turbo", "wan-flash", "wan-videoedit" and the "wan-2.7-*" ids are
+ * unrelated 2.x models with a different surface (and a different reference
+ * token format — see WAN_3_DOCTRINE in @nodaro/prompts).
+ */
+export const WAN_3_PROVIDERS = new Set<string>([
+  "wan-3",
+  "wan-3-prime",
+])
+
+export function isWan3Provider(provider: string | undefined): boolean {
+  return !!provider && WAN_3_PROVIDERS.has(provider)
+}
+
+/** Wan 3.0 resolution the PLATFORM renders when the param is omitted or unknown.
+ *  Deliberately NOT KIE's own default (1080P): 720p is the tier the bare credit
+ *  identifier prices, so the provider layer pins it to keep render == billed. */
+export const WAN_3_DEFAULT_RESOLUTION = "720P"
+
+/**
+ * SINGLE normalization for the Wan 3.0 resolution lever (KIE wire enum
+ * "480P" | "720P" | "1080P"). Everything INTERNAL — the catalog, QUALITY_MAP,
+ * dropdowns, RESOLUTION_DURATION_PRICING keys and every emitted credit
+ * identifier — stays LOWERCASE; this helper is the ONE place the uppercase wire
+ * form is produced (backend KIE payload build), the twin of
+ * {@link normalizeMinimaxH3Resolution}.
+ *
+ * Case-insensitive. Anything else (undefined, garbage, a stale "4k") collapses
+ * to {@link WAN_3_DEFAULT_RESOLUTION} — the tier the default credit identifier
+ * reserves — so the billed tier can never undercut the rendered one.
+ */
+export function normalizeWan3Resolution(resolution: string | undefined): "480P" | "720P" | "1080P" {
+  switch (resolution?.trim().toLowerCase()) {
+    case "480p": return "480P"
+    case "1080p": return "1080P"
+    case "720p": return "720P"
+    default: return WAN_3_DEFAULT_RESOLUTION
+  }
+}
+
+/**
+ * Google Gemini Omni family — the KIE "gemini-omni-video" market model and its
+ * faster/cheaper "google/gemini-omni-flash-1-1" sibling. Both take the SAME
+ * request shape (prompt + image_urls references, video-edit through the i2v
+ * handle, 4/6/8/10s, 720p/1080p or a 4K band) and are dispatched through the
+ * same runner, so every behavioural branch that used to compare against the
+ * literal "gemini-omni-video" must ask this predicate instead — V2V routing,
+ * the 7-slot reference quota, the mode swap and the aspect-ratio panels.
+ *
+ * Exact-membership set — NEVER match on a "gemini" prefix (the Gemini LLM ids
+ * would collide).
+ */
+export const GEMINI_OMNI_PROVIDERS = new Set<string>([
+  "gemini-omni-video",
+  "gemini-omni-flash",
+])
+
+export function isGeminiOmniProvider(provider: string | undefined): boolean {
+  return !!provider && GEMINI_OMNI_PROVIDERS.has(provider)
+}
+
 /**
  * Video models that are CATALOGUED and priced but have NO working dispatch
  * path today — selecting one fails at the router, not at validation.
@@ -1519,9 +1646,15 @@ export function maxSegmentsFor(provider: string | undefined, capSec: number): nu
  * param at all (inferred from the frame). Only the pure-t2v endpoint requires
  * a concrete ratio — the KIE provider layer coerces `adaptive` → `16:9` there
  * (see applyMinimaxH3Params in backend kie/video.ts).
+ *
+ * Wan 3.0 also defaults to `adaptive` — it is the model's own KIE default and
+ * the first value in its aspect enum, so an un-set node must not silently run
+ * at 16:9 while the panel displays Adaptive.
  */
 export function defaultVideoAspectRatio(provider: string | undefined): string {
-  return isSeedance2Provider(provider) || isMinimaxH3Provider(provider) ? "adaptive" : "16:9"
+  return isSeedance2Provider(provider) || isMinimaxH3Provider(provider) || isWan3Provider(provider)
+    ? "adaptive"
+    : "16:9"
 }
 
 /**
@@ -1622,6 +1755,10 @@ export const SEEDANCE_2_R2V_MAX_AUDIO_SEC_BY_PROVIDER: Record<string, number> =
   // MiniMax Hailuo 3 — documented hard limit: each reference audio segment
   // 2-15s, ≤15s total (docs.kie.ai/market/minimax-h3/reference-to-video).
   "minimax-h3": 15,
+  // Wan 3.0 family — documented hard limit: each reference audio clip 1-15s,
+  // ≤15s combined (docs.kie.ai/market/wan/3-0-video).
+  "wan-3": 15,
+  "wan-3-prime": 15,
 }
 
 /** The verified r2v reference-audio cap (seconds) for a provider, or null when
@@ -1677,8 +1814,17 @@ export const VIDEO_REF_LIMITS_BY_PROVIDER: Record<
   // bills input images beyond the first 5 (11 KIE cr each) — see the
   // minimax-h3 credit helper in backend ee/billing.
   "minimax-h3": { ...SEEDANCE_2_REF_LIMITS },
+  // Wan 3.0 family — all-purpose reference mode: up to 10 images / 5 videos
+  // (each 1-15s, ≤15s combined) / 5 audio clips (each 1-15s, ≤15s combined).
+  // The reference arrays are mutually EXCLUSIVE with first/last frame at the
+  // provider (docs.kie.ai/market/wan/3-0-video).
+  "wan-3": { images: 10, videos: 5, audio: 5 },
+  "wan-3-prime": { images: 10, videos: 5, audio: 5 },
   // Multi-image reference providers.
   "gemini-omni-video": { images: 7, videos: 1 },
+  // Gemini Omni Flash 1.1 — identical quota to the pro sibling
+  // (images + 2×videos + character_ids ≤ 7).
+  "gemini-omni-flash": { images: 7, videos: 1 },
   "kling-3-omni": { images: 7 },     // catalog/docs: "end frame + up to 7 reference images"
   "grok-i2v": { images: 7 },         // backend kie/models.ts maxRefImages: 7
   "happyhorse-ref2v": { images: 9 }, // backend kie/models.ts maxRefImages: 9
@@ -1704,10 +1850,15 @@ export const RESOLUTION_VIDEO_REF_PRICING = SEEDANCE_2_PROVIDERS
 /**
  * Video models priced by (duration × resolution) WITHOUT a video-ref dimension.
  * Identifier suffix: `:{resolution}`, appended after the duration tier; value =
- * the provider's PRICED resolution tiers. Any resolution outside the list
- * (or undefined) collapses to the FIRST entry — the provider's default tier —
- * so the builder can never emit an unpriced composite (the hard-fail guard
- * fuzzes the full resolution space). Distinct from
+ * the provider's PRICED resolution tiers.
+ *
+ * Any resolution outside the list (or undefined) collapses to the provider's
+ * DEFAULT tier, so the builder can never emit an unpriced composite (the
+ * hard-fail guard fuzzes the full resolution space). That default is
+ * {@link PRICING_DEFAULT_RESOLUTION} when the provider declares one, and
+ * otherwise the FIRST entry here — so a member with a declared default (wan-3)
+ * can list its tiers in the repo-standard ascending order without index 0
+ * silently becoming the billed default. Distinct from
  * RESOLUTION_VIDEO_REF_PRICING (Seedance gen), which also adds `-ref` variants.
  */
 export const RESOLUTION_DURATION_PRICING: Record<string, readonly string[]> = {
@@ -1723,6 +1874,12 @@ export const RESOLUTION_DURATION_PRICING: Record<string, readonly string[]> = {
   "happyhorse": ["720p", "1080p"],
   "happyhorse-i2v": ["720p", "1080p"],
   "happyhorse-ref2v": ["720p", "1080p"],
+  // Wan 3.0 / Prime — per-second billing at three published resolution rates.
+  // Ascending, matching the catalog; the BILLED default is declared explicitly
+  // in PRICING_DEFAULT_RESOLUTION ("720p") rather than carried by index 0, and
+  // the provider layer pins the same 720P so render == billed.
+  "wan-3": ["480p", "720p", "1080p"],
+  "wan-3-prime": ["480p", "720p", "1080p"],
 }
 
 /**
@@ -1745,6 +1902,13 @@ export const NATIVE_ADAPTIVE_ASPECT: Record<string, string> = {
   "seedance-2-fast": "adaptive",
   "seedance-2-mini": "adaptive",
   "seedance-2-5": "adaptive",
+  // Wan 3.0 family: `adaptive` is the enum DEFAULT and KIE documents it as
+  // "automatically selects the ratio based on the input media and intent"
+  // (docs.kie.ai/market/wan/3-0-video) — i.e. match-the-input, not merely
+  // "provider default" (the grok `auto` trap). DOC-verified only; re-confirm
+  // with a live job before relying on it for off-catalog ratios.
+  "wan-3": "adaptive",
+  "wan-3-prime": "adaptive",
 }
 
 /**
@@ -1843,8 +2007,9 @@ export type VideoAudioMode = "none" | "ambient" | "native_speech" | "audio_drive
 
 export interface VideoAudioCapability {
   mode: VideoAudioMode
-  /** Provider-option field carrying the on/off toggle, when user-controllable. */
-  field?: "generateAudio" | "sound"
+  /** Provider-option field carrying the on/off toggle, when user-controllable.
+   *  `audio` is Wan 3.0's own boolean lever (KIE `input.audio`, default true). */
+  field?: "generateAudio" | "sound" | "audio"
   /** Audio is always produced and can't be turned off by the user (VEO 3.x). */
   alwaysOn?: boolean
   /** Enabling audio raises the credit cost (Kling — see AUDIO_ADDON_PROVIDERS). */
@@ -1903,6 +2068,19 @@ export const VIDEO_AUDIO_CAPABILITY: Record<string, VideoAudioCapability> = {
   // KIE API exposes NO audio on/off parameter (audio is always produced), so
   // there is no toggle field — alwaysOn, like VEO.
   "minimax-h3": { mode: "audio_driven", alwaysOn: true },
+  // Wan 3.0 family — a single boolean `audio` lever (KIE default true) produces
+  // an ambient/SFX track with the clip. Classified "ambient", NOT
+  // "native_speech" or "audio_driven": the schema documents no dialogue
+  // guarantee, and reference audio is a generic conditioning array, not a
+  // verified lip-sync transport. Upgrade only on a live probe (the kling-3.0
+  // standard) — `audio_driven` would reroute the Story→Video dialogue pipeline
+  // and skip the lip-sync pass. `defaultOn` mirrors the KIE default so an
+  // intent-less request is described honestly; audio is priced into the uniform
+  // per-second rate, so NOT cost-affecting (no `:audio` composite).
+  // gemini-omni-flash is deliberately ABSENT — gemini-omni-video is absent too
+  // (mode "none"), and the siblings must not disagree.
+  "wan-3": { mode: "ambient", field: "audio", defaultOn: true },
+  "wan-3-prime": { mode: "ambient", field: "audio", defaultOn: true },
 }
 
 const VIDEO_AUDIO_NONE: VideoAudioCapability = { mode: "none" }
@@ -1974,6 +2152,7 @@ export function applyVideoAudioToggle(
   const enabled = cap.affectsCost ? opts?.sound : (opts?.sound ?? opts?.generateAudio)
   if (enabled === undefined) return // no intent — keep the model's own default
   if (cap.field === "generateAudio") input.generate_audio = enabled
+  else if (cap.field === "audio") input.audio = enabled
   else input.sound = enabled
 }
 
@@ -2029,6 +2208,11 @@ export const VIDEO_VARIABLE_PRICING: Record<string, "duration" | "duration+audio
   "minimax-h3": "duration+resolution",
   // Grok Imagine Video 1.5 — per-second billing split 480p/720p (no video-ref dimension).
   "grok-imagine-video-1.5": "duration+resolution",
+  // Wan 3.0 family — per-second billing at three resolution rates (no video-ref
+  // dimension: reference runs bill output seconds only). No gemini-omni-flash
+  // entry, mirroring gemini-omni-video which has none either.
+  "wan-3": "duration+resolution",
+  "wan-3-prime": "duration+resolution",
 }
 
 /**
@@ -2064,6 +2248,14 @@ export const PRICING_DEFAULT_DURATION_SEC: Record<string, number> = {
 export const PRICING_DEFAULT_RESOLUTION: Record<string, string> = {
   // KIE renders 720p when `resolution` is omitted (kie/models.ts extraParams).
   "seedance-2-5": "720p",
+  // Wan 3.0 family — KIE's OWN default is 1080P, but the provider layer pins
+  // 720P (normalizeWan3Resolution / WAN_3_DEFAULT_RESOLUTION) so the rendered
+  // tier equals the tier the bare identifier bills. This declaration is what
+  // makes the billed default explicit instead of an array ordering: the
+  // RESOLUTION_DURATION_PRICING branch consults it before falling back to the
+  // first tier, so the catalog can stay ascending without repricing anything.
+  "wan-3": "720p",
+  "wan-3-prime": "720p",
 }
 
 /** HappyHorse 1.1 per-second tiers — one per allowed duration (3–15s), shared
@@ -2088,6 +2280,21 @@ const SEEDANCE_2_5_DURATION_TIERS: Array<{ maxSeconds: number; suffix: string }>
   (_, i) => ({ maxSeconds: i + 4, suffix: `${i + 4}s` }),
 )
 
+/**
+ * Wan 3.0 per-second tiers — one per allowed duration (2-30s), shared by both
+ * SKUs (the ladder shape is identical; only the seeded rates differ).
+ *
+ * Per-second is REQUIRED, not a nicety: the ladder snaps a request UP to the
+ * first tier whose `maxSeconds` covers it and falls back to the LAST tier when
+ * none does, so a coarse ladder over a 29-value range would reserve a
+ * short-clip price for a 30s render. `commit_credits` only ever refunds a
+ * surplus and can never collect an upward delta.
+ */
+const WAN_3_DURATION_TIERS: Array<{ maxSeconds: number; suffix: string }> = Array.from(
+  { length: 29 },
+  (_, i) => ({ maxSeconds: i + 2, suffix: `${i + 2}s` }),
+)
+
 /**
  * Duration tier breakpoints for variable-priced video models.
  * Maps provider → array of { maxSeconds, suffix } in ascending order.
@@ -2168,6 +2375,8 @@ export const VIDEO_DURATION_TIERS: Record<string, Array<{ maxSeconds: number; su
     { maxSeconds: 15, suffix: "15s" },
   ],
   "seedance-2-5": SEEDANCE_2_5_DURATION_TIERS,
+  "wan-3": WAN_3_DURATION_TIERS,
+  "wan-3-prime": WAN_3_DURATION_TIERS,
   // MiniMax Hailuo 3 — true per-second billing (KIE 36.5 cr/s @2K, 22.5 cr/s
   // @768P). One tier per allowed second (4-15s) so the composite identifier
   // maps 1:1 to the seeded price — no rounding/overcharge for any on-menu

package/src/node-default-mappings.ts

@@ -187,6 +187,10 @@ const QUALITY_MAP: Record<string, QualityMapping> = {
   // Seedance 2.5 spans 480p/720p/1080p on KIE (1080p accepted since the
   // 2026-08-17 re-probe; 4k still rejected), so each quality rung gets its own tier.
   "seedance-2-5":        { field: "resolution", values: { low: "480p", mid: "720p", high: "1080p" } },
+  // Wan 3.0 family — 480p / 720p / 1080p (lowercase catalog spellings; the
+  // uppercase KIE wire form is produced only by normalizeWan3Resolution).
+  "wan-3":               { field: "resolution", values: { low: "480p", mid: "720p", high: "1080p" } },
+  "wan-3-prime":         { field: "resolution", values: { low: "480p", mid: "720p", high: "1080p" } },
   "wan-2.7-i2v":         { field: "resolution", values: { low: "720p", mid: "1080p", high: "1080p" } },
   "wan-2.7-t2v":         { field: "resolution", values: { low: "720p", mid: "1080p", high: "1080p" } },
   "happyhorse":          { field: "resolution", values: { low: "720p", mid: "1080p", high: "1080p" } },
@@ -200,6 +204,7 @@ const QUALITY_MAP: Record<string, QualityMapping> = {
   "ltx-2.3-pro":         { field: "resolution", values: { low: "1080p", mid: "2k", high: "4k" } },
   "ltx-2.3-fast":        { field: "resolution", values: { low: "1080p", mid: "2k", high: "4k" } },
   "gemini-omni-video":   { field: "resolution", values: { low: "720p", mid: "1080p", high: "4k" } },
+  "gemini-omni-flash":   { field: "resolution", values: { low: "720p", mid: "1080p", high: "4k" } },
   // Grok Imagine Video 1.5 — only 480p/720p (no 1080p tier); high clamps to 720p.
   "grok-imagine-video-1.5": { field: "resolution", values: { low: "480p", mid: "720p", high: "720p" } },
   // Replicate Flux 2 family — MP-based resolution (matching IMAGE_RESOLUTION_OPTIONS["flux-2-*"]).

package/src/video-ui-defaults.ts

@@ -0,0 +1,66 @@
+/**
+ * UI-default fills for the unified video nodes — the ONE source of truth shared
+ * by the backend DAG payload builder, the config-panel fail-safe snaps and the
+ * node's hover/run strip.
+ *
+ * Several config panels RENDER a default without persisting it to node data, so
+ * an untouched node submits `aspectRatio` / `resolution` undefined and the
+ * enqueued job row (and the /v1/jobs echo) then disagrees with what actually
+ * renders. Worse, the panels' generic snap writes `resolutions[0]` for a stale
+ * value, which is the CHEAPEST tier under the repo's ascending-resolution
+ * convention — not necessarily the tier the model renders and bills.
+ *
+ * These helpers were local to `backend/src/services/workflow-engine/payload-builder.ts`
+ * until the Wan 3.0 launch gave the platform its first provider whose declared
+ * billing default differs from `resolutions[0]`; three surfaces then had to
+ * agree, so they live here.
+ *
+ * The resolution fill is per-family ON PURPOSE. Wan 3.0 reads its DECLARED
+ * billing default (PRICING_DEFAULT_RESOLUTION = 720p) because its catalog list
+ * is ascending, so an index-0 fill would write 480p — a tier both `runWan3`
+ * (which renders 720P) and the credit identifier (which bills the 720p row)
+ * disagree with. The Seedance family keeps its historical first-catalog-tier
+ * fill, deliberately: switching it to PRICING_DEFAULT_RESOLUTION would reprice
+ * live seedance-2-5 runs, whose declared default (720p) differs from the 480p
+ * this has always filled. That 480p-fill vs 720p-billing-default divergence on
+ * seedance-2-5 is a KNOWN pre-existing gap, out of scope here — do not "align"
+ * the branches without repricing it deliberately.
+ */
+
+import {
+  PRICING_DEFAULT_RESOLUTION,
+  isSeedance2Provider,
+  isMinimaxH3Provider,
+  isWan3Provider,
+  isGeminiOmniProvider,
+} from "./model-constants.js"
+import { MODEL_CATALOG } from "./model-catalog.js"
+
+/** `adaptive` is the aspect default for Seedance 2, MiniMax H3 and Wan 3.0. */
+export function uiAspectRatioFill(provider: string): string | undefined {
+  return isSeedance2Provider(provider) || isMinimaxH3Provider(provider) || isWan3Provider(provider)
+    ? "adaptive"
+    : undefined
+}
+
+/** See the file docstring — per-family on purpose; never a generic
+ *  PRICING_DEFAULT_RESOLUTION read (that would reprice seedance-2-5). */
+export function uiResolutionFill(provider: string): string | undefined {
+  if (isWan3Provider(provider)) return PRICING_DEFAULT_RESOLUTION[provider]
+  if (isSeedance2Provider(provider)) return MODEL_CATALOG[provider]?.resolutions?.[0]
+  return undefined
+}
+
+/**
+ * Duration the node RENDERS and BILLS when `data.duration` is unset, for the
+ * families whose credit identifier declares a duration fallback that is NOT
+ * `durations[0]`. Wan 3.0's bare identifier is the 5s tier while its ladder
+ * starts at 2s; the Gemini Omni family's is the 8s tier while its ladder starts
+ * at 4s. Everyone else falls back to the first listed duration, so this returns
+ * undefined and the caller keeps `durations[0]`.
+ */
+export function uiDurationFill(provider: string): number | undefined {
+  if (isWan3Provider(provider)) return 5
+  if (isGeminiOmniProvider(provider)) return 8
+  return undefined
+}