HiAPI GPT Image 2.5
This released 0.1.0 skill wraps HiAPI's unified async image API for exactly two model IDs:
gpt-image-2.5-flare— the default when no model is selected.gpt-image-2.5-sunburst— use only when the caller explicitly selects it.
Both IDs expose the same public input contract: one required prompt, optional public reference URLs, an aspect ratio or supported pixel size, quality, background, and output format. Each accepted task produces one image. Do not infer a quality, speed, or visual advantage between Flare and Sunburst from their names.
Required sequence
- Decide whether the request is text-to-image (omit
image_urls) or image-to-image/editing (send 1–16 accessible HTTP(S) URLs). A local file path is not accepted by this CLI; serve it from an accessible URL or use the direct API with an accessible URL. - Validate the prompt and options locally. Run
--dry-run --estimatebefore a paid create. The estimate reads the current/api/pricingsnapshot and creates no task. - Submit once with a stable
--idempotency-key. The CLI prints the key and task ID to stderr immediately after acceptance. If acceptance is ambiguous, reuse the same key; never blind-retry with a new key. - Use the default wait, or
--no-waitto return after submission. Use--resume-task-idto poll/download an existing task without creating another task. Use--no-savewhen you only need the output URL. - Keep the downloaded image through technical and creative checks. Treat temporary output URLs as expiring.
Read references/api.md for the field contract, references/workflow.md for delivery and QC, and references/output.md for response handling and recovery.
Safety boundary
--dry-run, --estimate, and local validation are non-billing. Creating a task may spend account balance. This package does not claim a paid generation or client runtime acceptance. Callbacks and HiAPI persistent storage are not implemented as CLI flags in this package; use the direct API snippets in the references when those features are enabled for the account.