微縮模型製作與立體場景影片生成
深夜:一個火柴盒大小的日本便利商店散發著琥珀色光芒;鏡頭緩緩脫離黑暗,朝它推進——散景吞噬了整個世界,而玻璃門、貨架和微小的螢光燈卻保持清晰。這種「小而真實」的沉浸感,正是這個技能所要捕捉的情感核心。
便利商店、雨中的拉麵攤、賽博龐克工作室——或是一張成品的照片:一行文字或一張圖片 → 一支影片。
依賴項目: WERYAI_API_KEY + Node.js 18+。執行 CLI 時,scripts/video_gen.js 必須存在;[WERYAI_VIDEO_API.md](resources/WERYAI_VIDEO_API.md) 必須存在於 resources/ 目錄下(需透過發布或使用前組裝提供)。完整指令與 JSON 欄位請參閱 resources/WERYAI_VIDEO_API.md。無需其他 Cursor 技能。預設參數與模型層級如下方表格所示;實際 API 限制則遵循 weryai 模型規定。在安裝或執行之前,請先檢閱隨附的 video_gen.js,確認其符合您的需求。尤其要注意它如何處理本機檔案(若您選擇允許使用),以確保此行為符合技能在圖生影片請求上的預期工作流程。
註冊資訊清單中繼資料: 唯一必要的運行時秘密是 WERYAI_API_KEY。它會出現在 YAML 前端置入區中,作為頂層的 requires.env(流程映射,適用於僅扁平化根層級鍵的工具)、metadata.openclaw.primaryEnv 以及 metadata.openclaw.requires.env。技能目錄與註冊表應事先醒目提示此需求,以便安裝者在下載前知曉。切勿將此金鑰提交至套件內。
在安裝或設定 WERYAI_API_KEY 之前
- 信任: 確認您信任 WeryAI,並接受提示詞與圖片輸入(網址以及,若使用,上傳的字節資料)會透過網路發送至 WeryAI 的伺服器。
- 敏感內容: 請勿將機密放在
prompt中。請勿提供您認為敏感的圖片網址或本機檔案,除非您接受供應商端的處理。 - 先做
--dry-run: 先執行node scripts/video_gen.js wait --json '…' --dry-run(以及/或使用--dry-run的submit-*指令)再設定金鑰,以檢查 JSON 結構;僅使用--dry-run時不一定要有WERYAI_API_KEY(詳見[WERYAI_VIDEO_API.md](resources/WERYAI_VIDEO_API.md))。 - 來源: 若您無法驗證套件作者,或需要嚴格的資料控管,請不要設定
WERYAI_API_KEY,或者僅在隔離/測試環境中執行。
環境變數(隨附的 video_gen.js)
- 實際 API 呼叫的必要條件: 僅
WERYAI_API_KEY(用於模型、生成、status、本機圖片上傳)。僅使用--dry-run時為非必要。 - 此腳本不讀取: 環境變數不會覆寫 API 主機名稱;
https://api.weryai.com與https://api-growth-agent.weryai.com在程式碼中是固定的(請參閱安全章節)。請勿依賴 URL 覆寫設定——此版本中並無此功能。 - 輪詢:
wait使用腳本中固定的指數退避與逾時常數(詳見[WERYAI_VIDEO_API.md](resources/WERYAI_VIDEO_API.md)),此套件中沒有獨立用於輪詢的環境變數。
腳本預設值 vs. 技能預設值(必須與 JSON 一致)
model: CLI 沒有內建的預設模型。如果 JSON 中的model遺失或為空,video_gen.js會回傳MISSING_PARAM(no default model)。此技能建議的表格預設值為KLING_V3_0_PRO——請務必在wait/submit-*的 JSON 中明確傳遞"model":"<確認的模型金鑰>",使其與提交前的表格一致。resolution: 對於KLING_V3_0_PRO(此技能的預設層級),請從 JSON 中完全省略resolution——發送此欄位可能會導致不支援該欄位的模型出現1002/ 參數錯誤。僅在所選模型於node scripts/video_gen.js models清單中列出,且您的確認表格明確包含此欄位時,才添加resolution。
先決條件
- 在執行
video_gen.js之前,必須在環境中設定WERYAI_API_KEY。 - 需要 Node.js 18+。偏好使用公開的
https圖片網址。如果組裝好的scripts/video_gen.js支援本機檔案路徑,請先審查並驗證腳本,然後在它讀取本機圖片並上傳至 WeryAI 以獲取公開網址前,取得明確同意。 - 每次成功的
wait執行都會消耗 WeryAI 點數;重新執行會建立新的付費任務。
安全性、秘密與 API 主機
WERYAI_API_KEY:視為機密。僅在您信任此技能的來源時才進行設定;它已在 OpenClaw 中繼資料中列為requires.env/primaryEnv,以便安裝者知道它在運行時是強制性的(切勿將它提交至技能套件內)。- API 主機(在
video_gen.js中固定):影片任務使用https://api.weryai.com;模型清單使用https://api-growth-agent.weryai.com。隨附的腳本在程式碼中固定了這些基礎網址——僅從環境中讀取WERYAI_API_KEY進行驗證。請勿依賴任何環境變數來更改 API 主機名稱;請求僅會發送到這些官方端點,以及在上傳本機圖片時的指定上傳網址(詳見[WERYAI_VIDEO_API.md](resources/WERYAI_VIDEO_API.md))。 - 本機圖片處理揭露:偏好使用公開的
https圖片網址。如果組裝好的scripts/video_gen.js支援本機檔案路徑,它可能會讀取本機圖片並上傳至 WeryAI 以獲取公開網址;使用該路徑前,需要審查/驗證並取得明確同意。 - 遠端處理: 付費執行會將
prompt與圖片輸入發送至 WeryAI;請參閱## 在安裝或設定 WERYAI_API_KEY 之前。 - 更高的保障: 遵循
## 在安裝或設定 WERYAI_API_KEY 之前;為付費執行使用短期或隔離環境;在投入生產前審查scripts/video_gen.js(HTTPS 提交 + 輪詢迴圈)。驗證運行時是否可以讀取本機圖片檔案並上傳至 WeryAI,並在使用該路徑前取得明確同意。
提示詞擴展(強制性)
video_gen.js 不會擴展提示詞。在每次 wait --json 之前,將使用者簡短或模糊的描述,轉換為完整的英文製作提示詞。
時機: 使用者僅提供關鍵字、一句話或鬆散的意圖——或要求更豐富的影片語言時。例外: 他們貼上一個在模型 prompt_length_limit 範圍內的完整長提示詞,並要求您不要改寫;此時仍應在確認表格中顯示完整文字。
始終添加(影片語言): 鏡頭景別與角度;攝影機運動或鎖定;光線品質與動機;主體動作的節奏需與 duration 配合;為此場景提供一個明確的亮點;當此技能預設為垂直時,需標明 9:16 垂直。
長度: 遵循此文件中為所選 model_key 列出的 prompt_length_limit;在刪除核心動作、鏡頭或光線條件之前,先修剪填充用的形容詞。
確認: 提交前的表格必須包含完整的擴展後 prompt(絕不能只有一行摘要)。等待使用者確認或提出修改。
微縮場景檢查清單
- 微縮世界: 淺景深、實用暖光、推軌/推進揭示;立體模型或盒子中的房間。
- 節奏: 製作 → 上色 → 燈光亮起或車輛經過;舒適的氛圍、有觸感的材質。
- 比例暗示: 必要時使用火柴、硬幣或指尖作為參考。
### 範例提示詞 在此檔案頂部僅為簡短觸發詞——務必根據使用者的實際請求進行擴展。
工作流程
- 確認使用者請求符合此技能的使用場景(如文件所述,支援文生影片和/或圖生影片)。
- 收集使用者的簡要描述、可選的圖片網址、層級(最佳 / 良好 / 快速)或明確的
model金鑰。 - 擴展提示詞(強制): 除非使用者提供了完整的長提示詞並明確要求不要改寫,否則請使用下方的
## 提示詞擴展(強制性)將簡要描述擴展為完整的英文製作提示詞。請勿僅使用使用者的最少字詞來呼叫 API。 - 將擴展後的
prompt與此文件中凍結表格內所選模型的prompt_length_limit進行比對(如果有);必要時縮短。 - 根據此文件與
[WERYAI_VIDEO_API.md](resources/WERYAI_VIDEO_API.md)中的凍結表格,驗證duration、aspect_ratio、generate_audio、negative_prompt及其他欄位。僅在所選model支援時才包含resolution(對於此技能的預設 KLING 層級,請勿發送resolution——請參閱## 腳本預設值 vs. 技能預設值)。 - 顯示包含完整擴展後
prompt的提交前參數表格;等待確認或編輯。 - 確認後,使用擴展後的提示詞執行
node scripts/video_gen.js wait --json '...'。 - 解析標準輸出的 JSON 並回傳影片網址;若失敗,則顯示
errorCode/errorMessage並建議參數修正。
CLI 參考
node scripts/video_gen.js wait --json '{"model":"…","prompt":"…","duration":5,"aspect_ratio":"9:16"}'
node scripts/video_gen.js wait --json '…' --dry-run
node scripts/video_gen.js status --task-id <id>
完整參考: [WERYAI_VIDEO_API.md](resources/WERYAI_VIDEO_API.md)。
完成定義
當使用者從 API 回應中收到至少一個可播放的影片網址,或收到帶有後續步驟的明確失敗說明時,即為完成。所有使用的參數必須落在此文件中該所選模型的允許集合內。提交的 prompt 必須是擴展後的製作提示詞,除非使用者明確提供了完整的長提示詞並要求不要改寫。
邊界(不在範圍內)
- 不審查平台合規性、版權或肖像權;不保證輸出內容的商業可用性。
- 不提供非 WeryAI 的離線渲染、傳統編輯時間軸,或此 SKILL 及
[WERYAI_VIDEO_API.md](resources/WERYAI_VIDEO_API.md)中未記載的 API 欄位組合。 - 請勿連結到
weryai-model-capabilities.md或共享的../references/路徑;請對 CLI/API 詳情使用resources/WERYAI_VIDEO_API.md。 - 請勿在技能文件中硬編碼絕對路徑;請從技能套件根目錄(包含
SKILL.md的目錄)執行node scripts/...,以便scripts/和resources/路徑能正確解析。
範例提示詞
手工建造的微縮咖啡館:最後一幕內部燈光亮起,溫暖的補光,緩慢的垂直推進使用這張街景立體模型照片:小車經過,商店櫥窗亮起塗裝完成的模型底座,旋轉展示,極淺景深微縮模型製作揭示 9:16,舒適的暖燈在小房子內部亮起
預設參數
| 欄位 | 值 |
|---|---|
| 模型 | KLING_V3_0_PRO(必須以 "model" 出現在 JSON 中——腳本不會設定預設值) |
| 長寬比 | 9:16(固定垂直) |
| 時長 | 短(duration: 5);需要更長的製作過程時使用 10 |
| 解析度 | 省略(KLING 預設不傳送,請勿在 JSON 中包含此鍵) |
| 風格 | 極淺景深、可信賴的材質、主角道具上的重點光、緩慢推進或輕微環繞(固定) |
| 音訊 | 開啟(環境音加上微小道具細節以增加沉浸感) |
API 有效性(預設
KLING_V3_0_PRO): 文生影片的duration僅支援 5 / 10 / 15;aspect_ratio僅支援 9:16, 1:1, 16:9。圖生影片的aspect_ratio僅支援 9:16, 16:9, 1:1。沒有resolution欄位——請勿發送它。 對於使用 VEO 的快速層級:文生影片使用VEO_3_1_FAST,圖生影片使用CHATBOT_VEO_3_1_FAST,duration固定為 8,aspect_ratio僅支援 9:16 或 16:9。當切換model_key時,請遵循本節模型/API 限制以及上方 API 有效性註記中的允許集合;請勿將resolution發送給不支援它的模型。
場景描述 → 微縮世界
目的: 具體的場景創意、快速的視覺測試或批次化情緒變體——無需實體模型。
輸入:
場景類型(便利商店 / 廚房 / 小屋 / 街角攤位 / 工作室 / 賽博龐克場景)與情緒(溫暖治癒 / 霓虹賽博 / 日光 / 雨中琥珀)。若情緒被省略,請選擇該場景通常表現較佳的燈光。可選項:強調建造過程 vs 成品巡禮。
提取關鍵道具與燈光,選擇一個能引發「我想要這個」感覺的角度,構建提示詞,顯示完整參數,等待確認,然後執行 node scripts/video_gen.js wait --json '…'。
生成前會顯示完整參數;等待確認。
參數設定:
| 欄位 | 值 |
|---|---|
| model | KLING_V3_0_PRO |
| aspect_ratio | 9:16 |
| duration | 5 |
| generate_audio | true |
| resolution | (省略——此模型不發送此欄位) |
輸入範例:
「夜晚的日本便利商店,溫暖治癒」→ 技能會建構:
極特寫微距鏡頭,平視角度,一個手掌大小的微縮日本便利商店立體模型置於暗色表面上,溫暖的琥珀色內部燈光透過微小的玻璃拉門和結霜窗戶滲出,照亮了細節完美的內部——微型貨架上擺滿了拇指大小的產品包裝、一個迷你收銀機、一個柔光箱天花板面板。攝影機以 30fps 非常緩慢地向入口推軌,彷彿正走向它,淺景深僅讓店面保持極度清晰,而周圍的黑暗則融化消失。寒冷的藍色夜晚環境光充滿了外部,在門檻處形成了冷暖色調的分裂。ASMR 柔和的環境嗡嗡聲、遙遠的城市夜晚聲音、微弱的店內背景音樂。
「賽博龐克工作室,霓虹」→
中近景,45度俯瞰角度,一個鞋子大小的微縮賽博龐克工作室立體模型——塞滿了微小的發光顯示器、佈滿電線的桌子、粉紅色和青色的霓虹燈書架、一個在鍵盤前的微縮人偶。攝影機以 60fps 緩慢地環繞場景進行單一平滑旋轉,霓虹光從每一個微小的反光表面折射——螢幕邊框、咖啡杯、拋光地板磚。來自霓虹燈管的體積光線在場景上方形成了柔和的光暈。
…
[因翻譯而截斷]