image2-generate

name image2-generate description Generate and save images through an image2-compatible relay or middle-layer API using user-provided Base URL and API key. Use for text-to-image requests that should call a relay instead of the built-in image tool. Image2 Generate Generate images through an OpenAI-compatible image2 relay API and save the outputs as local files. Configuration Read configuration from environment variables. Never ask the user to paste an API key into chat, and never write API keys into this skill, scripts, README files, or a Git repository. IMAGE2_BASE_URL : relay base URL, such as https://apinebula.ai/v1 IMAGE2_API_KEY : bearer token for the relay IMAGE2_MODEL : image model, default gpt-image-2 IMAGE2_SIZE : image size, default 1024x1024 IMAGE2_SYNC : default 1 ; set to 0 to use the async endpoint IMAGE2_TIMEOUT : request or task timeout in seconds, default 1800 IMAGE2_POLL_INTERVAL : async polling interval in seconds, default 3 IMAGE2_USER_AGENT : optional User-Agent override If IMAGE2_BASE_URL or IMAGE2_API_KEY is missing, pause and help the user configure it locally. Ask the user to obtain the API key from their relay provider's dashboard/API Keys page and enter it through a local hidden prompt or environment variable command. For OS-specific setup commands, read references/env.md . Workflow Clarify the prompt, aspect/size, output count, and style only when they are missing. Use scripts/generate_image.py with the user's prompt. Prefer the default synchronous /images/generations endpoint because common image2 relays support it; use --async only when the relay documents async support. Save generated images locally and return absolute file paths. In Codex desktop, render the result with Markdown image syntax. Usage On Windows PowerShell: py -3 "C:\path\to\image2-generate\scripts\generate_image.py" ` --prompt "A cinematic product cover of ..." On macOS/Linux: python3 /path/to/image2-generate/scripts/generate_image.py \ --prompt "A cinematic product cover of ..." Use --size , --n , --output-dir , and --prefix when the user asks for a specific format, multiple variants, or a target folder. Notes IMAGE2_BASE_URL is only the base URL; do not append /images/generations to it. The script supports responses containing data[].b64_json , data[].url , output[].result , image , base64 , or common nested image fields. Stop after a clear 401, 403, quota, or invalid URL error and report the status plus response body without retrying endlessly.