rexai-image-generation

name: rexai-image-generation description: Use when the user wants to generate an image, edit an image, create visual artwork, produce text-to-image output, transform an existing image with image-to-image, or asks for 生图, 生成图片, 文生图, 图生图, text-to-image, image-to-image, AI image, picture generation, image result, image edit, or visual generation.

installCatalogName: rexai-image-generation clients: [codex, claude, gemini, opencode] scopes: [global, project] defaultInstall: global: false project: false tags: [image, generation, rexai] repoTargets: [codex, claude, gemini, antigravity, opencode, crush]

RexAI Image Generation

Use RexAI's async image API to create images and return usable local files.

Quick Workflow

1. Use REXAI_API_KEY for authentication. If it is missing, teach the user how to configure it for their platform before running the job.
2. Choose the product ID:
   • Text-to-image: gpt-image-2.
   • Image-to-image: gpt-image-2-i2i.
3. Pick the zero-install executor for the user's platform:
   • Windows/Codex: use scripts/rexai-image.ps1; it only needs built-in PowerShell/.NET.
   • macOS/Linux: use scripts/rexai-image-macos.sh; it uses common system tools (bash, curl, perl, base64).
4. Use scripts/rexai-image.mjs only when Node is already available.
5. Report the local file path, job id, source URL if present, and expiry time if present.

Read references/api.md when you need endpoint details, supported sizes, error codes, or examples.

API Key Setup

First check whether the key is already available. Do not print the key value:

if ($env:REXAI_API_KEY) { "REXAI_API_KEY is set" } else { "REXAI_API_KEY is missing" }

If it is missing, tell the user to choose one setup path:

Windows PowerShell, current session only:

$env:REXAI_API_KEY = "cr_xxx"

Windows PowerShell, persistent for new terminals:

setx REXAI_API_KEY "cr_xxx"

macOS/Linux, current shell only:

export REXAI_API_KEY="cr_xxx"

macOS zsh, persistent for new terminals:

printf '%s\n' 'export REXAI_API_KEY="cr_xxx"' >> ~/.zshrc

Linux bash persistent setup for new terminals:

printf '%s\n' 'export REXAI_API_KEY="cr_xxx"' >> ~/.bashrc

Security rules: never commit .env files or API keys, never echo the real key back to the user, and only save persistent configuration when the user explicitly chooses that option.

Text-To-Image

Windows/Codex:

$env:REXAI_API_KEY = "cr_xxx"
powershell -NoProfile -ExecutionPolicy Bypass -File skill-sources/rexai-image-generation/scripts/rexai-image.ps1 `
  -Model gpt-image-2 `
  -Prompt "A cozy orange cat sleeping in warm sunlight" `
  -Size 1024x1024 `
  -OutputDir generated/rexai

macOS/Linux:

export REXAI_API_KEY="cr_xxx"
bash skill-sources/rexai-image-generation/scripts/rexai-image-macos.sh \
  --model gpt-image-2 \
  --prompt "A cozy orange cat sleeping in warm sunlight" \
  --size 1024x1024 \
  --output-dir generated/rexai

Image-To-Image

Pass at least one reference image as a local file path, image URL, or data:image/... URL. Local files are converted to data URLs by the script.

Windows/Codex:

$env:REXAI_API_KEY = "cr_xxx"
powershell -NoProfile -ExecutionPolicy Bypass -File skill-sources/rexai-image-generation/scripts/rexai-image.ps1 `
  -Model gpt-image-2-i2i `
  -Prompt "Convert this image to watercolor style" `
  -Image path/to/source.png `
  -OutputDir generated/rexai

macOS/Linux:

export REXAI_API_KEY="cr_xxx"
bash skill-sources/rexai-image-generation/scripts/rexai-image-macos.sh \
  --model gpt-image-2-i2i \
  --prompt "Convert this image to watercolor style" \
  --image path/to/source.png \
  --output-dir generated/rexai

Optional Node Fallback

If Node is already installed, this equivalent script is available:

node skill-sources/rexai-image-generation/scripts/rexai-image.mjs \
  --model gpt-image-2 \
  --prompt "A cozy orange cat sleeping in warm sunlight" \
  --size 1024x1024 \
  --output-dir generated/rexai

Operational Rules

• Prefer REXAI_API_KEY over -ApiKey or --api-key so secrets do not enter shell history.
• If REXAI_API_KEY is missing, show the relevant setup commands from "API Key Setup" and ask the user to configure the key before retrying.
• Do not install Node just for this skill; use PowerShell on Windows and the shell script on macOS/Linux.
• Use an output directory inside the current workspace unless the user requests another path.
• For image-to-image, do not invent a source image; ask for an image path/URL when none is available.
• If a job times out, report the job id and last known status so the user can retry polling.
• If RexAI returns model_not_found, invalid_model, or invalid_parameter, refresh https://tool.rexai.top/api/api-docs and update the product ID or parameter names.

Script Output

The scripts print JSON:

{
  "id": "job-id",
  "status": "succeeded",
  "product_id": "gpt-image-2",
  "output_dir": "generated/rexai",
  "results": [
    {
      "file": "generated/rexai/rexai-1.png",
      "url": "https://cdn.example.com/images/result.png",
      "expires_at": "2026-06-29T01:00:00.000Z"
    }
  ]
}