Sora 2 Generate

通过 OpenClaw 使用 NanoPhoto.AI Sora 2 API 进行文生视频和图生视频。

通过 NanoPhoto.AI Sora 2 API 生成视频。

安装：npx clawhub@latest install sora-2-generate

前置条件

在 nanophoto.ai/settings/apikeys 获取 API Key
在 OpenClaw 技能设置中配置 NANOPHOTO_API_KEY

{
  "skills": {
    "entries": {
      "sora-2-generate": {
        "enabled": true,
        "env": {
          "NANOPHOTO_API_KEY": "your_api_key_here"
        }
      }
    }
  }
}

模式

textToVideo — 通过文本提示词生成视频
imageToVideo — 通过公开图片 URL + 提示词生成视频

重要

API 仅接受公开图片 URL，不支持本地文件或 base64 图片。

参数

参数	类型	必填	描述
`prompt`	string	是	视频生成提示词
`mode`	string	是	`textToVideo` 或 `imageToVideo`
`modelTier`	string	否	`sora2`（默认）、`sora2-pro-standard`、`sora2-pro-high`
`aspectRatio`	string	否	`portrait`（默认）或 `landscape`
`videoDuration`	string	否	`10` 或 `15` 秒
`imageUrls`	string[]	条件必填	`imageToVideo` 模式时必填

使用方法

文生视频

python3 scripts/sora2_generate.py submit \
  --prompt "一只金毛犬在日落的海滩上奔跑，电影质感的光线" \
  --mode textToVideo \
  --model-tier sora2 \
  --aspect-ratio landscape \
  --video-duration 10

图生视频

python3 scripts/sora2_generate.py submit \
  --prompt "画中的人物活了过来，自然地移动着" \
  --mode imageToVideo \
  --image-url https://example.com/image.webp \
  --model-tier sora2 \
  --aspect-ratio landscape \
  --video-duration 10

提交并自动轮询

添加 --follow 参数自动轮询至完成：

python3 scripts/sora2_generate.py submit \
  --prompt "未来城市的夜景" \
  --mode textToVideo \
  --follow

查询状态

python3 scripts/sora2_generate.py status --task-id task_abc123

错误码

错误码	原因	处理方式
`LOGIN_REQUIRED`	API Key 无效	在 settings/apikeys 验证
`API_KEY_RATE_LIMIT_EXCEEDED`	超出速率限制	等待后重试
`INSUFFICIENT_CREDITS`	积分不足	充值积分
`PROMPT_REQUIRED`	缺少提示词	提供提示词
`IMAGE_REQUIRED`	图生视频缺少图片	提供公开图片 URL
`GENERATION_FAILED`	服务器错误	重试或简化提示词

参数

参数	类型	必填	描述
`prompt`	string	是	视频生成提示词
`mode`	string	是	`textToVideo` 或 `imageToVideo`
`modelTier`	string	否	`sora2`（默认）、`sora2-pro-standard`、`sora2-pro-high`
`aspectRatio`	string	否	`portrait`（默认）或 `landscape`
`videoDuration`	string	否	`10` 或 `15` 秒
`imageUrls`	string[]	条件必填	`imageToVideo` 模式时必填

使用方法

python3 scripts/sora2_generate.py submit \
  --prompt "一只金毛犬在日落的海滩上奔跑，电影质感的光线" \
  --mode textToVideo \
  --model-tier sora2 \
  --aspect-ratio landscape \
  --video-duration 10

python3 scripts/sora2_generate.py submit \
  --prompt "画中的人物活了过来，自然地移动着" \
  --mode imageToVideo \
  --image-url https://example.com/image.webp \
  --model-tier sora2 \
  --aspect-ratio landscape \
  --video-duration 10

添加 --follow 参数自动轮询至完成：

python3 scripts/sora2_generate.py submit \
  --prompt "未来城市的夜景" \
  --mode textToVideo \
  --follow

python3 scripts/sora2_generate.py status --task-id task_abc123

错误码

错误码	原因	处理方式
`LOGIN_REQUIRED`	API Key 无效	在 settings/apikeys 验证
`API_KEY_RATE_LIMIT_EXCEEDED`	超出速率限制	等待后重试
`INSUFFICIENT_CREDITS`	积分不足	充值积分
`PROMPT_REQUIRED`	缺少提示词	提供提示词
`IMAGE_REQUIRED`	图生视频缺少图片	提供公开图片 URL
`GENERATION_FAILED`	服务器错误	重试或简化提示词

前置条件

模式

参数

使用方法

文生视频

图生视频

提交并自动轮询

查询状态

错误码

目录

Sora 2 Generate

前置条件

模式

参数

使用方法

文生视频

图生视频

提交并自动轮询

查询状态

错误码

目录