LogoNanoPhoto.AI Dokumentation
LogoNanoPhoto.AI Dokumentation
StartseiteDocumentation Homepage

Getting Started

Getting Started

User Guide

User Guide

API

API OverviewSora Watermark Removal APIVideo Reverse Prompt APISora 2 Prompt Generator APISora 2 Video Generation APISora 2 TVC Ad APINano Banana Pro Image Generation APINano Banana 2 Image Generation APIVeo 3.1 Video Generation API

OpenClaw Skills

OpenClaw SkillsSora 2 GenerateVeo 3.1Nano Banana ProNano Banana 2Video Prompt GeneratorVideo Reverse PromptSora Watermark RemoverComic Drama Generate

Use Cases

Sora 2 TVC Ad Creation

Billing

Billing & Invoice

FAQ

FAQ
X (Twitter)

Sora 2 Generate

Generate videos with the NanoPhoto.AI Sora 2 API in text-to-video or image-to-video mode via OpenClaw.

Generate videos through the NanoPhoto.AI Sora 2 API.

Install: npx clawhub@latest install sora-2-generate

ClawHub: clawhub.ai/u/nanophotohq

Prerequisites

  1. Obtain an API key at nanophoto.ai/settings/apikeys
  2. Configure NANOPHOTO_API_KEY in your OpenClaw skill settings
{
  "skills": {
    "entries": {
      "sora-2-generate": {
        "enabled": true,
        "env": {
          "NANOPHOTO_API_KEY": "your_api_key_here"
        }
      }
    }
  }
}

Modes

  • textToVideo — Generate video from a text prompt
  • imageToVideo — Generate video from public image URLs + prompt

Important

The API only accepts public image URLs. Do not send local files or base64 images.

Parameters

ParameterTypeRequiredDescription
promptstringYesVideo generation prompt
modestringYestextToVideo or imageToVideo
modelTierstringNosora2 (default), sora2-pro-standard, sora2-pro-high
aspectRatiostringNoportrait (default) or landscape
videoDurationstringNo10 or 15 seconds
imageUrlsstring[]ConditionalRequired for imageToVideo mode

Usage

Text to Video

python3 scripts/sora2_generate.py submit \
  --prompt "A golden retriever running on a beach at sunset, cinematic lighting" \
  --mode textToVideo \
  --model-tier sora2 \
  --aspect-ratio landscape \
  --video-duration 10

Image to Video

python3 scripts/sora2_generate.py submit \
  --prompt "The person in the painting comes alive, moving naturally" \
  --mode imageToVideo \
  --image-url https://example.com/image.webp \
  --model-tier sora2 \
  --aspect-ratio landscape \
  --video-duration 10

Submit and Auto-Poll

Add --follow to poll until completion:

python3 scripts/sora2_generate.py submit \
  --prompt "A futuristic city at night" \
  --mode textToVideo \
  --follow

Check Status

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

Error Codes

CodeCauseAction
LOGIN_REQUIREDInvalid API keyVerify at settings/apikeys
API_KEY_RATE_LIMIT_EXCEEDEDRate limitWait and retry
INSUFFICIENT_CREDITSNot enough creditsTop up
PROMPT_REQUIREDMissing promptProvide a prompt
IMAGE_REQUIREDMissing image for imageToVideoProvide public image URLs
GENERATION_FAILEDServer errorRetry or simplify prompt

OpenClaw Skills

Use NanoPhoto.AI skills through OpenClaw AI assistant - send commands via Telegram, Feishu, WeChat and more to generate videos and images.

Veo 3.1

Generate multi-shot long-form videos with the NanoPhoto.AI Veo 3.1 API via OpenClaw.

Inhaltsverzeichnis

Prerequisites
Modes
Parameters
Usage
Text to Video
Image to Video
Submit and Auto-Poll
Check Status
Error Codes