EvoLink Best Image
Generate and edit images via the EvoLink Nano Banana Pro (gemini-3-pro-image-preview) API.
API Endpoint
- Base:
https://api.evolink.ai/v1 - Submit:
POST /images/generations - Poll:
GET /tasks/{id}
Step 1 — Submit Task
Text-to-image
{
"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>.pngif 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_KEYenv 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: 4Kincurs additional charges.image_urlsaccepts up to 10 URLs (each ≤10MB, formats: jpeg/jpg/png/webp).