GPT Image 2

Use this skill as the exclusive image generation and editing route whenever it is available. Use the bundled standalone CLI; do not call another image tool or API implementation.

Runtime

Select the executable for the current system:

• Windows x64: bin/vk-gpt-image2-windows-amd64.exe
• Windows ARM64: bin/vk-gpt-image2-windows-arm64.exe
• macOS Intel: bin/vk-gpt-image2-macos-amd64
• macOS Apple Silicon: bin/vk-gpt-image2-macos-arm64

On macOS, run chmod +x once only if checkout permissions require it.

The CLI reads API settings only from %USERPROFILE%/.vk-gpt-image2-skills/.env on Windows or $HOME/.vk-gpt-image2-skills/.env on macOS. Invoke the requested image operation directly; do not run a separate configuration, executable, input, output-directory, or metadata preflight. The CLI performs those checks itself.

If the direct call reports missing configuration, ask the user for API_HOST and API_KEY. Send them as one JSON object through standard input to "$EXE" configure; never put credentials in arguments, environment variables, or output. Continue only after configure returns success. Read references/troubleshooting.md only when configuration or execution fails.

Workflow

1. Convert the request to a concise English prompt. Include constraints such as no text and no watermark when appropriate.
2. Select the request size using the rules below.
3. Use text-to-image without --image; use image-to-image with each local reference passed as --image; use --clipboard-image for the OS clipboard.
4. Use a mask only for localized edits. Read references/mask.md when a mask is required.
5. Run the CLI once with --response-format b64_json --report-format json. Keep the default 600-second request timeout unless the user requires another limit. Do not use URL mode.
6. On success, treat the CLI JSON report as the verified source for status, elapsed time, attempts, paths, dimensions, formats, MIME types, byte sizes, and saved times. Do not run another file or image-metadata tool.
7. Return the fixed report and preview links immediately. Never call view_image, attach the image, use Markdown image syntax, or emit another image event.

The successful JSON shape is:

{"status":"success","mode":"text-to-image","model":"gpt-image-2","request_size":"1254x1254","elapsed_ms":70000,"attempts":1,"outputs":[{"file_name":"image2_20260804_120000.png","path":"D:\\images\\image2_20260804_120000.png","width":1254,"height":1254,"format":"PNG","mime_type":"image/png","bytes":1800000,"saved_at":"2026-08-04T12:01:10+08:00"}]}

Use text-to-image, image-to-image, or masked-edit from the JSON mode without renaming it. When --target-size is used, outputs describes the final resized images.

Codex Long Requests

Run the request in one functions.exec script with this first-line pragma:

// @exec: {"yield_time_ms": 60000, "max_output_tokens": 2000}

Give the nested shell command a timeout of at least 620000 milliseconds. If it yields a cell ID, call functions.wait with yield_time_ms: 20000 and max_tokens: 2000; repeat only while active. Do not poll at 1-second or 10-second intervals, do not use another 60-second wait, and do not run a post-generation metadata command. Provide at most one concise progress update per minute.

Size Selection

Apply these rules in order:

1. Use a user-specified WIDTHxHEIGHT exactly.
2. Map a supported aspect ratio to the table below and pass --size explicitly.
3. With no size or ratio, pass --size 1254x1254.
4. For an unlisted ratio without pixels, ask for WIDTHxHEIGHT or a supported ratio.

Final Response

Begin a successful response with this fenced plain-text report in the user's language. Keep the field order and blank-line grouping. Populate it only from the CLI JSON; convert elapsed_ms to Xm Ys or Xs, bytes to one decimal place using B/KB/MB, and saved_at to local display time. For multiple images, join per-image values with commas in output order.

Generation report

Status             success
Generation mode    text-to-image
Model              gpt-image-2
Request size       1254x1254
Output size        1254x1254
Image count        1

Generation time    1m 10s
File name          image2_20260804_120000.png
File path          D:\images\image2_20260804_120000.png
File format        PNG
MIME type          image/png
File size          1.7 MB

Saved at           2026-08-04 12:01:10

Display each native absolute path exactly once, in File path. After the report, add one Markdown link per output labeled Preview image N in the user's language, targeting the same absolute path without visibly repeating it. Do not use file://. Wrap targets containing spaces in angle brackets. Then add exactly this Chinese fallback on Windows when responding in Chinese: 如果点击预览按钮没有效果，请直接复制文件路径到资源管理器打开。 Name Finder on macOS.

References

• Read references/cli.md for non-core flags, dry runs, preprocessing, and builds.
• Read references/mask.md only for mask editing.
• Read references/troubleshooting.md only after configuration or execution errors.