讓本地 AI
整批開拍。

在 Claude Code 或 Codex 裡說說你想怎麼拍。助理可以透過 koma CLI 排鏡頭、選模型,再照你的清單一批送出。

v0.1.0 · Node.js 22 · .tgz 安裝包CLI 在電腦上執行。可先用手機看說明。

Vivienne 花園夜景與閃暗的庭園燈
00:24花園
屋頂上 WHITE 橫斬,刀光劃過身前
00:29橫斬
WHITE 在閱覽室,圓眼鏡占滿鏡頭
00:53反應
HEIST · EP01 成片畫格花園/屋頂/閱覽室

怎麼排、怎麼改,
直接跟 AI 說。

推薦使用 Claude Code 或 Codex。安裝並授權後,像平常改劇本一樣告訴助理想調整哪裡。它會用 CLI 操作,你不用記指令。

HEIST · EP01批次操作的口語示例
  1. 排鏡shot move
    「讓觀眾先看到屋頂,再切到閱覽室。把新順序列給我看。」

    助理能讀取既有 Shot 並調整播放順序。

  2. 開拍batch run
    「順序對了,就照這張清單拍。」

    助理用 CLI 建立批次計畫,逐鏡提交影片生成。

  3. 看進度batch status
    「這批還有哪幾鏡在跑?」

    助理可以查看這一批的進度,列出還在排隊或生成中的鏡頭。

先讓觀眾看見什麼?
調整 Shot 播放順序。

《HEIST》的屋頂動作分屬不同 Shot。想先看到落地,就請助理把 Shot 5 移到 Shot 4 前面。要改台詞,也可以只讀寫那一集。

HEIST · EP01三個原 Take,按 Shot 編號排列
  1. WHITE 與 SUSEKA 在屋頂之間跑動的原片Shot 4 / T14
  2. SUSEKA 落點動作的原片Shot 5 / T10
  3. SUSEKA 向穹頂開口躍去的原片Shot 7 / T20

第一集 · 鐘塔

外景・公共鐘塔射擊平台・夜

ZLATIA
“Fire at will.”

要改的是這句台詞,就請助理讀寫第一集。

下一版,
換個模型試試。

先查模型支援的解析度和片長。要試另一個模型,就為同一個 Shot 開新草稿,保留既有版本。

Shot 4 的原片,從 SUSEKA 肩後看到 WHITE
HEIST · 屋頂跑動Shot 4 / Take 9 原片

原版設定與另一個模型選項

T9已選用的原版
Seedance 2.5480p · 12 秒
其他可選模型
規格示例
MiniMax H3768P · 5 秒

新草稿可選不同模型與規格,送出後會有自己的生成紀錄。

這一鏡,
用她的這個表情。

團隊用 CLI 把這張表情圖加進 BIWA 的角色素材,拍閱覽室 Shot 8 的第八版時,就用它當參考。

上傳原圖
BIWA 側嘴微笑的角色表情原圖
BIWA 促狹biwa-teasing.png
HEIST · 閱覽室Shot 8 / T8
Shot 8 的 Take 8 中,BIWA 在閱覽室低頭說話

閱覽室原 Take 裡,BIWA 低頭看向 SUSEKA。

這張圖的使用紀錄CLI 上傳BIWA 角色素材Shot 8 · T8 參考圖

koma CLI 支援哪些功能?

v0.1.0
作品與劇本
建立、列出或重新命名作品。按集讀寫劇本,新增分集、修改集名與順序。creative · script
Shot 編排
調整既有鏡頭的播放順序,修改畫面描述與對白。shot
素材與設定圖
上傳、關聯或下載素材,選用角色設定圖與場景、道具主圖。asset · character · art
模型與版本
查可用模型與規格,建立版本草稿,指定模型並提交生成。models · version · video
提示詞
請求優化建議、讀取結果,將選定的文字採用到指定版本草稿。prompt
批次與任務
依清單提交、查進度、接續批次。能否取消取決於任務狀態與供應商。batch · job
成片選用與下載
選用該鏡的 Take,按收據取回指定版本,或整批下載已完成影片。take · download
帳戶與授權
首次以 Google 登入會建立帳戶。付費生成沿用工作區點數與方案權益,購點或訂閱會員請到官網結帳。 方案與點數auth

安裝與授權

在電腦上安裝,需要 Node.js 22 與 npm。

下載 CLI
  1. 安裝套件

    在安裝包所在的目錄執行。

    npm i -g ./alchemint-koma-cli-0.1.0.tgz --ignore-scripts
  2. 登入並授權

    用 Google 登入 koma.video。首次登入會建立帳戶與工作區。

    koma auth login

    比對終端機和網頁的授權碼,確認帳戶、工作區無誤才按「允許連接」。不符就拒絕。

  3. 確認工作區

    回到終端機,確認顯示的是你的帳戶與工作區。

    koma auth status

用 koma auth logout 解除這次 CLI 授權。

選好 Take,
存回電腦。

翻看《HEIST》的三個原 Take。
換成你的作品,也可以直接指定要哪一版。

下載 CLI
HEIST / 保全室TAKE 07
SIFU 低頭讀手機,BIWA 已到身後
保全室SHOT 03 / TAKE 07
鏡頭原檔HEIST / 3 個 Take