{
  "model": "gemini-3-pro-image-preview",
  "prompt": "<USER_PROMPT>",
  "size": "<SIZE>",
  "quality": "<QUALITY>"
}

Image-to-image / editing

{
  "model": "gemini-3-pro-image-preview",
  "prompt": "<USER_PROMPT>",
  "size": "<SIZE>",
  "quality": "<QUALITY>",
  "image_urls": ["<URL1>", "<URL2>"]
}

Parameter	Values
size	auto, 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
quality	1K, 2K (default), 4K (extra cost)
image_urls	up to 10 URLs (each ≤10MB, formats: jpeg/jpg/png/webp)

Step 2 — Poll for Result

GET /tasks/{id} — poll every 10 s, up to 72 retries (~12 min).

Wait until status is completed or failed.

Step 3 — Download & Output

Download the URL from results[0]. Auto-detect format from URL (png/jpg/webp). Save as evolink-<TIMESTAMP>.<ext>.

CRITICAL SECURITY: Before passing <OUTPUT_FILE> to shell commands, sanitize it:

Strip all shell metacharacters: tr -cd 'A-Za-z0-9._-'
Ensure valid extension (.png, .jpg, .jpeg, .webp)
Fallback to evolink-<timestamp>.png if empty

Print MEDIA:<absolute_path> for OC auto-attach.

Reference Implementations

Platform	File
Python (all platforms, zero deps)	`{baseDir}/references/python.md`
PowerShell 5.1+ (Windows)	`{baseDir}/references/powershell.md`
curl + bash (Unix/macOS)	`{baseDir}/references/curl_heredoc.md`

API Key

EVOLINK_API_KEY env var (required)
Get key: https://evolink.ai

Triggers

Chinese: "高质量生图：xxx" / "编辑图片：xxx"
English: "best image: xxx" / "edit image: xxx"

Treat the text after the colon as prompt, use default size auto and quality 2K, generate immediately.

For image-to-image or editing, the user provides image URLs alongside the prompt.

Notes

Print MEDIA:<path> for OC auto-attach — no extra delivery logic needed.
Image saved locally (format auto-detected from URL: png/jpg/webp). URL expires ~24h but local file persists.
quality: 4K incurs additional charges.
image_urls accepts up to 10 URLs (each ≤10MB, formats: jpeg/jpg/png/webp).

best-image-generation

EvoLink Best Image

API Endpoint

Step 1 — Submit Task

Text-to-image