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",
"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",
"videoUrl": "https://example.com/video.mp4"
}'本地文件（推荐）
python3 scripts/reverse_prompt_file.py your-video.mp4 --locale zh脚本会验证文件大小和格式，进行 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 | 使用更小的文件 |