kingkont 0.20.26 → 0.20.28

package/lib/providers.js

@@ -322,23 +322,21 @@ async function startGeneration(args) {
   const orAvailable = s.useOpenrouter && process.env.OPENROUTER_API_KEY;
   const orImgModel = kind === 'image' && OPENROUTER_IMAGE_MODELS[orKey];
   const orVidModel = kind === 'video' && OPENROUTER_VIDEO_MODELS[orKey];
-  // OpenRouter video API (/api/v1/videos) принимает только ОДНО `image_input`
-  // (см. _startGenerationViaOpenRouterVideo). Если refs > 1 — второй+ silent-drop.
-  // Юзер: «дал 2 референса, кажется ни один не заюзан» (на самом деле #1 ушёл,
-  // #2 потерян). Авто-роутинг multi-ref video на Chatium/KIE — там
-  // reference_image_urls/imageInputs принимают массив. Если ни Chatium ни
-  // KIE не настроены — fallback на OR с первым ref + warning (лучше работающая
-  // генерация с потерей #2, чем ошибка «нет провайдера»).
-  const orVidMultiRef = orVidModel && kind === 'video' && (imageInputs?.length || 0) > 1;
+  // OpenRouter video API (/api/v1/videos) поддерживает до 2 refs через
+  // `frame_images` (first_frame + last_frame, см. _startGenerationViaOpenRouterVideo).
+  // Если refs > 2 — лишние теряем (frame_images семантически именно 2 кадра,
+  // а не «многоракурсные референсы»). Авто-роутинг multi-ref на Chatium/KIE
+  // — там reference_image_urls/imageInputs принимают массив любой длины.
+  const orVidExcessRefs = orVidModel && kind === 'video' && (imageInputs?.length || 0) > 2;
   const _kieOkForOrKey = s.useKie && process.env.KIE_API_KEY && kind === 'video' && KIE_VIDEO_MODELS[orKey];
   const _chatiumOkForOrKey = s.useChatium && s.chatium?.token && s.chatium?.base && kind === 'video' && CHATIUM_VIDEO_MODELS[orKey];
-  const orVidShouldFallback = orVidMultiRef && (_kieOkForOrKey || _chatiumOkForOrKey);
-  if (orVidMultiRef) {
+  const orVidShouldFallback = orVidExcessRefs && (_kieOkForOrKey || _chatiumOkForOrKey);
+  if (orVidExcessRefs) {
     if (orVidShouldFallback) {
       const target = _kieOkForOrKey ? 'KIE' : 'Chatium';
-      console.warn(`[providers] video "${orKey}" с ${imageInputs.length} refs → OpenRouter /videos принимает 1, роутим через ${target}`);
+      console.warn(`[providers] video "${orKey}" с ${imageInputs.length} refs → OpenRouter принимает 2 (first/last frame), роутим через ${target}`);
     } else {
-      console.warn(`[providers] video "${orKey}" с ${imageInputs.length} refs, но Chatium/KIE для неё недоступны → используем OpenRouter с первым ref (остальные ${imageInputs.length - 1} проигнорированы)`);
+      console.warn(`[providers] video "${orKey}" с ${imageInputs.length} refs, но Chatium/KIE недоступны → OR с первыми 2 (остальные ${imageInputs.length - 2} проигнорированы)`);
     }
   }
   if (orAvailable && orImgModel) {
@@ -346,7 +344,7 @@ async function startGeneration(args) {
   }
   if (orAvailable && orVidModel && !orVidShouldFallback) {
     return await _startGenerationViaOpenRouterVideo({
-      key: orKey, prompt, imageInputs, firstFrame, aspectRatio, resolution, duration,
+      key: orKey, prompt, imageInputs, firstFrame, lastFrame, aspectRatio, resolution, duration,
     });
   }
 
@@ -520,7 +518,7 @@ async function _startGenerationViaOpenRouter({ key, prompt, imageInputs, aspectR
 // делает GET к polling_url (требует Bearer), при completed возвращает
 // первый из unsigned_urls (тоже с auth — клиент идёт через /api/proxy,
 // proxy-handler в server.js добавит Authorization для openrouter.ai/...).
-async function _startGenerationViaOpenRouterVideo({ key, prompt, imageInputs, firstFrame, aspectRatio, resolution, duration }) {
+async function _startGenerationViaOpenRouterVideo({ key, prompt, imageInputs, firstFrame, lastFrame, aspectRatio, resolution, duration }) {
   const apiKey = process.env.OPENROUTER_API_KEY;
   const model = OPENROUTER_VIDEO_MODELS[key];
   if (!model) throw new Error(`OpenRouter не поддерживает video-модель "${key}"`);
@@ -528,21 +526,42 @@ async function _startGenerationViaOpenRouterVideo({ key, prompt, imageInputs, fi
   if (duration) body.duration = +duration;
   if (aspectRatio) body.aspect_ratio = aspectRatio;
   if (resolution) body.resolution = resolution;
-  // image-to-video: первый кадр или первая ref-картинка.
-  // ВАЖНО: OpenRouter `/api/v1/videos` ждёт поле `image_url` (single),
-  // а не `image_input`. Раньше слали `image_input` — OpenRouter молча
-  // игнорировал и генерил text-to-video (юзер: «1 реф — он его не использовал»).
-  // Если у seedance/kling/veo через OR появятся ещё параметры для i2v
-  // (last_image_url для end-frame и т.д.) — добавлять по тому же принципу.
-  const startImage = firstFrame || (Array.isArray(imageInputs) && imageInputs[0]) || null;
-  if (startImage) body.image_url = startImage;
+  // image-to-video: правильная схема OR `/api/v1/videos` — массив
+  // `frame_images` с объектами `{type:"image_url", image_url:{url}, frame_type}`.
+  // Поддерживаемые frame_type для seedance/kling: "first_frame", "last_frame"
+  // (см. /api/v1/videos/models → supported_frame_images).
+  // Раньше слали bare `image_input`/`image_url` строкой — OR молча игнорировал,
+  // и генерация шла как text-to-video. Юзер: «1 реф — он не использовался».
+  // Проверено эмпирически: сравнение двух запросов с одинаковым промптом,
+  // один с `frame_images`, другой с bare-полем → результаты ВИЗУАЛЬНО
+  // различаются (правильный шейп даёт i2v из заданной картинки).
+  const frameImages = [];
+  const start = firstFrame || (Array.isArray(imageInputs) && imageInputs[0]) || null;
+  const end   = lastFrame  || (Array.isArray(imageInputs) && imageInputs[1]) || null;
+  if (start) frameImages.push({
+    type: 'image_url', image_url: { url: start }, frame_type: 'first_frame',
+  });
+  if (end) frameImages.push({
+    type: 'image_url', image_url: { url: end }, frame_type: 'last_frame',
+  });
+  if (frameImages.length) body.frame_images = frameImages;
+  // refs > 2 для OR video не поддерживаются — лишние теряем (предупреждение
+  // выше в startGeneration уже отрабатывает для multi-ref → Chatium routing,
+  // но если попали сюда — просто игнорим #3+).
+  if (Array.isArray(imageInputs) && imageInputs.length > 2) {
+    console.warn(`[providers] OR video поддерживает только first/last frame (2 refs), у тебя ${imageInputs.length} — лишние #${frameImages.length+1}+ игнорированы`);
+  }
   logCall('POST', 'OpenRouter', 'https://openrouter.ai/api/v1/videos',
-    `model=${model} dur=${duration || '-'}s asp=${aspectRatio || '-'} res=${resolution || '-'} i2v=${startImage ? 'yes' : 'no'}`);
+    `model=${model} dur=${duration || '-'}s asp=${aspectRatio || '-'} res=${resolution || '-'} i2v=${frameImages.length ? `${frameImages.length}-frame` : 'no'}`);
   // Полный body-dump в лог — для верификации какие поля принял OpenRouter
-  // (особенно `image_url` для i2v — без этого было непонятно почему ref
-  // не используется).
+  // (особенно `frame_images` для i2v — раньше bare image_url/image_input
+  // молча игнорировались, см. v0.20.27).
   const bodyForLog = { ...body };
-  if (bodyForLog.image_url) bodyForLog.image_url = String(bodyForLog.image_url).slice(0, 120) + '…';
+  if (bodyForLog.frame_images) {
+    bodyForLog.frame_images = bodyForLog.frame_images.map(fi => ({
+      ...fi, image_url: { url: String(fi.image_url?.url || '').slice(0, 120) + '…' },
+    }));
+  }
   console.log(`[providers] OpenRouter video body: ${JSON.stringify(bodyForLog)}`);
   const r = await fetch('https://openrouter.ai/api/v1/videos', {
     method: 'POST',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kingkont",
-  "version": "0.20.26",
+  "version": "0.20.28",
   "description": "KingKont \u00b7 Chatium \u2014 \u043d\u043e\u0434-\u0440\u0435\u0434\u0430\u043a\u0442\u043e\u0440 \u0441\u0446\u0435\u043d \u0441 AI-\u0433\u0435\u043d\u0435\u0440\u0430\u0446\u0438\u0435\u0439 (\u043a\u0430\u0440\u0442\u0438\u043d\u043a\u0438/\u0432\u0438\u0434\u0435\u043e/\u0433\u043e\u043b\u043e\u0441/SFX/\u043c\u0443\u0437\u044b\u043a\u0430/\u0442\u0435\u043a\u0441\u0442)",
   "main": "main.js",
   "bin": {