NanoPhoto.AI文檔Video Reverse Prompt
透過 OpenClaw 使用 NanoPhoto.AI API 分析影片並擷取逐鏡頭提示詞。
透過 NanoPhoto.AI API 分析影片，擷取詳細的逐鏡頭分解和 AI 可用的提示詞。
安裝：npx clawhub@latest install video-reverse-prompt
ClawHub：clawhub.ai/u/nanophotohq
前置條件
- 在 nanophoto.ai/settings/apikeys 取得 API Key
- 在 OpenClaw 技能設定中設定
NANOPHOTO_API_KEY
{
"skills": {
"entries": {
"video-reverse-prompt": {
"enabled": true,
"env": {
"NANOPHOTO_API_KEY": "your_api_key_here"
}
}
}
}
}支援的影片來源
| 來源 | 描述 |
|---|---|
youtube | YouTube 影片連結 |
url | 直接 .mp4 URL |
file | 本機 .mp4 檔案（最大 30 MB） |
參數
| 參數 | 類型 | 必填 | 描述 |
|---|---|---|---|
videoSource | string | 是 | youtube、url 或 file |
locale | string | 否 | 輸出語言（預設：en），支援全部 11 種語言 |
videoUrl | string | 條件必填 | YouTube 連結或直接 .mp4 URL |
videoFile | string | 條件必填 | Base64 編碼的影片（file 來源時） |
videoFileName | string | 否 | 原始檔案名稱 |
費用：每次 API 呼叫消耗 1 積分
使用方法
YouTube 影片
curl -X POST "https://nanophoto.ai/api/sora-2/reverse-prompt" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $NANOPHOTO_API_KEY" \
--data-raw '{
"videoSource": "youtube",
"locale": "zh-TW",
"videoUrl": "https://www.youtube.com/watch?v=XXXXXXXXXXX"
}'直接影片 URL
curl -X POST "https://nanophoto.ai/api/sora-2/reverse-prompt" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $NANOPHOTO_API_KEY" \
--data-raw '{
"videoSource": "url",
"locale": "zh-TW",
"videoUrl": "https://example.com/video.mp4"
}'本機檔案（推薦）
python3 scripts/reverse_prompt_file.py your-video.mp4 --locale zh-TW腳本會驗證檔案大小和格式，進行 Base64 編碼，並輸出串流文字回應。
回應
API 回傳串流 Markdown 回應，包含：
- 鏡頭編號、構圖/角度、鏡頭運動
- 詳細視覺描述
- 音訊分析（背景音樂、音效、旁白）
- 每個鏡頭的時長
- 整體概要
錯誤碼
| 錯誤碼 | 原因 | 處理方式 |
|---|---|---|
LOGIN_REQUIRED | API Key 無效 | 在 settings/apikeys 驗證 |
INSUFFICIENT_CREDITS | 積分不足 | 儲值積分 |
INVALID_YOUTUBE_URL | YouTube URL 無效 | 提供有效的 YouTube 連結 |
INVALID_FORMAT | 非 MP4 格式 | 僅支援 .mp4 |
FILE_TOO_LARGE | 超過 30 MB | 使用更小的檔案 |