{
  "schemaVersion": "1.0",
  "item": {
    "slug": "grok-imagine-video",
    "name": "Grok Imagine Video Generation",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/DevvGwardo/grok-imagine-video",
    "canonicalUrl": "https://clawhub.ai/DevvGwardo/grok-imagine-video",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/grok-imagine-video",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=grok-imagine-video",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "README.md",
      "references/api_reference.md",
      "scripts/grok_video_api.py",
      "SKILL.md"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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/grok-imagine-video"
    },
    "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/grok-imagine-video",
    "agentPageUrl": "https://openagent3.xyz/skills/grok-imagine-video/agent",
    "manifestUrl": "https://openagent3.xyz/skills/grok-imagine-video/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/grok-imagine-video/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Grok Imagine Video",
        "body": "Generate videos using xAI's Grok Imagine API directly from your messaging interface."
      },
      {
        "title": "Setup",
        "body": "Important: You need your own xAI API key. Get it from https://console.x.ai/\n\nFor full installation instructions, see README.md\n\nQuick setup:\n\n# Set your xAI API key (YOUR key, not pre-configured)\nexport XAI_API_KEY=\"your-api-key-here\""
      },
      {
        "title": "Capabilities",
        "body": "Text-to-image: Generate images from text descriptions (up to 10 variations)\nImage editing: Modify images using natural language\nText-to-video: Create videos from text descriptions\nImage-to-video: Animate static images into motion\nVideo editing: Modify videos using natural language\nAsync generation: Handles long-running video jobs with polling\nAuto-delivery: Downloads and delivers images/videos via chat"
      },
      {
        "title": "1. Image Generation",
        "body": "User says: \"Create an image of a cyberpunk cityscape at night\"\n\npython3 - << 'EOF'\nimport os\nimport sys\nsys.path.insert(0, 'scripts')\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(os.getenv(\"XAI_API_KEY\"))\nresult = client.generate_image(\"A cyberpunk cityscape at night, neon lights reflecting on wet streets\")\nprint(f\"Image URL: {result}\")\nEOF\n\nImages are generated instantly (no polling needed). Download promptly as URLs are temporary."
      },
      {
        "title": "1b. Image Editing",
        "body": "User says: \"Edit this image — make it look like a watercolor\"\n\npython3 - << 'EOF'\nimport os\nimport sys\nsys.path.insert(0, 'scripts')\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(os.getenv(\"XAI_API_KEY\"))\nresult = client.edit_image(\n    image_url=\"https://example.com/photo.jpg\",\n    prompt=\"Make it look like a watercolor painting\"\n)\nprint(f\"Edited image: {result}\")\nEOF"
      },
      {
        "title": "2. Text-to-Video",
        "body": "User says: \"Generate a video of a sunset over the ocean\"\n\n# Use the Python client\npython3 - << 'EOF'\nimport os\nimport sys\nsys.path.insert(0, 'scripts')\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(os.getenv(\"XAI_API_KEY\"))\nresult = client.text_to_video(\"A beautiful sunset over the ocean\", duration=10)\nprint(f\"Job started: {result['job_id']}\")\nEOF"
      },
      {
        "title": "3. Wait for Video Completion",
        "body": "Video generation takes 1-3 minutes. Poll with progress:\n\npython3 - << 'EOF'\nimport os\nimport sys\nsys.path.insert(0, 'scripts')\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(os.getenv(\"XAI_API_KEY\"))\n\ndef progress(response):\n    print(f\"Polling... {'Done!' if 'video' in response else 'Pending'}\")\n\nfinal = client.wait_for_completion(\"request-id-here\", progress_callback=progress)\nprint(f\"Video ready: {final['video']['url']}\")\nEOF"
      },
      {
        "title": "4. Download and Deliver",
        "body": "Download the completed video to the workspace:\n\npython3 - << 'EOF'\nimport os\nimport sys\nsys.path.insert(0, 'scripts')\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(os.getenv(\"XAI_API_KEY\"))\noutput = \"/data/workspace/videos/sunset.mp4\"\nclient.download_video(final, output)  # pass the full response dict\nprint(f\"Downloaded: {output}\")\nEOF"
      },
      {
        "title": "Image-to-Video",
        "body": "Animate an image:\n\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(api_key)\nresult = client.image_to_video(\n    image_url=\"https://example.com/photo.jpg\",\n    prompt=\"Make the clouds move slowly\",\n    duration=10\n)"
      },
      {
        "title": "Video Editing",
        "body": "Edit an existing video:\n\nresult = client.edit_video(\n    video_url=\"https://example.com/source.mp4\",\n    edit_prompt=\"Add a warm sunset filter and slow down to 50% speed\"\n)"
      },
      {
        "title": "Configuration",
        "body": "Important: Get your own API key from https://console.x.ai/ - do NOT use pre-configured keys.\n\nexport XAI_API_KEY=\"sk-...\"\n\nFor OpenClaw integration, add to workspace .env or manage via gateway config.\n\nSee README.md for complete setup instructions."
      },
      {
        "title": "Error Handling",
        "body": "Common errors and responses:\n\nUnauthorized / API key not set: → Get your key from https://console.x.ai/ and set export XAI_API_KEY=\"your-key\" - See README.md for details\nRate limit: \"Too many requests\" → Wait and retry\nContent policy: \"Prompt violates content policies\" → Rephrase prompt\nTimeout: Job took too long → Reduce duration or complexity\n\nAlways wrap API calls in try/except and provide user-friendly messages."
      },
      {
        "title": "Best Practices",
        "body": "Prompt engineering (images):\n\nBe descriptive: \"A collage of London landmarks in a stenciled street-art style\"\nSpecify style: \"Watercolor painting of a mountain lake at dawn\"\nUse multiple variations (n=4) to explore interpretations\n\nPrompt engineering (videos):\n\nBe specific: \"A golden retriever running through a sunny meadow\"\nInclude camera movement: \"Slow pan from left to right\"\nSpecify lighting: \"Warm golden hour lighting\"\n\nPerformance:\n\nImages generate instantly — no polling needed\nUse 480p for faster video generation, 720p for higher quality\nKeep videos under 10 seconds unless essential\nStart with text-to-video, then edit if needed\n\nUser experience:\n\nImages: deliver immediately after generation\nVideos: send progress updates: \"Generating video... 45% complete\"\nEstimate time for videos: \"This takes about 2-3 minutes\"\nConfirm delivery: \"Here's your image/video!\""
      },
      {
        "title": "Limits",
        "body": "Images per request: 1-10\nVideo duration: 1-15 seconds\nVideo resolution: 480p (default) or 720p\nRate limit: 60 requests/minute\nMax concurrent jobs: 15\n\nSee references/api_reference.md for full API documentation."
      },
      {
        "title": "Integration with Other Skills",
        "body": "Combine with ffmpeg-video-editor for post-processing (trimming, concatenation, filters)\nUse fal-ai for additional video effects\nIntegrate with image-generation skills for source images"
      },
      {
        "title": "Troubleshooting",
        "body": "Job stuck in \"pending\": Check API key and quota\n\nVideo generation slow: Try 720p instead of 1080p\n\nFailed jobs: Check error_code in response; see API reference\n\nDownload errors: Verify video_url is accessible and has not expired"
      }
    ],
    "body": "Grok Imagine Video\n\nGenerate videos using xAI's Grok Imagine API directly from your messaging interface.\n\nSetup\n\nImportant: You need your own xAI API key. Get it from https://console.x.ai/\n\nFor full installation instructions, see README.md\n\nQuick setup:\n\n# Set your xAI API key (YOUR key, not pre-configured)\nexport XAI_API_KEY=\"your-api-key-here\"\n\nCapabilities\nText-to-image: Generate images from text descriptions (up to 10 variations)\nImage editing: Modify images using natural language\nText-to-video: Create videos from text descriptions\nImage-to-video: Animate static images into motion\nVideo editing: Modify videos using natural language\nAsync generation: Handles long-running video jobs with polling\nAuto-delivery: Downloads and delivers images/videos via chat\nWorkflow\n1. Image Generation\n\nUser says: \"Create an image of a cyberpunk cityscape at night\"\n\npython3 - << 'EOF'\nimport os\nimport sys\nsys.path.insert(0, 'scripts')\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(os.getenv(\"XAI_API_KEY\"))\nresult = client.generate_image(\"A cyberpunk cityscape at night, neon lights reflecting on wet streets\")\nprint(f\"Image URL: {result}\")\nEOF\n\n\nImages are generated instantly (no polling needed). Download promptly as URLs are temporary.\n\n1b. Image Editing\n\nUser says: \"Edit this image — make it look like a watercolor\"\n\npython3 - << 'EOF'\nimport os\nimport sys\nsys.path.insert(0, 'scripts')\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(os.getenv(\"XAI_API_KEY\"))\nresult = client.edit_image(\n    image_url=\"https://example.com/photo.jpg\",\n    prompt=\"Make it look like a watercolor painting\"\n)\nprint(f\"Edited image: {result}\")\nEOF\n\n2. Text-to-Video\n\nUser says: \"Generate a video of a sunset over the ocean\"\n\n# Use the Python client\npython3 - << 'EOF'\nimport os\nimport sys\nsys.path.insert(0, 'scripts')\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(os.getenv(\"XAI_API_KEY\"))\nresult = client.text_to_video(\"A beautiful sunset over the ocean\", duration=10)\nprint(f\"Job started: {result['job_id']}\")\nEOF\n\n3. Wait for Video Completion\n\nVideo generation takes 1-3 minutes. Poll with progress:\n\npython3 - << 'EOF'\nimport os\nimport sys\nsys.path.insert(0, 'scripts')\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(os.getenv(\"XAI_API_KEY\"))\n\ndef progress(response):\n    print(f\"Polling... {'Done!' if 'video' in response else 'Pending'}\")\n\nfinal = client.wait_for_completion(\"request-id-here\", progress_callback=progress)\nprint(f\"Video ready: {final['video']['url']}\")\nEOF\n\n4. Download and Deliver\n\nDownload the completed video to the workspace:\n\npython3 - << 'EOF'\nimport os\nimport sys\nsys.path.insert(0, 'scripts')\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(os.getenv(\"XAI_API_KEY\"))\noutput = \"/data/workspace/videos/sunset.mp4\"\nclient.download_video(final, output)  # pass the full response dict\nprint(f\"Downloaded: {output}\")\nEOF\n\nImage-to-Video\n\nAnimate an image:\n\nfrom grok_video_api import GrokImagineVideoClient\n\nclient = GrokImagineVideoClient(api_key)\nresult = client.image_to_video(\n    image_url=\"https://example.com/photo.jpg\",\n    prompt=\"Make the clouds move slowly\",\n    duration=10\n)\n\nVideo Editing\n\nEdit an existing video:\n\nresult = client.edit_video(\n    video_url=\"https://example.com/source.mp4\",\n    edit_prompt=\"Add a warm sunset filter and slow down to 50% speed\"\n)\n\nConfiguration\n\nImportant: Get your own API key from https://console.x.ai/ - do NOT use pre-configured keys.\n\nexport XAI_API_KEY=\"sk-...\"\n\n\nFor OpenClaw integration, add to workspace .env or manage via gateway config.\n\nSee README.md for complete setup instructions.\n\nError Handling\n\nCommon errors and responses:\n\nUnauthorized / API key not set: → Get your key from https://console.x.ai/ and set export XAI_API_KEY=\"your-key\" - See README.md for details\nRate limit: \"Too many requests\" → Wait and retry\nContent policy: \"Prompt violates content policies\" → Rephrase prompt\nTimeout: Job took too long → Reduce duration or complexity\n\nAlways wrap API calls in try/except and provide user-friendly messages.\n\nBest Practices\n\nPrompt engineering (images):\n\nBe descriptive: \"A collage of London landmarks in a stenciled street-art style\"\nSpecify style: \"Watercolor painting of a mountain lake at dawn\"\nUse multiple variations (n=4) to explore interpretations\n\nPrompt engineering (videos):\n\nBe specific: \"A golden retriever running through a sunny meadow\"\nInclude camera movement: \"Slow pan from left to right\"\nSpecify lighting: \"Warm golden hour lighting\"\n\nPerformance:\n\nImages generate instantly — no polling needed\nUse 480p for faster video generation, 720p for higher quality\nKeep videos under 10 seconds unless essential\nStart with text-to-video, then edit if needed\n\nUser experience:\n\nImages: deliver immediately after generation\nVideos: send progress updates: \"Generating video... 45% complete\"\nEstimate time for videos: \"This takes about 2-3 minutes\"\nConfirm delivery: \"Here's your image/video!\"\nLimits\nImages per request: 1-10\nVideo duration: 1-15 seconds\nVideo resolution: 480p (default) or 720p\nRate limit: 60 requests/minute\nMax concurrent jobs: 15\n\nSee references/api_reference.md for full API documentation.\n\nIntegration with Other Skills\nCombine with ffmpeg-video-editor for post-processing (trimming, concatenation, filters)\nUse fal-ai for additional video effects\nIntegrate with image-generation skills for source images\nTroubleshooting\n\nJob stuck in \"pending\": Check API key and quota\n\nVideo generation slow: Try 720p instead of 1080p\n\nFailed jobs: Check error_code in response; see API reference\n\nDownload errors: Verify video_url is accessible and has not expired"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/DevvGwardo/grok-imagine-video",
    "publisherUrl": "https://clawhub.ai/DevvGwardo/grok-imagine-video",
    "owner": "DevvGwardo",
    "version": "1.0.4",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/grok-imagine-video",
    "downloadUrl": "https://openagent3.xyz/downloads/grok-imagine-video",
    "agentUrl": "https://openagent3.xyz/skills/grok-imagine-video/agent",
    "manifestUrl": "https://openagent3.xyz/skills/grok-imagine-video/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/grok-imagine-video/agent.md"
  }
}