{
  "schemaVersion": "1.0",
  "item": {
    "slug": "sora",
    "name": "Sora Video Generation",
    "source": "tencent",
    "type": "skill",
    "category": "内容创作",
    "sourceUrl": "https://clawhub.ai/PauldeLavallaz/sora",
    "canonicalUrl": "https://clawhub.ai/PauldeLavallaz/sora",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/sora",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sora",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/generate_video.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/sora"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/sora",
    "agentPageUrl": "https://openagent3.xyz/skills/sora/agent",
    "manifestUrl": "https://openagent3.xyz/skills/sora/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/sora/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Sora Video Generation",
        "body": "Generate videos using OpenAI's Sora API."
      },
      {
        "title": "API Reference",
        "body": "Endpoint: POST https://api.openai.com/v1/videos"
      },
      {
        "title": "Parameters",
        "body": "ParameterValuesDescriptionpromptstringText description of the video (required)input_referencefileOptional image that guides generationmodelsora-2, sora-2-proModel to use (default: sora-2)seconds4, 8, 12Video duration (default: 4)size720x1280, 1280x720, 1024x1792, 1792x1024Output resolution"
      },
      {
        "title": "Important Notes",
        "body": "Image dimensions must match video size exactly - the script auto-resizes\nVideo generation takes 1-3 minutes typically\nVideos expire after ~1 hour - download immediately"
      },
      {
        "title": "Usage",
        "body": "# Basic text-to-video\nuv run ~/.clawdbot/skills/sora/scripts/generate_video.py \\\n  --prompt \"A cat playing piano\" \\\n  --filename \"output.mp4\"\n\n# Image-to-video (auto-resizes image)\nuv run ~/.clawdbot/skills/sora/scripts/generate_video.py \\\n  --prompt \"Slow dolly shot, steam rising, warm lighting\" \\\n  --filename \"output.mp4\" \\\n  --input-image \"reference.png\" \\\n  --seconds 8 \\\n  --size 720x1280\n\n# With specific model\nuv run ~/.clawdbot/skills/sora/scripts/generate_video.py \\\n  --prompt \"Cinematic scene\" \\\n  --filename \"output.mp4\" \\\n  --model sora-2-pro \\\n  --seconds 12"
      },
      {
        "title": "Script Parameters",
        "body": "FlagDescriptionDefault--prompt, -pVideo description (required)---filename, -fOutput file path (required)---input-image, -iReference image pathNone--seconds, -sDuration: 4, 8, or 128--size, -szResolution720x1280--model, -msora-2 or sora-2-prosora-2--api-key, -kOpenAI API keyenv var--poll-intervalCheck status every N seconds10"
      },
      {
        "title": "API Key",
        "body": "Set OPENAI_API_KEY environment variable or pass --api-key."
      },
      {
        "title": "Good prompts include:",
        "body": "Camera movement: dolly, pan, zoom, tracking shot\nMotion description: swirling, rising, falling, shifting\nLighting: golden hour, candlelight, dramatic rim lighting\nAtmosphere: steam, particles, bokeh, haze\nMood/style: cinematic, commercial, lifestyle, editorial"
      },
      {
        "title": "Example prompts:",
        "body": "Food commercial:\n\nSlow dolly shot of gourmet dish, soft morning sunlight streaming through window, \nsubtle steam rising, warm cozy atmosphere, premium food commercial aesthetic\n\nLifestyle:\n\nGolden hour light slowly shifting across mountains, gentle breeze rustling leaves, \nserene morning atmosphere, premium lifestyle commercial\n\nProduct shot:\n\nCinematic close-up, dramatic lighting with warm highlights, \nslow reveal, luxury commercial style"
      },
      {
        "title": "Workflow: Image → Video",
        "body": "Generate image with Nano Banana Pro (or use existing)\nPass image as --input-image to Sora\nWrite prompt describing desired motion/atmosphere\nScript auto-resizes image to match video dimensions"
      },
      {
        "title": "Output",
        "body": "Videos saved as MP4\nTypical file size: 1.5-3MB for 8 seconds\nResolution matches --size parameter"
      }
    ],
    "body": "Sora Video Generation\n\nGenerate videos using OpenAI's Sora API.\n\nAPI Reference\n\nEndpoint: POST https://api.openai.com/v1/videos\n\nParameters\nParameter\tValues\tDescription\nprompt\tstring\tText description of the video (required)\ninput_reference\tfile\tOptional image that guides generation\nmodel\tsora-2, sora-2-pro\tModel to use (default: sora-2)\nseconds\t4, 8, 12\tVideo duration (default: 4)\nsize\t720x1280, 1280x720, 1024x1792, 1792x1024\tOutput resolution\nImportant Notes\nImage dimensions must match video size exactly - the script auto-resizes\nVideo generation takes 1-3 minutes typically\nVideos expire after ~1 hour - download immediately\nUsage\n# Basic text-to-video\nuv run ~/.clawdbot/skills/sora/scripts/generate_video.py \\\n  --prompt \"A cat playing piano\" \\\n  --filename \"output.mp4\"\n\n# Image-to-video (auto-resizes image)\nuv run ~/.clawdbot/skills/sora/scripts/generate_video.py \\\n  --prompt \"Slow dolly shot, steam rising, warm lighting\" \\\n  --filename \"output.mp4\" \\\n  --input-image \"reference.png\" \\\n  --seconds 8 \\\n  --size 720x1280\n\n# With specific model\nuv run ~/.clawdbot/skills/sora/scripts/generate_video.py \\\n  --prompt \"Cinematic scene\" \\\n  --filename \"output.mp4\" \\\n  --model sora-2-pro \\\n  --seconds 12\n\nScript Parameters\nFlag\tDescription\tDefault\n--prompt, -p\tVideo description (required)\t-\n--filename, -f\tOutput file path (required)\t-\n--input-image, -i\tReference image path\tNone\n--seconds, -s\tDuration: 4, 8, or 12\t8\n--size, -sz\tResolution\t720x1280\n--model, -m\tsora-2 or sora-2-pro\tsora-2\n--api-key, -k\tOpenAI API key\tenv var\n--poll-interval\tCheck status every N seconds\t10\nAPI Key\n\nSet OPENAI_API_KEY environment variable or pass --api-key.\n\nPrompt Engineering for Video\nGood prompts include:\nCamera movement: dolly, pan, zoom, tracking shot\nMotion description: swirling, rising, falling, shifting\nLighting: golden hour, candlelight, dramatic rim lighting\nAtmosphere: steam, particles, bokeh, haze\nMood/style: cinematic, commercial, lifestyle, editorial\nExample prompts:\n\nFood commercial:\n\nSlow dolly shot of gourmet dish, soft morning sunlight streaming through window, \nsubtle steam rising, warm cozy atmosphere, premium food commercial aesthetic\n\n\nLifestyle:\n\nGolden hour light slowly shifting across mountains, gentle breeze rustling leaves, \nserene morning atmosphere, premium lifestyle commercial\n\n\nProduct shot:\n\nCinematic close-up, dramatic lighting with warm highlights, \nslow reveal, luxury commercial style\n\nWorkflow: Image → Video\nGenerate image with Nano Banana Pro (or use existing)\nPass image as --input-image to Sora\nWrite prompt describing desired motion/atmosphere\nScript auto-resizes image to match video dimensions\nOutput\nVideos saved as MP4\nTypical file size: 1.5-3MB for 8 seconds\nResolution matches --size parameter"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/PauldeLavallaz/sora",
    "publisherUrl": "https://clawhub.ai/PauldeLavallaz/sora",
    "owner": "PauldeLavallaz",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/sora",
    "downloadUrl": "https://openagent3.xyz/downloads/sora",
    "agentUrl": "https://openagent3.xyz/skills/sora/agent",
    "manifestUrl": "https://openagent3.xyz/skills/sora/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/sora/agent.md"
  }
}