| name | evolink-image |
| description | Generate or edit images via the Evolink AI `gpt-image-2` model (async text-to-image, image-to-image, or edit-with-reference). Use whenever the user asks to generate, render, draw, or edit a bitmap image with AI. |
Evolink GPT Image 2
Async image generation via Evolink's gpt-image-2 endpoint. Supports text→image, image→image, and edit-with-reference. All work goes through the bundled script — do not hand-roll HTTP calls unless the user asks for raw API use.
When to reach for this skill
Trigger on requests to produce a bitmap image from a description: "generate", "create an image", "draw", "render", "make a picture of", "edit this photo", "change the background of this image", "turn this sketch into …". Applies equally when the user just drops a prompt ("A cinematic sunset over Shenzhen skyline") without the word "image" — the intent is clear.
Skip when the user wants vector/UI/code-driven art — frontend-design, algorithmic-art, shader-dev, or canvas-design handle those better.
Environment
The script reads EVOLINK_API_KEY from the environment. It is already configured globally; no action needed on a fresh run. If the call returns 401, tell the user their key is missing or expired rather than trying to patch it yourself.
The script
scripts/generate_image.py --prompt "..." [options]
Full flag reference (all optional except --prompt):
| Flag | Meaning |
|---|
-p, --prompt | Text prompt. Up to 32000 chars. Required. |
-i, --image | Reference image URL for img2img / edit. Repeatable (1–16 total). |
-s, --size | Ratio (1:1, 16:9, 9:16, 3:2, 21:9, …) or explicit pixels (1024x1024). Default auto. |
-r, --resolution | 1K / 2K / 4K. Only applies with ratio sizes. Default 1K. |
-q, --quality | low / medium / high. Cost scales ~0.1× / 1× / 4×. Default medium. |
-n, --n | Number of images (1–10). Default 1. Each billed independently. |
-o, --output-dir | Where to save downloaded images. Default ./evolink-out/. |
--no-download | Just print the result URLs; don't download. |
--poll-interval | Seconds between status polls. Default 3. |
--timeout | Max seconds to wait for completion. Default 600. |
--json | Emit a single JSON object with id, status, urls, paths instead of human-readable output. Useful when chaining. |
The script blocks until the task finishes (or fails / times out), downloads each result to <output-dir>/<task-id>-<index>.<ext>, and prints the saved paths. Result URLs expire in 24 h, so always download unless the user explicitly just wants the URL.
Common invocations
Plain text-to-image
uv run scripts/generate_image.py -p "A beautiful colorful sunset over the ocean"
Widescreen, high quality
uv run scripts/generate_image.py \
-p "Cinematic wide shot of a futuristic city skyline at dusk" \
-s 16:9 -r 4K -q high
Image-to-image edit
uv run scripts/generate_image.py \
-p "Add a cute cat next to her" \
-i https://example.com/input.png \
-s 1:1 -q medium
Batch of 4
uv run scripts/generate_image.py \
-p "A cute robot in pixel art style" \
-s 1:1 -r 2K -q high -n 4
Just want the URL (no download)
uv run scripts/generate_image.py -p "..." --no-download
Behaviour notes
- Async under the hood. The API returns a
task-unified-… id; the script polls /v1/tasks/{id} every few seconds until status is completed or failed. The user sees only the final result.
- Size vs resolution.
resolution (1K/2K/4K) is only a hint when size is a ratio. If the user gives explicit pixels (1024x1024), drop --resolution. Each side must be a multiple of 16; aspect ≤ 3:1; total pixels 0.65 MP – 8.29 MP.
- Cost awareness.
quality=high is roughly 4× the token cost of medium, and n=4 quadruples again. Don't bump both without a reason — default to medium + n=1 unless the user asks otherwise.
- Failures. On
status=failed the task response carries error.code / error.message; surface those verbatim. Common ones: content_policy_violation (rewrite prompt), insufficient_quota (402), rate_limit_exceeded (429, retry later).
- Reference image input. The URLs must be publicly reachable by Evolink's servers and end in an image extension, ≤ 50 MB each,
.jpg/.png/.webp. If the user gives you a local file, upload it somewhere first (or tell them you need a URL) — don't try to base64 it; the API doesn't accept that here.
Reporting back to the user
After a successful run, state the saved path(s) and, if relevant, the task id. Example: "Saved to evolink-out/task-unified-1757156493-imcg5zqt-0.png." Don't re-paste the full URL unless they asked for it — the file is what matters.
