NanoPhoto.AI文檔Sora 2 Generate
透過 OpenClaw 使用 NanoPhoto.AI Sora 2 API 進行文字生成影片和圖片生成影片。
透過 NanoPhoto.AI Sora 2 API 生成影片。
安裝：npx clawhub@latest install sora-2-generate
ClawHub：clawhub.ai/u/nanophotohq
前置條件
- 在 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 | 伺服器錯誤 | 重試或簡化提示詞 |