@nodaro/shared 3.7.0 → 3.9.0

package/src/i18n/camera-motions.pt-BR.ts

@@ -27,8 +27,8 @@ const map: LocaleCatalogMap = {
   "dolly-in": { description: "Empurra a câmera em direção ao sujeito (com paralaxe)" },
   "dolly-out": { description: "Afasta a câmera (com paralaxe)" },
   "dolly-zoom": { description: "Efeito vertigo: dolly oposto ao zoom" },
-  "push-in": { description: "Empurro lento e sutil em direção ao sujeito" },
-  "pull-out": { description: "Afastamento lento e sutil do sujeito" },
+  "push-in": { description: "Empurro rápido e enérgico em direção ao sujeito" },
+  "pull-out": { description: "Afastamento rápido e enérgico do sujeito" },
   "breathing": { label: "Câmera Respirante", description: "Oscilação contínua e sutil de empurro e afastamento, sensação orgânica de câmera na mão" },
   "push-pull": { label: "Push-Pull / Vai-e-Vem", description: "A câmera se move em direção ao sujeito e depois se afasta, aproximação e retirada oscilantes" },
   "creep-in": { label: "Aproximação Imperceptível", description: "Empurro extremamente lento e imperceptível que constrói pavor ou tensão" },
@@ -48,8 +48,8 @@ const map: LocaleCatalogMap = {
   "dutch-angle": { description: "Quadro estático inclinado para criar tensão" },
 
   // Orbit / Arc
-  "orbit-left": { description: "Volta completa em torno do sujeito para a esquerda" },
-  "orbit-right": { description: "Volta completa em torno do sujeito para a direita" },
+  "orbit-left": { description: "Órbita parcial ampla em torno do sujeito para a esquerda" },
+  "orbit-right": { description: "Órbita parcial ampla em torno do sujeito para a direita" },
   "spin-360": { label: "Giro Completo 360°", description: "A câmera gira 360 graus completos sobre seu próprio eixo" },
   "orbit-360": { label: "Órbita Completa 360°", description: "A câmera descreve um arco completo de 360 graus em torno do sujeito" },
   "arc-left": { description: "Arco parcial em torno do sujeito pela esquerda" },
@@ -88,7 +88,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog": { description: "Câmera na mão estilo vlog descontraído" },
   "pov-walk": { description: "POV de caminhada em primeira pessoa" },
   "velocity-edit": { description: "Pacing com speed-ramp estilo TikTok" },
-  "match-cut-zoom": { description: "Zoom no tempo de batida para corte" },
+  "match-cut-zoom": { description: "Zoom rápido com corte seco para uma forma correspondente" },
   "screen-tap": { description: "Transição com toque na tela" },
   "phone-flip": { description: "Troca entre câmera frontal e traseira" },
   // Location-studio extension (PR #2505 follow-up)

package/src/i18n/camera-motions.ru.ts

@@ -27,8 +27,8 @@ const map: LocaleCatalogMap = {
   "dolly-in": { label: "Долли вперёд", description: "Толчок камеры к объекту (с параллаксом)" },
   "dolly-out": { label: "Долли назад", description: "Отъезд камеры назад (с параллаксом)" },
   "dolly-zoom": { label: "Долли-зум", description: "Эффект головокружения: долли против зума" },
-  "push-in": { label: "Лёгкий наезд", description: "Медленный мягкий наезд на объект" },
-  "pull-out": { label: "Лёгкий отъезд", description: "Медленный мягкий отъезд от объекта" },
+  "push-in": { label: "Резкий наезд", description: "Быстрый энергичный наезд на объект" },
+  "pull-out": { label: "Резкий отъезд", description: "Быстрый энергичный отъезд от объекта" },
   "breathing": { label: "Дышащая камера", description: "Тонкое непрерывное колебание наезд-отъезд, органичное ощущение съёмки с рук" },
   "push-pull": { label: "Push-Pull / Качание", description: "Камера движется к объекту, затем обратно, маятниковое приближение и отдаление" },
   "creep-in": { label: "Незаметный наезд", description: "Чрезвычайно медленный незаметный наезд, нагнетающий страх или напряжение" },
@@ -48,8 +48,8 @@ const map: LocaleCatalogMap = {
   "dutch-angle": { label: "Голландский угол", description: "Статичный наклонённый кадр для напряжения" },
 
   // Orbit / Arc
-  "orbit-left": { label: "Орбита влево", description: "Полный круг вокруг объекта влево" },
-  "orbit-right": { label: "Орбита вправо", description: "Полный круг вокруг объекта вправо" },
+  "orbit-left": { label: "Орбита влево", description: "Большая частичная орбита вокруг объекта влево" },
+  "orbit-right": { label: "Орбита вправо", description: "Большая частичная орбита вокруг объекта вправо" },
   "spin-360": { label: "Полный оборот 360°", description: "Камера поворачивается на полные 360 градусов вокруг своей оси" },
   "orbit-360": { label: "Полная орбита 360°", description: "Камера описывает полную дугу 360 градусов вокруг объекта" },
   "arc-left": { label: "Дуга влево", description: "Частичная дуга вокруг объекта влево" },
@@ -88,7 +88,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog": { label: "Влог с рук", description: "Непринуждённая ручная съёмка в стиле влога" },
   "pov-walk": { label: "POV-ходьба", description: "POV-ходьба от первого лица" },
   "velocity-edit": { label: "Скоростной монтаж", description: "Темп с ускорением в стиле TikTok" },
-  "match-cut-zoom": { label: "Зум для match cut", description: "Зум, синхронизированный с битом для склейки" },
+  "match-cut-zoom": { label: "Зум для match cut", description: "Быстрый зум с резкой склейкой на совпадающую форму" },
   "screen-tap": { label: "Касание экрана", description: "Переход с касанием пальца по экрану" },
   "phone-flip": { label: "Переключение камеры телефона", description: "Переключение между фронтальной и основной камерой" },
   // Location-studio extension (PR #2505 follow-up)

package/src/i18n/camera-motions.zh-CN.ts

@@ -27,8 +27,8 @@ const map: LocaleCatalogMap = {
   "dolly-in":   { label: "推轨",     description: "推动机位靠近被摄对象(带视差)" },
   "dolly-out":  { label: "拉轨",     description: "拉远机位远离被摄对象(带视差)" },
   "dolly-zoom": { label: "滑动变焦", description: "眩晕效果:推轨与变焦反向" },
-  "push-in":    { label: "缓推",     description: "缓慢轻柔地推向被摄对象" },
-  "pull-out":   { label: "缓拉",     description: "缓慢轻柔地拉远被摄对象" },
+  "push-in":    { label: "急推",     description: "快速有力地推向被摄对象" },
+  "pull-out":   { label: "急拉",     description: "快速有力地拉远被摄对象" },
   "breathing":  { label: "呼吸式镜头", description: "细微而连续的推拉震荡,有机的手持质感" },
   "push-pull":  { label: "推拉/摇摆",  description: "镜头先靠近主体再后退,摆动式的接近与撤离" },
   "creep-in":   { label: "渐近推近",   description: "几乎察觉不到的极慢推近,营造恐惧或紧张感" },
@@ -48,8 +48,8 @@ const map: LocaleCatalogMap = {
   "dutch-angle": { label: "荷兰角",   description: "营造紧张感的固定倾斜画面" },
 
   // Orbit / Arc
-  "orbit-left":  { label: "向左环绕",   description: "镜头绕被摄对象向左完整环绕" },
-  "orbit-right": { label: "向右环绕",   description: "镜头绕被摄对象向右完整环绕" },
+  "orbit-left":  { label: "向左环绕",   description: "镜头绕被摄对象向左大幅部分环绕" },
+  "orbit-right": { label: "向右环绕",   description: "镜头绕被摄对象向右大幅部分环绕" },
   "spin-360":    { label: "360°整圈自转", description: "镜头围绕自身轴心整圈360度旋转" },
   "orbit-360":   { label: "360°整圈环绕", description: "镜头围绕主体整圈360度环行" },
   "arc-left":    { label: "左弧形运镜", description: "围绕被摄对象向左做局部弧线" },
@@ -88,7 +88,7 @@ const map: LocaleCatalogMap = {
   "handheld-vlog":  { label: "手持 Vlog",       description: "随性的 Vlog 风格手持" },
   "pov-walk":       { label: "主观行走",         description: "第一人称行走主观镜头" },
   "velocity-edit":  { label: "速度剪辑",         description: "TikTok 节奏的速率变化" },
-  "match-cut-zoom": { label: "节拍变焦",         description: "卡点变焦用于剪辑" },
+  "match-cut-zoom": { label: "节拍变焦",         description: "快速变焦后硬切到相同形状" },
   "screen-tap":     { label: "点屏切换",         description: "屏幕上手指点击触发的转场" },
   "phone-flip":     { label: "翻面切换",         description: "前后摄像头翻转切换" },
   // Location-studio extension (PR #2505 follow-up)

package/src/index.ts

@@ -89,6 +89,12 @@ export {
   AI_WRITER_PROVIDERS,
   QA_CHECK_PROVIDERS,
   SUNO_MODELS,
+  SUNO_ACTIVE_MODELS,
+  SUNO_LEGACY_MODELS,
+  DEFAULT_SUNO_MODEL,
+  SUNO_DURATION_MODELS,
+  isLegacySunoModel,
+  sunoModelHonoursDuration,
   SUNO_ADD_TRACK_MODELS,
   VOICE_DESIGN_MODELS,
   DEFAULT_VOICE_DESIGN_MODEL,
@@ -247,6 +253,7 @@ export {
   pricedVideoSelection,
   buildMotionCreditModelIdentifier,
   sunoCreditType,
+  SUNO_VERSION_CREDIT_KEYS,
   SUNO_VERSION_PRICED_OPERATIONS,
   SUNO_SELECT_OPERATIONS,
 } from "./credit-identifiers.js"
@@ -1066,6 +1073,9 @@ export * from "./scene3d-v2-resources.js"
 export * from "./scene3d-camera-track.js"
 // --- 3D Render Pro: one durable operation, scene + video in one result ---
 export * from "./pro-3d-render.js"
+// --- Scene3D render pricing: which frame-size tier a render settles at.
+//     The SHAPE of the price (tier, multiplier, identifier); never a rate. ---
+export * from "./scene3d-render-pricing.js"
 
 // --- transient studio keys — the public share read strips them ---
 export {

package/src/model-catalog.ts

@@ -207,7 +207,7 @@ export const MODEL_RECOMMENDATIONS: readonly ModelRecommendation[] = [
   { intent: "best cinematic video", modelIds: ["veo3", "kling-3.0", "seedance-2"], note: "VEO 3.1 Quality for premium narrative; Kling 3.0 for music-synced motion; Seedance 2 for reference-driven consistency." },
   { intent: "cheap batch video clips", modelIds: ["veo3.1", "wan-turbo", "bytedance-lite"], note: "VEO 3.1 Fast is the best price/quality balance with native audio." },
   { intent: "video with start + end frame", modelIds: ["veo3", "veo3.1", "kling-turbo", "minimax", "hailuo-standard", "seedance-2"], note: "All listed support an end frame; VEO uses imageUrls[start, end]." },
-  { intent: "music / song generation", modelIds: ["suno-v5", "suno"], note: "Suno v5 has better vocal quality at the same price." },
+  { intent: "music / song generation", modelIds: ["suno-v6", "suno-v6_wild", "suno-v6_mini", "suno-v5_5"], note: "V6 is the default flagship; V6 Wild for bolder, less predictable results; V6 Mini when speed matters; v5.5 / v5 / v4 keep their own character. Same price." },
   { intent: "voice over / narration", modelIds: ["elevenlabs-v3", "elevenlabs-turbo"], note: "v3 supports [audio tags] for emotion; Turbo is cheaper for plain narration." },
   { intent: "lip-sync a portrait to audio", modelIds: ["kling-avatar-pro", "kling-avatar", "infinitalk"], note: "Pro for best mouth shape; InfiniTalk for resolution control." },
   { intent: "transcription / captions", modelIds: ["elevenlabs-stt"], note: "Word-level timestamps available." },
@@ -233,6 +233,15 @@ const KONTEXT_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4", "21:9"] as const
 const GROK_RATIOS = ["1:1", "16:9", "9:16", "3:2", "2:3"] as const
 const GPT_IMAGE_RATIOS = ["1:1", "3:2", "2:3"] as const
 const GPT_IMAGE_2_RATIOS = ["auto", "1:1", "16:9", "9:16", "4:3", "3:4"] as const
+// GPT Image 2.5 (Flare + Sunburst) widen the set to thirteen — the GPT Image 2
+// six plus 3:2/2:3, ultra-wide 21:9/27:16, ultra-tall 16:27 and near-square
+// 9:8/8:9 (docs.kie.ai/market/gpt/gpt-image-2-5-*). Unlike GPT Image 2, the 2.5
+// docs state NO aspect-ratio x resolution restriction, so no cross-field
+// constraint is registered for these ids in normalizeModelInput below.
+const GPT_IMAGE_2_5_RATIOS = [
+  "auto", "1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16",
+  "21:9", "27:16", "16:27", "9:8", "8:9",
+] as const
 const IMAGEN4_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4"] as const
 const IDEOGRAM_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4"] as const
 const SEEDREAM_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "21:9"] as const
@@ -591,6 +600,103 @@ const IMAGE_MODELS: Record<string, ModelCatalogEntry> = {
     ],
   },
 
+  "gpt-image-2-5-flare": {
+    id: "gpt-image-2-5-flare",
+    kind: "image",
+    modes: ["t2i"] as const,
+    family: "OpenAI",
+    label: "GPT Image 2.5 Flare",
+    series: "GPT Image",
+    description: "Fast everyday GPT Image 2.5 - higher quality than GPT Image 2 at about half the latency. The default of the pair: social and creator content, campaign variants, thumbnails, rapid iteration, high-volume work.",
+    useCases: ["typography", "high-res", "general", "draft"],
+    features: ["reference-image"],
+    aspectRatios: GPT_IMAGE_2_5_RATIOS,
+    resolutions: ["1K", "2K", "4K"],
+    pricing: [
+      { identifier: "gpt-image-2-5-flare", credits: 15, note: "1K default" },
+      { identifier: "gpt-image-2-5-flare:2K", credits: 25, note: "2K" },
+      { identifier: "gpt-image-2-5-flare:4K", credits: 40, note: "4K" },
+    ],
+    valueLabels: {
+      "3:2": "3:2 (Landscape)", "2:3": "2:3 (Portrait)",
+      "27:16": "27:16 (Ultra-wide)", "16:27": "16:27 (Ultra-tall)",
+      "9:8": "9:8 (Near-square)", "8:9": "8:9 (Near-square)",
+    },
+    safetyFilter: { stochastic: true, fallback: "nano-banana-pro" },
+  },
+  "gpt-image-2-5-flare-i2i": {
+    id: "gpt-image-2-5-flare-i2i",
+    kind: "image",
+    modes: ["i2i"] as const,
+    family: "OpenAI",
+    label: "GPT Image 2.5 Flare (I2I)",
+    series: "GPT Image",
+    description: "Fast GPT Image 2.5 edits (up to 16 source images) - the default when you are iterating rather than finishing.",
+    useCases: ["edit", "high-res"],
+    features: ["reference-image"],
+    aspectRatios: GPT_IMAGE_2_5_RATIOS,
+    resolutions: ["1K", "2K", "4K"],
+    pricing: [
+      { identifier: "gpt-image-2-5-flare-i2i", credits: 15, note: "1K default" },
+      { identifier: "gpt-image-2-5-flare-i2i:2K", credits: 25, note: "2K" },
+      { identifier: "gpt-image-2-5-flare-i2i:4K", credits: 40, note: "4K" },
+    ],
+    valueLabels: {
+      "3:2": "3:2 (Landscape)", "2:3": "2:3 (Portrait)",
+      "27:16": "27:16 (Ultra-wide)", "16:27": "16:27 (Ultra-tall)",
+      "9:8": "9:8 (Near-square)", "8:9": "8:9 (Near-square)",
+    },
+    safetyFilter: { stochastic: true, fallback: "nano-banana-pro" },
+  },
+  "gpt-image-2-5-sunburst": {
+    id: "gpt-image-2-5-sunburst",
+    kind: "image",
+    modes: ["t2i"] as const,
+    family: "OpenAI",
+    label: "GPT Image 2.5 Sunburst",
+    series: "GPT Image",
+    description: "Precision GPT Image 2.5 - trades generation time for tighter control and detail fidelity. Pick it for brand-sensitive and production work: packaging, diagrams, ecommerce retouching, polished campaign creative.",
+    useCases: ["typography", "high-res", "general"],
+    features: ["reference-image"],
+    aspectRatios: GPT_IMAGE_2_5_RATIOS,
+    resolutions: ["1K", "2K", "4K"],
+    pricing: [
+      { identifier: "gpt-image-2-5-sunburst", credits: 15, note: "1K default" },
+      { identifier: "gpt-image-2-5-sunburst:2K", credits: 25, note: "2K" },
+      { identifier: "gpt-image-2-5-sunburst:4K", credits: 40, note: "4K" },
+    ],
+    valueLabels: {
+      "3:2": "3:2 (Landscape)", "2:3": "2:3 (Portrait)",
+      "27:16": "27:16 (Ultra-wide)", "16:27": "16:27 (Ultra-tall)",
+      "9:8": "9:8 (Near-square)", "8:9": "8:9 (Near-square)",
+    },
+    safetyFilter: { stochastic: true, fallback: "nano-banana-pro" },
+  },
+  "gpt-image-2-5-sunburst-i2i": {
+    id: "gpt-image-2-5-sunburst-i2i",
+    kind: "image",
+    modes: ["i2i"] as const,
+    family: "OpenAI",
+    label: "GPT Image 2.5 Sunburst (I2I)",
+    series: "GPT Image",
+    description: "Precision GPT Image 2.5 edits (up to 16 source images) - the most controlled edit in the GPT family, at the cost of a longer run.",
+    useCases: ["edit", "high-res"],
+    features: ["reference-image"],
+    aspectRatios: GPT_IMAGE_2_5_RATIOS,
+    resolutions: ["1K", "2K", "4K"],
+    pricing: [
+      { identifier: "gpt-image-2-5-sunburst-i2i", credits: 15, note: "1K default" },
+      { identifier: "gpt-image-2-5-sunburst-i2i:2K", credits: 25, note: "2K" },
+      { identifier: "gpt-image-2-5-sunburst-i2i:4K", credits: 40, note: "4K" },
+    ],
+    valueLabels: {
+      "3:2": "3:2 (Landscape)", "2:3": "2:3 (Portrait)",
+      "27:16": "27:16 (Ultra-wide)", "16:27": "16:27 (Ultra-tall)",
+      "9:8": "9:8 (Near-square)", "8:9": "8:9 (Near-square)",
+    },
+    safetyFilter: { stochastic: true, fallback: "nano-banana-pro" },
+  },
+
   // ── Ideogram ──
   // Ideogram models use a `rendering_speed` (TURBO / BALANCED / QUALITY)
   // dimension that's distinct from the `quality` lever — frontend exposes
@@ -2474,7 +2580,7 @@ const AUDIO_MODELS: Record<string, ModelCatalogEntry> = {
     label: "Suno v5",
     series: "Suno",
     dataValue: "V5",
-    description: "Newer Suno v5 — better vocal quality, more genres. Same price as v4.",
+    description: "Suno v5 — better vocal quality than v4, more genres. Same price.",
     useCases: ["music", "song", "vocals", "premium"],
     pricing: [{ identifier: "suno-v5", credits: 30, note: "per generation" }],
   },
@@ -2486,11 +2592,47 @@ const AUDIO_MODELS: Record<string, ModelCatalogEntry> = {
     label: "Suno v5.5",
     series: "Suno",
     dataValue: "V5_5",
-    description: "Suno v5.5 — latest model with improved audio quality and expressiveness.",
+    description: "Suno v5.5 — improved audio quality and expressiveness over v5.",
     useCases: ["music", "song", "vocals", "premium"],
     pricing: [{ identifier: "suno-v5_5", credits: 30, note: "per generation" }],
+  },
+  "suno-v6": {
+    id: "suno-v6",
+    kind: "audio",
+    modes: ["music"] as const,
+    family: "Suno",
+    label: "Suno V6",
+    series: "Suno",
+    dataValue: "V6",
+    description: "Suno V6 — greater musical expression with more natural vocals and richer details. The flagship and the default.",
+    useCases: ["music", "song", "vocals", "premium"],
+    pricing: [{ identifier: "suno-v6", credits: 30, note: "per generation" }],
     featured: true,
   },
+  "suno-v6_wild": {
+    id: "suno-v6_wild",
+    kind: "audio",
+    modes: ["music"] as const,
+    family: "Suno",
+    label: "Suno V6 Wild",
+    series: "Suno",
+    dataValue: "V6_WILD",
+    description: "Suno V6 Wild — pushes creative boundaries for bolder, more distinctive musical expression; more varied, less predictable results.",
+    useCases: ["music", "song", "vocals", "experimental"],
+    pricing: [{ identifier: "suno-v6_wild", credits: 30, note: "per generation" }],
+  },
+  "suno-v6_mini": {
+    id: "suno-v6_mini",
+    kind: "audio",
+    modes: ["music"] as const,
+    family: "Suno",
+    label: "Suno V6 Mini",
+    series: "Suno",
+    dataValue: "V6_MINI",
+    description: "Suno V6 Mini — lightweight and fast, balancing quality and speed for effortless creation.",
+    useCases: ["music", "song", "vocals", "fast"],
+    pricing: [{ identifier: "suno-v6_mini", credits: 30, note: "per generation" }],
+  },
 }
 
 // =============================================================================

package/src/model-constants.ts

@@ -44,6 +44,9 @@ export const IMAGE_ASPECT_RATIO_VALUES = [
   // Ultra-wide / ultra-tall banner ratios: Wan 2.7 + Wan 2.7 Pro (8:1, 1:8)
   // and Nano Banana 2 Lite (4:1, 1:4, 8:1, 1:8).
   "4:1", "1:4", "8:1", "1:8",
+  // GPT Image 2.5 (Flare + Sunburst) additions: near-square and ultra-wide/tall
+  // cinema ratios (docs.kie.ai/market/gpt/gpt-image-2-5-*).
+  "27:16", "16:27", "9:8", "8:9",
 ] as const
 
 /** A ratio string the image routes accept (pre-snap vocabulary, not a per-model guarantee). */
@@ -76,6 +79,11 @@ export const MAX_IMAGE_PROMPT_CHARS_BY_PROVIDER: Record<string, number> = {
   "nano-banana-2-lite": 20000, // docs.kie.ai/market/google/nano-banana-2-lite
   "nano-banana-pro": 20000,    // docs.kie.ai/market/google/pro-image-to-image
   "gpt-image-2-i2i": 20000,    // docs.kie.ai/market/gpt/gpt-image-2-image-to-image
+  // GPT Image 2.5 — all four lanes document a 20000-char prompt ceiling.
+  "gpt-image-2-5-flare": 20000,          // docs.kie.ai/market/gpt/gpt-image-2-5-flare-text-to-image
+  "gpt-image-2-5-flare-i2i": 20000,      // docs.kie.ai/market/gpt/gpt-image-2-5-flare-image-to-image
+  "gpt-image-2-5-sunburst": 20000,       // docs.kie.ai/market/gpt/gpt-image-2-5-sunburst-text-to-image
+  "gpt-image-2-5-sunburst-i2i": 20000,   // docs.kie.ai/market/gpt/gpt-image-2-5-sunburst-image-to-image
   // ── lower than the 5000 default (over-send risk if left at default) ──
   "seedream": 3000,            // docs.kie.ai/market/seedream/4-5-text-to-image
   "seedream-edit": 3000,       // docs.kie.ai/market/seedream/4-5-edit
@@ -111,10 +119,10 @@ export const VIDEO_PROMPT_MAX = 8000
 
 /**
  * Suno prompt / lyrics / content ceiling — the LARGEST any Suno version accepts
- * in custom mode (V4.5 / V4.5PLUS / V4.5ALL / V5 / V5.5 = 5000). NOT the route
+ * in custom mode (V6 family and V4.5+ / V5 / V5.5 = 5000). NOT the route
  * Zod bound — the routes bind at {@link SUNO_HARD_CEILING} and clamp to the
  * per-version cap via {@link getMaxSunoPromptChars} (3000 non-custom for every
- * version; in custom mode 3000 for V4/V3.5, 5000 for V4.5+/V5) before the job
+ * version; in custom mode 3000 for V4/V3.5, 5000 for V4.5+/V5/V6) before the job
  * is built. This constant is shared with the editor `maxLength` / counter
  * (warn-don't-block at the per-version cap). `style` and `title` have their
  * own caps ({@link getMaxSunoStyleChars} / {@link SUNO_TITLE_MAX}).
@@ -302,9 +310,11 @@ export function getMaxTtsChars(provider: string | undefined): number {
  * SUNO_TEXT_MAX} is 5000 today — the largest per-version prompt cap; the
  * route Zod bound is {@link SUNO_HARD_CEILING}.)
  *   - prompt / lyrics: 3000 in non-custom mode (all versions); in custom mode
- *     3000 for V4/V3.5 and 5000 for V4.5 / V4.5PLUS / V4.5ALL / V5 / V5.5.
- *   - style: 200 for V4/V3.5, 1000 for V4.5+.
- *   - title: 80 (all versions).
+ *     3000 for V4/V3.5 and 5000 for V4.5 / V4.5PLUS / V4.5ALL / V5 / V5.5 and
+ *     the whole V6 family (V6 / V6_WILD / V6_MINI).
+ *   - style: 200 for V4/V3.5, 1000 for V4.5+ and V6.
+ *   - title: 80 (all versions; the extend docs quote 100 for V6 — we keep the
+ *     stricter generate cap so one value is right everywhere).
  */
 export const SUNO_TITLE_MAX = 80
 
@@ -475,6 +485,8 @@ export const MODELS_WITH_REFERENCE_IMAGE_SUPPORT = new Set([
   // T2I providers that auto-route to their i2i sibling when refs are attached
   "gpt-image",
   "gpt-image-2",
+  "gpt-image-2-5-flare",
+  "gpt-image-2-5-sunburst",
   "grok",
   "grok-2",
   "qwen",
@@ -487,6 +499,8 @@ export const MODELS_WITH_REFERENCE_IMAGE_SUPPORT = new Set([
   "nano-banana-edit",
   "gpt-image-i2i",
   "gpt-image-2-i2i",
+  "gpt-image-2-5-flare-i2i",
+  "gpt-image-2-5-sunburst-i2i",
   "grok-2-i2i",
   "flux-i2i",
   "flux-pro-i2i",
@@ -525,6 +539,8 @@ export const MODELS_WITH_REFERENCE_IMAGE_SUPPORT = new Set([
 export const T2I_TO_I2I_VARIANT: Record<string, string> = {
   "gpt-image": "gpt-image-i2i",
   "gpt-image-2": "gpt-image-2-i2i",
+  "gpt-image-2-5-flare": "gpt-image-2-5-flare-i2i",
+  "gpt-image-2-5-sunburst": "gpt-image-2-5-sunburst-i2i",
   "grok": "grok-i2i",
   // grok-2's t2i takes NO image input; its "i2i" is the segment-map(image_url)
   // → image-edit(task_id) chain in the KIE provider (single reference).
@@ -560,6 +576,8 @@ export const REF_IMAGE_MAX_LIMITS: Record<string, number> = {
   "nano-banana-edit": 8,
   "gpt-image-i2i": 16,
   "gpt-image-2-i2i": 16,
+  "gpt-image-2-5-flare-i2i": 16,
+  "gpt-image-2-5-sunburst-i2i": 16,
   "flux-i2i": 4,
   "flux-pro-i2i": 4,
   "seedream-edit": 16,
@@ -625,6 +643,10 @@ export const VARIABLE_PRICING_MODELS: Record<string, "quality" | "resolution" |
   "gpt-image-i2i": "quality",
   "gpt-image-2": "resolution",
   "gpt-image-2-i2i": "resolution",
+  "gpt-image-2-5-flare": "resolution",
+  "gpt-image-2-5-flare-i2i": "resolution",
+  "gpt-image-2-5-sunburst": "resolution",
+  "gpt-image-2-5-sunburst-i2i": "resolution",
   "nano-banana-pro": "resolution",
   "nano-banana-2": "resolution",
   "flux": "resolution",
@@ -658,6 +680,10 @@ export const RESOLUTION_2K_4K_TIERED_PROVIDERS = new Set([
   "nano-banana-2",
   "gpt-image-2",
   "gpt-image-2-i2i",
+  "gpt-image-2-5-flare",
+  "gpt-image-2-5-flare-i2i",
+  "gpt-image-2-5-sunburst",
+  "gpt-image-2-5-sunburst-i2i",
   "wan-2.7",
   "wan-2.7-pro",
 ])
@@ -680,6 +706,8 @@ export const IMAGE_GEN_PROVIDERS = [
   "grok-2",
   "gpt-image",
   "gpt-image-2",
+  "gpt-image-2-5-flare",
+  "gpt-image-2-5-sunburst",
   "imagen4",
   "imagen4-fast",
   "imagen4-ultra",
@@ -711,6 +739,8 @@ export const IMAGE_I2I_PROVIDERS = [
   "flux-pro-i2i",
   "gpt-image-i2i",
   "gpt-image-2-i2i",
+  "gpt-image-2-5-flare-i2i",
+  "gpt-image-2-5-sunburst-i2i",
   "grok-2-i2i",
   "ideogram-edit",
   "ideogram-remix",
@@ -1201,19 +1231,72 @@ export const QA_CHECK_PROVIDERS = [
 ] as const
 export type QaCheckProvider = typeof QA_CHECK_PROVIDERS[number]
 
-/** Suno model versions */
-export const SUNO_MODELS = [
-  "V4",
-  "V4_5",
+/**
+ * The current Suno generation (docs.kie.ai/suno-api/generate-music, 2026-09:
+ * the V6 family), listed first in every picker; V6 is the default.
+ *
+ *   - V6      — flagship: greater musical expression, more natural vocals, richer details.
+ *   - V6_WILD — bolder, more distinctive, less predictable output for exploration.
+ *   - V6_MINI — lightweight and fast; quality/speed balance.
+ *
+ * This is also the set that honours `duration` ({@link SUNO_DURATION_MODELS}).
+ */
+export const SUNO_ACTIVE_MODELS = ["V6", "V6_WILD", "V6_MINI"] as const
+export type SunoActiveModel = typeof SUNO_ACTIVE_MODELS[number]
+
+/**
+ * The earlier Suno generations. Still offered in every picker as ordinary
+ * choices (users report each has its own character), still accepted by every
+ * route, and confirmed generating on 2026-09-11. KIE's docs tag them
+ * "Discontinued"; if KIE ever stops serving one, coerce it to
+ * {@link DEFAULT_SUNO_MODEL} at the provider send seam — never remove it from
+ * {@link SUNO_MODELS}, which would 400 every saved music workflow.
+ */
+export const SUNO_LEGACY_MODELS = [
+  "V5_5",
+  "V5",
   "V4_5PLUS",
   "V4_5ALL",
-  "V5",
-  "V5_5",
+  "V4_5",
+  "V4",
 ] as const
+export type SunoLegacyModel = typeof SUNO_LEGACY_MODELS[number]
+
+/**
+ * Every Suno model version — the picker order, the route / MCP Zod enum and
+ * the `data.model` type on Suno nodes. Current generation first (V6 = default),
+ * then the earlier generations newest-first.
+ */
+export const SUNO_MODELS = [...SUNO_ACTIVE_MODELS, ...SUNO_LEGACY_MODELS] as const
 export type SunoModel = typeof SUNO_MODELS[number]
 
-/** Suno models that support add-instrumental / add-vocals operations */
-export const SUNO_ADD_TRACK_MODELS = ["V4_5PLUS", "V5", "V5_5"] as const
+/** The Suno version used when a caller omits `model` — KIE's own default. */
+export const DEFAULT_SUNO_MODEL = "V6" satisfies SunoActiveModel
+
+export function isLegacySunoModel(model: string | undefined): model is SunoLegacyModel {
+  return (SUNO_LEGACY_MODELS as readonly string[]).includes(model ?? "")
+}
+
+/**
+ * Suno versions that HONOUR `duration` (custom mode only). Per the generate /
+ * extend docs the field "will only take effect when the model is V6, V6_MINI,
+ * or V6_WILD" — V5_5 was struck from that sentence when V6 shipped. The
+ * provider client's send-gate (`sunoGenerate` in suno-client.ts) is the single
+ * chokepoint that consults this set; the editor uses it only to decide whether
+ * to SHOW the duration field.
+ */
+export const SUNO_DURATION_MODELS: ReadonlySet<string> = new Set<SunoModel>(SUNO_ACTIVE_MODELS)
+
+export function sunoModelHonoursDuration(model: string | undefined): boolean {
+  return SUNO_DURATION_MODELS.has(model ?? "")
+}
+
+/**
+ * Suno models accepted by add-instrumental / add-vocals (docs enum: the V6
+ * family plus V4_5PLUS / V5 / V5_5). Same current-then-earlier order as
+ * {@link SUNO_MODELS}.
+ */
+export const SUNO_ADD_TRACK_MODELS = [...SUNO_ACTIVE_MODELS, "V4_5PLUS", "V5", "V5_5"] as const
 export type SunoAddTrackModel = typeof SUNO_ADD_TRACK_MODELS[number]
 
 /** Voice design models */
@@ -1250,6 +1333,8 @@ export const IMAGE_MASK_MODE: Record<ImageGenProvider, ImageMaskMode> = {
   "nano-banana-2-lite": "prompt",
   "gpt-image": "prompt",
   "gpt-image-2": "prompt",
+  "gpt-image-2-5-flare": "prompt",
+  "gpt-image-2-5-sunburst": "prompt",
   "seedream": "prompt",
   "seedream-5-lite": "prompt",
   "seedream-5-pro": "prompt",

package/src/node-default-mappings.ts

@@ -167,6 +167,10 @@ const QUALITY_MAP: Record<string, QualityMapping> = {
   "flux-pro-i2i":        { field: "resolution", values: { low: "1K", mid: "2K", high: "2K" } },
   "gpt-image-2":         { field: "resolution", values: { low: "1K", mid: "2K", high: "4K" } },
   "gpt-image-2-i2i":     { field: "resolution", values: { low: "1K", mid: "2K", high: "4K" } },
+  "gpt-image-2-5-flare": { field: "resolution", values: { low: "1K", mid: "2K", high: "4K" } },
+  "gpt-image-2-5-flare-i2i": { field: "resolution", values: { low: "1K", mid: "2K", high: "4K" } },
+  "gpt-image-2-5-sunburst": { field: "resolution", values: { low: "1K", mid: "2K", high: "4K" } },
+  "gpt-image-2-5-sunburst-i2i": { field: "resolution", values: { low: "1K", mid: "2K", high: "4K" } },
   // Image gen — quality-style (medium/high or basic/high)
   "gpt-image":           { field: "quality",    values: { low: "medium", mid: "medium", high: "high" } },
   "gpt-image-i2i":       { field: "quality",    values: { low: "medium", mid: "medium", high: "high" } },

package/src/pipeline-types.ts

@@ -54,6 +54,8 @@ export const PIPELINE_PINNABLE_IMAGE_MODELS = [
   "flux",
   "gpt-image",
   "gpt-image-2",
+  "gpt-image-2-5-flare",
+  "gpt-image-2-5-sunburst",
 ] as const
 export type PipelinePinnableImageModel = (typeof PIPELINE_PINNABLE_IMAGE_MODELS)[number]
 

package/src/pro-3d-render.ts

@@ -271,6 +271,23 @@ export interface Pro3DRenderValidationWarning {
   shotId?: string
 }
 
+/**
+ * One still per shot of the exported composition.
+ *
+ * A render's contact sheet: the frame a shot OPENS on, which is the frame that
+ * says what the shot is of. `shotIndex` is the 0-based position in the v2
+ * composition's `shots` array — a v1 (single-shot) scene has exactly one still,
+ * index 0 at frame 0 — and `frame` is that shot's own first frame in the
+ * composition's frame space, so a caller can line a still up against the MP4
+ * without re-deriving shot boundaries.
+ */
+export interface Pro3DRenderShotStill {
+  shotIndex: number
+  frame: number
+  assetId: string
+  url: string
+}
+
 export interface Pro3DRenderResultMetadata {
   width: number
   height: number
@@ -299,6 +316,12 @@ export interface Pro3DRenderJobOutput {
   scenePlan: Scene3DPlan
   sceneRevisionId: string
   posterAssetId: string
+  /**
+   * One still per shot, ordered by `shotIndex`. Optional and additive: a
+   * runtime that does not render stills yet returns a complete result without
+   * them, and a result that HAS them has one for every shot.
+   */
+  shotStills?: Pro3DRenderShotStill[]
   /** Present when an editable native source was retained for this revision. */
   sourceArtifactId?: string
   validation: {
@@ -324,12 +347,22 @@ export interface Pro3DRenderJobOutput {
  * them to satisfy the schema; a runtime that has not produced them yet simply
  * does not parse as complete, which is the honest answer.
  */
+export const pro3DRenderShotStillSchema = z
+  .object({
+    shotIndex: z.number().int().min(0),
+    frame: z.number().int().min(0),
+    assetId: z.string().min(1),
+    url: z.string().min(1),
+  })
+  .passthrough()
+
 export const pro3DRenderJobOutputSchema = z
   .object({
     videoUrl: z.string().min(1),
     scenePlan: scene3DAnyPlanSchema,
     sceneRevisionId: z.string().min(1),
     posterAssetId: z.string().min(1),
+    shotStills: z.array(pro3DRenderShotStillSchema).optional(),
     sourceArtifactId: z.string().min(1).optional(),
     validation: z
       .object({
@@ -364,6 +397,28 @@ export function isPro3DRenderJobOutput(value: unknown): value is Pro3DRenderJobO
   return pro3DRenderJobOutputSchema.safeParse(value).success
 }
 
+/**
+ * The stills on a result, in shot order — the ONE reader every surface uses.
+ *
+ * Tolerant on purpose: this runs on canvas node data, on a job row read back
+ * from the database and on an MCP result envelope, and in every one of those a
+ * missing or malformed list means "this result has no stills", never "refuse
+ * the whole result". Sorting here is what lets `shotStills[i]` mean shot `i`
+ * at every call site without each one remembering to sort.
+ */
+export function pro3DRenderShotStills(output: unknown): Pro3DRenderShotStill[] {
+  const list = (output as { shotStills?: unknown } | null | undefined)?.shotStills
+  if (!Array.isArray(list)) return []
+  const parsed = list.flatMap((entry) => {
+    const result = pro3DRenderShotStillSchema.safeParse(entry)
+    return result.success
+      ? [{ shotIndex: result.data.shotIndex, frame: result.data.frame,
+          assetId: result.data.assetId, url: result.data.url }]
+      : []
+  })
+  return parsed.sort((a, b) => a.shotIndex - b.shotIndex)
+}
+
 /**
  * The two fields every EXECUTION SURFACE must be able to resolve, whatever
  * else a runtime does or does not attach yet.