適用於 Openclaw 的 Vidu Q4 影片生成

使用 RunAPI 從影像輸入生成 Vidu Q4 影片，然後驗證並儲存每一個請求交付物。

runapi-ai

v0.1.0

Oct 15, 2026

安裝

基本資訊

Skill.md

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。


                  npx clawhub@latest install runapi-vidu

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式

~/.openclaw/skills/

工作區

<project>/skills/

優先級：工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。


                  請幫我使用 Clawhub 安裝 runapi-vidu。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。

想要直接下載？

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 Vidu Q4 影片生成？

此 Openclaw Skills 條目引導 AI 代理透過第一格影像或參考影像（以及選用的參考音訊）生成 Vidu Q4 影片。它對單次請求使用 RunAPI CLI，並將應用程式或生產整合導向 RunAPI SDK，而不是透過 shell 呼叫 CLI。

該工作流程強調合約發現、有效請求建構、任務追蹤與交付物驗證。它透過要求代理檢查目前的操作合約並驗證下載的媒體，有助於防止猜測指令、重複付費提交以及虛假的完成宣告。

Vidu Q4 影片生成應用場景

從第一格影像生成一次性 Vidu Q4 影片。
使用參考影像以及（在發現的操作合約支援的情況下）選用的參考音訊建立影片。
使用適當的 RunAPI SDK 將 Vidu 整合到應用程式、後端、背景工作執行緒、程式庫或 webhook 管線中。
執行請求的背景任務或 webhook 工作流程，同時回報任務 ID，而不聲稱影片已完成。
驗證產生的影片檔案，並保留請求的非媒體結果，例如 JSON、文字、SRT 或 VTT。

Vidu Q4 影片生成運作原理

選擇路線：使用註冊的 vidu CLI 服務進行一次性生成，或使用 SDK 進行應用程式與生產整合。
檢查 RunAPI 身分驗證並檢查已安裝的服務與操作說明。檢索操作的 API Reference，並使用這兩個來源來建立目前的請求與回應合約。
僅使用支援的欄位建構 request.json。套用所有適用的條件規則並驗證巢狀關係；按照發現的合約指定，為本地媒體輸入使用本地檔案路徑。
驗證 JSON，透過非同步執行提交一次請求，並在等待之前儲存任務回應。
對於一次性結果，等待該相同任務並儲存其完整回應。僅當使用者明確請求背景執行、輪詢或 webhook 整合時，才在任務建立後停止。
驗證完整結果，下載每個請求的媒體交付物，並檢查每個檔案是否非空且符合其預期的 MIME 類型或系列。
如果合約、驗證、傳輸或服務失敗阻止了完成，請保留證據並遵循記錄的有限重試與停止規則。

Vidu Q4 影片生成設定指南

如果尚未安裝 RunAPI CLI，請先安裝，然後進行身分驗證。首選基於環境的身分驗證或儲存的 CLI 設定。僅當使用者明確請求時，瀏覽器登入才是互動式備選方案。

brew install runapi-ai/tap/runapi
runapi auth status > auth.json
jq -e '.authenticated == true' auth.json
runapi vidu --help
runapi vidu <operation> --help
curl --fail --location https://runapi.ai/docs/api/vidu/<operation>.md --output contract.md

僅從已安裝的服務說明中選擇 <operation>。如果身分驗證失敗，請在提交前停止並請求一個有效的 RUNAPI_API_KEY，或者使用 runapi auth import-token --token - 從 stdin 匯入使用者提供的金鑰。不要憑空發明指令或請求欄位。對於 SDK 整合，請查閱 https://github.com/runapi-ai/vidu-sdk處的目前 SDK 參考，並在編碼前確認目標語言的套件、安裝指令、方法、類型與錯誤。

Vidu Q4 影片生成資料結構與分類體系

該技能未定義固定的請求架構：已安裝的指令說明與所選操作的 API Reference 具有權威性。按如下方式建構請求與任務檔案：

檔案或資料	用途與處理
`request.json`	包含僅由發現的操作合約接受的欄位的有效 JSON。檢查條件要求、禁止的欄位、巢狀物件與陣列以及交叉參考。
`task.json`	單次非同步提交的完整回應；在等待之前將其持久化，並從 `.id` 中提取其任務 ID。
`result.json`	等待同一任務的完整回應；以請求的格式保留非媒體結果。
下載的媒體	儲存回應中找到的每個請求交付物。要求檔案非空，並根據回應元資料、所選輸出格式或明確記錄結果欄位驗證其 MIME 類型或系列。目錄備選系列是 `video/*`。

在支援時，直接在 request.json 的發現檔案輸入與頂級媒體 URL 欄位中使用本地媒體檔案路徑；CLI 會按宣告處理這些輸入。僅在需要可重複使用 URL、使用者提供 Base64 或合約明確要求單獨上傳時，才使用 runapi files create。遠端媒體格式、大小與音訊持續時間檢查由生成提供商非同步執行。