{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openai-image-cli",
    "name": "OpenAI Image CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/G9Pedro/openai-image-cli",
    "canonicalUrl": "https://clawhub.ai/G9Pedro/openai-image-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/openai-image-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openai-image-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "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. 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/openai-image-cli"
    },
    "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/openai-image-cli",
    "agentPageUrl": "https://openagent3.xyz/skills/openai-image-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openai-image-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openai-image-cli/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": "OpenAI Image CLI",
        "body": "Generate, edit, and create variations of images using OpenAI's latest models."
      },
      {
        "title": "Installation",
        "body": "npm install -g @versatly/openai-image-cli"
      },
      {
        "title": "Authentication",
        "body": "# Via environment variable\nexport OPENAI_API_KEY=sk-...\n\n# Or via config\nopenai-image config set api-key sk-..."
      },
      {
        "title": "Quick Start",
        "body": "# Generate an image\nopenai-image generate \"A futuristic city at sunset\"\n\n# High quality landscape\nopenai-image generate \"Mountain panorama\" -s 1536x1024 -q high\n\n# Multiple images with transparency\nopenai-image generate \"Logo design\" -n 4 -b transparent\n\n# Edit an existing image\nopenai-image edit photo.png \"Add sunglasses to the person\"\n\n# Create variations (DALL-E 2)\nopenai-image vary original.png -n 3"
      },
      {
        "title": "Available Models",
        "body": "ModelDescriptionNotesgpt-image-1.5Latest GPT Image (default)Best quality, recommendedgpt-image-1GPT ImageGood balancegpt-image-1-miniGPT Image MiniCost-effectivedall-e-3DALL-E 3Deprecated May 2026dall-e-2DALL-E 2Deprecated May 2026, supports variations"
      },
      {
        "title": "generate",
        "body": "Create images from text prompts.\n\nopenai-image generate \"prompt\" [options]\n\nOptions:\n  -m, --model <model>        Model (default: gpt-image-1.5)\n  -s, --size <size>          Size: 1024x1024, 1536x1024, 1024x1536, auto\n  -q, --quality <quality>    Quality: auto, high, medium, low\n  -n, --count <n>            Number of images (1-10)\n  -f, --format <format>      Format: png, jpeg, webp\n  -o, --output <path>        Output file/directory\n  -b, --background <bg>      Background: auto, transparent, opaque\n  --compression <0-100>      Compression level for jpeg/webp\n  --moderation <level>       Content moderation: auto, low\n  --stream                   Enable streaming with partial images\n  --partial-images <0-3>     Partial images during streaming\n  --json                     Output JSON response\n  --dry-run                  Show request without executing"
      },
      {
        "title": "edit",
        "body": "Edit existing images with prompts.\n\nopenai-image edit <image> \"instructions\" [options]\n\nOptions:\n  --mask <path>              Mask image for inpainting\n  --images <paths...>        Additional reference images (up to 16)\n  -s, --size <size>          Output size\n  -q, --quality <quality>    Quality level\n  -n, --count <n>            Number of variations\n  -f, --format <format>      Output format\n  -o, --output <path>        Output path\n\nExamples:\n\n# Simple edit\nopenai-image edit photo.png \"Add sunglasses\"\n\n# Inpainting with mask\nopenai-image edit room.png \"Add a plant\" --mask mask.png\n\n# Multi-image composite\nopenai-image edit base.png \"Create gift basket\" --images item1.png item2.png"
      },
      {
        "title": "vary",
        "body": "Create variations of an image (DALL-E 2 only).\n\nopenai-image vary <image> [options]\n\nOptions:\n  -n, --count <n>            Number of variations (1-10)\n  -s, --size <size>          Size: 256x256, 512x512, 1024x1024\n  -o, --output <path>        Output path/directory"
      },
      {
        "title": "batch",
        "body": "Generate multiple images from a file or stdin.\n\nopenai-image batch [options]\n\nOptions:\n  -i, --input <file>         Input file (text or JSONL)\n  --stdin                    Read from stdin\n  -m, --model <model>        Model for all generations\n  -o, --output-dir <dir>     Output directory\n  --parallel <n>             Concurrent requests (default: 3)\n  --delay <ms>               Delay between requests (default: 100)\n\nJSONL format:\n\n{\"prompt\": \"A red car\", \"size\": \"1024x1024\", \"quality\": \"high\"}\n{\"prompt\": \"A blue boat\", \"size\": \"1536x1024\"}"
      },
      {
        "title": "config",
        "body": "Manage CLI configuration.\n\nopenai-image config set <key> <value>\nopenai-image config get <key>\nopenai-image config list\nopenai-image config reset\nopenai-image config path\n\nKeys: api-key, default-model, default-size, default-quality, default-format, output-dir"
      },
      {
        "title": "models",
        "body": "List available models.\n\nopenai-image models [--json]"
      },
      {
        "title": "history",
        "body": "View local generation history.\n\nopenai-image history [-n <limit>] [--json] [--clear]"
      },
      {
        "title": "Default (human-readable)",
        "body": "✓ Generated image saved to ./generated-1707500000.png\n  Model: gpt-image-1.5\n  Size: 1024x1024\n  Quality: high\n  Tokens: 150 (text: 10, image: 140)"
      },
      {
        "title": "JSON (--json)",
        "body": "{\n  \"success\": true,\n  \"file\": \"./generated-1707500000.png\",\n  \"model\": \"gpt-image-1.5\",\n  \"size\": \"1024x1024\",\n  \"quality\": \"high\",\n  \"usage\": {\n    \"total_tokens\": 150,\n    \"input_tokens\": 50,\n    \"output_tokens\": 100\n  }\n}"
      },
      {
        "title": "Size Options",
        "body": "ModelSizesGPT Image1024x1024, 1536x1024 (landscape), 1024x1536 (portrait), autoDALL-E 31024x1024, 1792x1024, 1024x1792DALL-E 2256x256, 512x512, 1024x1024"
      },
      {
        "title": "Tips",
        "body": "Transparent backgrounds: Use -b transparent -f png for logos\nBatch processing: Use JSONL for per-image options\nCost control: Use gpt-image-1-mini for drafts\nHistory tracking: Enabled by default, view with openai-image history"
      },
      {
        "title": "Links",
        "body": "npm: https://www.npmjs.com/package/@versatly/openai-image-cli\nGitHub: https://github.com/Versatly/openai-image-cli"
      }
    ],
    "body": "OpenAI Image CLI\n\nGenerate, edit, and create variations of images using OpenAI's latest models.\n\nInstallation\nnpm install -g @versatly/openai-image-cli\n\nAuthentication\n# Via environment variable\nexport OPENAI_API_KEY=sk-...\n\n# Or via config\nopenai-image config set api-key sk-...\n\nQuick Start\n# Generate an image\nopenai-image generate \"A futuristic city at sunset\"\n\n# High quality landscape\nopenai-image generate \"Mountain panorama\" -s 1536x1024 -q high\n\n# Multiple images with transparency\nopenai-image generate \"Logo design\" -n 4 -b transparent\n\n# Edit an existing image\nopenai-image edit photo.png \"Add sunglasses to the person\"\n\n# Create variations (DALL-E 2)\nopenai-image vary original.png -n 3\n\nAvailable Models\nModel\tDescription\tNotes\ngpt-image-1.5\tLatest GPT Image (default)\tBest quality, recommended\ngpt-image-1\tGPT Image\tGood balance\ngpt-image-1-mini\tGPT Image Mini\tCost-effective\ndall-e-3\tDALL-E 3\tDeprecated May 2026\ndall-e-2\tDALL-E 2\tDeprecated May 2026, supports variations\nCommands\ngenerate\n\nCreate images from text prompts.\n\nopenai-image generate \"prompt\" [options]\n\nOptions:\n  -m, --model <model>        Model (default: gpt-image-1.5)\n  -s, --size <size>          Size: 1024x1024, 1536x1024, 1024x1536, auto\n  -q, --quality <quality>    Quality: auto, high, medium, low\n  -n, --count <n>            Number of images (1-10)\n  -f, --format <format>      Format: png, jpeg, webp\n  -o, --output <path>        Output file/directory\n  -b, --background <bg>      Background: auto, transparent, opaque\n  --compression <0-100>      Compression level for jpeg/webp\n  --moderation <level>       Content moderation: auto, low\n  --stream                   Enable streaming with partial images\n  --partial-images <0-3>     Partial images during streaming\n  --json                     Output JSON response\n  --dry-run                  Show request without executing\n\nedit\n\nEdit existing images with prompts.\n\nopenai-image edit <image> \"instructions\" [options]\n\nOptions:\n  --mask <path>              Mask image for inpainting\n  --images <paths...>        Additional reference images (up to 16)\n  -s, --size <size>          Output size\n  -q, --quality <quality>    Quality level\n  -n, --count <n>            Number of variations\n  -f, --format <format>      Output format\n  -o, --output <path>        Output path\n\n\nExamples:\n\n# Simple edit\nopenai-image edit photo.png \"Add sunglasses\"\n\n# Inpainting with mask\nopenai-image edit room.png \"Add a plant\" --mask mask.png\n\n# Multi-image composite\nopenai-image edit base.png \"Create gift basket\" --images item1.png item2.png\n\nvary\n\nCreate variations of an image (DALL-E 2 only).\n\nopenai-image vary <image> [options]\n\nOptions:\n  -n, --count <n>            Number of variations (1-10)\n  -s, --size <size>          Size: 256x256, 512x512, 1024x1024\n  -o, --output <path>        Output path/directory\n\nbatch\n\nGenerate multiple images from a file or stdin.\n\nopenai-image batch [options]\n\nOptions:\n  -i, --input <file>         Input file (text or JSONL)\n  --stdin                    Read from stdin\n  -m, --model <model>        Model for all generations\n  -o, --output-dir <dir>     Output directory\n  --parallel <n>             Concurrent requests (default: 3)\n  --delay <ms>               Delay between requests (default: 100)\n\n\nJSONL format:\n\n{\"prompt\": \"A red car\", \"size\": \"1024x1024\", \"quality\": \"high\"}\n{\"prompt\": \"A blue boat\", \"size\": \"1536x1024\"}\n\nconfig\n\nManage CLI configuration.\n\nopenai-image config set <key> <value>\nopenai-image config get <key>\nopenai-image config list\nopenai-image config reset\nopenai-image config path\n\n\nKeys: api-key, default-model, default-size, default-quality, default-format, output-dir\n\nmodels\n\nList available models.\n\nopenai-image models [--json]\n\nhistory\n\nView local generation history.\n\nopenai-image history [-n <limit>] [--json] [--clear]\n\nOutput Formats\nDefault (human-readable)\n✓ Generated image saved to ./generated-1707500000.png\n  Model: gpt-image-1.5\n  Size: 1024x1024\n  Quality: high\n  Tokens: 150 (text: 10, image: 140)\n\nJSON (--json)\n{\n  \"success\": true,\n  \"file\": \"./generated-1707500000.png\",\n  \"model\": \"gpt-image-1.5\",\n  \"size\": \"1024x1024\",\n  \"quality\": \"high\",\n  \"usage\": {\n    \"total_tokens\": 150,\n    \"input_tokens\": 50,\n    \"output_tokens\": 100\n  }\n}\n\nSize Options\nModel\tSizes\nGPT Image\t1024x1024, 1536x1024 (landscape), 1024x1536 (portrait), auto\nDALL-E 3\t1024x1024, 1792x1024, 1024x1792\nDALL-E 2\t256x256, 512x512, 1024x1024\nTips\nTransparent backgrounds: Use -b transparent -f png for logos\nBatch processing: Use JSONL for per-image options\nCost control: Use gpt-image-1-mini for drafts\nHistory tracking: Enabled by default, view with openai-image history\nLinks\nnpm: https://www.npmjs.com/package/@versatly/openai-image-cli\nGitHub: https://github.com/Versatly/openai-image-cli"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/G9Pedro/openai-image-cli",
    "publisherUrl": "https://clawhub.ai/G9Pedro/openai-image-cli",
    "owner": "G9Pedro",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openai-image-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/openai-image-cli",
    "agentUrl": "https://openagent3.xyz/skills/openai-image-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openai-image-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openai-image-cli/agent.md"
  }
}