Video Prompt Generator

Generate professional Sora 2 video prompts with the NanoPhoto.AI Prompt Generator API. Use when: (1) User wants a polished video prompt from a topic or scene...

Security Scan

The skill's requirements and bundled script align with its stated purpose (generating Sora 2 prompts via NanoPhoto.AI) and request only the expected API key; nothing in the files indicates unrelated access or suspicious behavior.

Purpose & Capability

Name/description, documented API endpoint (https://nanophoto.ai/api/sora-2/generate-prompt), required env var (NANOPHOTO_API_KEY), and the bundled script all match the declared purpose of generating video prompts. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

Runtime instructions stay within scope: collect topic/mode/parameters and call the NanoPhoto API or bundled script. The script explicitly reads the OpenClaw skill env fallback at ~/.openclaw/openclaw.json if an API key is not provided via CLI or environment; this behavior is documented in SKILL.md. This is reasonable for resolving the declared credential but is worth noting because it reads a file in the user's home directory.

Install Mechanism

No install spec or external downloads are present; the skill is instruction-only with a small, included Python script. No archive/extract or remote executable fetches are used.

Credentials

Only one credential is required (NANOPHOTO_API_KEY), which is the expected API key for the described service. The script resolves the key via CLI argument, environment, or documented OpenClaw config fallback and does not request other secrets.

Persistence & Privilege

The skill is not marked always:true and does not attempt to modify other skills or global agent settings. It only reads its own documented fallback config path for credential resolution.

Assessment

This skill appears coherent and only needs your NanoPhoto API key. Before installing: (1) store NANOPHOTO_API_KEY in the platform's secure env setting or pass it at runtime; do not paste the key into chat; (2) avoid sending private or sensitive images—image-to-video mode sends public image URLs to nanophoto.ai; (3) be aware the bundled script will read ~/.openclaw/openclaw.json as a documented fallback for the key, so ensure that file doesn't contain other secrets you don't want accessed; (4) confirm you accept NanoPhoto's data/usage and billing policy (generations cost credits). If you want extra caution, inspect the included Python script locally before use (it's short and readable) and restrict the platform-level env access to only this skill.

Generate polished Sora 2 video prompts through the NanoPhoto.AI Prompt Generator API.

Prerequisites

1. Obtain an API key at: https://nanophoto.ai/settings/apikeys
2. Configure NANOPHOTO_API_KEY before using the skill.
3. Do not paste the API key into chat; store it in the platform's secure env setting for this skill.

Preferred OpenClaw setup:

• Open the skill settings for this skill
• Add an environment variable named NANOPHOTO_API_KEY
• Paste the API key as its value

Equivalent config shape:

{
  "skills": {
    "entries": {
      "video-prompt-generator": {
        "enabled": true,
        "env": {
          "NANOPHOTO_API_KEY": "your_api_key_here"
        }
      }
    }
  }
}

Other valid ways to provide the key:

• Shell: export NANOPHOTO_API_KEY="your_api_key_here"
• Tool-specific env config: any runtime that injects NANOPHOTO_API_KEY
• OpenClaw config fallback: the bundled script also falls back to ~/.openclaw/openclaw.json at skills.entries.video-prompt-generator.env.NANOPHOTO_API_KEY

Credential declaration summary:

• Primary credential: NANOPHOTO_API_KEY
• Resolution order in the bundled script: --api-key → NANOPHOTO_API_KEY environment variable → ~/.openclaw/openclaw.json skill env
• No unrelated credentials are required

Recommended workflow

1. Collect the user's topic or scene idea.
2. Decide whether the prompt is for textToVideo or imageToVideo.
3. Choose a technique, duration, locale, and optional model override.
4. For image-to-video mode, require one to three public image URLs.
5. Run the bundled script or call the API directly.
6. Return the generated prompt text exactly as produced unless the user asks for adaptation or rewriting.

Parameter guidance

• topic
  • Required
  • Maximum 500 characters
  • Keep it specific enough to imply subject, mood, or motion
• mode
  • textToVideo: default
  • imageToVideo: requires public imageUrls
• technique
  • Default: montage
  • Choose the technique that best matches the intended visual language
• duration
  • 10
  • 15
• locale
  • Default: en
  • Supported: en, zh, zh-TW, ja, ko, es, fr, de, pt, ru, ar

Preferred command

Use the bundled script for reliable prompt generation:

Text-to-video prompt

python3 scripts/video_prompt_generator.py \
  --topic "A serene Japanese garden with cherry blossoms falling into a koi pond" \
  --mode textToVideo \
  --technique slow-motion \
  --duration 15 \
  --locale en

Image-to-video prompt

python3 scripts/video_prompt_generator.py \
  --topic "Animate this landscape with gentle wind and floating clouds" \
  --mode imageToVideo \
  --technique long-take \
  --duration 10 \
  --locale en \
  --image-url https://example.com/landscape.jpg

The script resolves credentials in this order: --api-key, then NANOPHOTO_API_KEY from the environment, then ~/.openclaw/openclaw.json at skills.entries.video-prompt-generator.env.NANOPHOTO_API_KEY.

Output behavior

• The API returns streaming text, but the bundled script prints the final assembled prompt text
• Return the prompt directly when the user asked for prompt generation
• If the user wants editing or localization after generation, transform the generated prompt in a second step instead of changing API parameters retroactively

Manual API call

curl -X POST "https://nanophoto.ai/api/sora-2/generate-prompt" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $NANOPHOTO_API_KEY" \
  --data-raw '{
    "topic": "A futuristic cityscape at sunset with flying vehicles and neon lights",
    "technique": "aerial-view",
    "duration": 15,
    "locale": "en"
  }'

Error handling

errorCode	Cause	Action
LOGIN_REQUIRED	Invalid or missing API key	Verify key at https://nanophoto.ai/settings/apikeys
API_KEY_RATE_LIMIT_EXCEEDED	Rate limit exceeded	Wait and retry
INSUFFICIENT_CREDITS	Not enough credits	Top up credits
INVALID_INPUT	Missing or invalid topic	Ask for a valid topic under 500 characters

Bundled files

• scripts/video_prompt_generator.py: generate a prompt from a topic using the NanoPhoto Prompt Generator API
• references/api.md: condensed API reference, inputs, and error behavior