linkfox-aigc-imagegen

Original：🇨🇳 Chinese

Translated

2 scriptsChecked / no sensitive code detected

AI Image Generation Tool that generates images based on prompts and reference images. Supports multiple models (BANANA/BANANA_2/BANANA_PRO/GPT_2_IMAGE/AIDRAW_EDIT/WAN2_7/SEEDREAM5), with controllable resolution, aspect ratio, and output quantity. Triggered when users say phrases like "generate image", "AI drawing", "AI image generation", "help me draw", "image generation", "image generation", "generate image", "draw a picture", "make a picture", "image-to-image".

2installs

Sourcelinkfox-ai/linkfox-skills

Added on2026-08-15

NPX Install

npx skill4agent add linkfox-ai/linkfox-skills linkfox-aigc-imagegen

SKILL.md Content (Chinese)

View Translation Comparison →

AI Image Generation

Generate images based on prompts and reference images, supporting multiple AI models. Create tasks asynchronously and poll for results.

Core Features

Multiple Model Options: 7 models available, each with unique strengths and resolution support.
Image-to-Image: Generate new images by passing reference images + prompts.
Batch Output: Generate up to 10 images in one go.
Asynchronous Mode: Immediately return a taskId after creating a task, and the script automatically polls until completion (timeout after 10 minutes).

Model Description

Model (provider)	Description	Features
BANANA	LFBanana (Basic Version)	Only supports 1K resolution
BANANA_2	LFBanana2	Supports higher resolution
BANANA_PRO	LFBanana Pro (Default)	Best comprehensive performance
GPT_2_IMAGE	Img2	Supports quality parameter to control output quality
AIDRAW_EDIT	Linkfox-Image-1	Suitable for editing scenarios
WAN2_7	Wan 2.7	Wanxiang Model
SEEDREAM5	Seedream 5.0	Only supports 2K

Parameter Overview

Required Fields:
```
prompt
```
,
```
imageUrls
```
,
```
outputNum
```
(default
```
1
```
),
```
resolution
```
(default
```
1K
```
),
```
quality
```
(default
```
high
```
, only for GPT_2_IMAGE)

Complete parameter table, response field structure and error codes can be found in

references/api.md

.

Calling Methods

Create Task:
```
POST /aigc/imageGenAsync
```
→ Returns
```
{taskId}
```
Poll for Results:
```
POST /aigc/taskQuery
```
→ Pass
```
{taskId}
```
→ Returns status and results
Python Script:
```
python scripts/aigc_imagegen.py '<JSON Parameters>'
```
(The script automatically handles task creation + polling internally)

Asynchronous Process:

The script calls
```
/aigc/imageGenAsync
```
to create a task and obtain
```
taskId
```
Poll
```
/aigc/taskQuery
```
, initial interval is 10 seconds, decrease by 1 second each time to a minimum of 5 seconds, maximum waiting time is 10 minutes
Automatically download images to the session
```
media/
```
directory after success

File Storage Path Convention (follows CLAUDE.md specification):

All files are stored under

<cwd>/linkfox/<YYYY-MM-DD>/<session>/

, organized by type into directories:

Content Type	Directory	Path Format	Description
Generated Images	`media/`	`<session>/media/linkfox-aigc-imagegen-<ts_ms>.<ext>`	e.g., `media/linkfox-aigc-imagegen-1718000000000.png`
Original API Response	`data/`	`<session>/data/linkfox-aigc-imagegen-<ts>.json`	Contains complete taskId, status, temporary URL, etc.

Output Strategy (Default Script Behavior):

When images are successfully generated (regardless of quantity):
- Output lines in the format
```
Saved full response: <path array>
```
  to stdout, for example:
  - 1 image:
    Saved full response: ["/path/to/media/a.png"]
  - Multiple images:
    Saved full response: ["/path/to/media/a.png", "/path/to/media/b.png"]
- The original API response (including temporary URL, etc.) is silently saved to the
```
data/
```
  directory.
- The front-end UI can parse all
```
Saved full response:
```
  lines in stdout and render the subsequent JSON array.
- Usually outputs one line per script call; multiple lines will be generated for multiple calls.
When no image output is produced (failure/no results):
- Output the original response path to stdout:
```
Saved full response: /path/to/data/xxx.json
```

Data Reading Recommendation: Prohibited to read the content of transferred image files (to avoid base64 entering the context). Directly provide the local path after

Saved full response:

to users.

Resolve Authentication and Point Issues

When the following exceptions occur, guide users to solve them using references/onboarding.md:

Exception Scenarios

API Key Not Configured: Neither
```
LINKFOX_AGENT_API_KEY
```
nor
```
LINKFOXAGENT_API_KEY
```
is configured in environment variables.
Response returns 401 or 402 status code
Response indicates insufficient points or balance: Messages contain phrases like "insufficient points balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/need to recharge/please recharge" or similar meanings.

Usage Guide

Model Selection: Use
```
BANANA_PRO
```
(default) for general scenarios; use
```
GPT_2_IMAGE
```
for high-quality image control; use
```
AIDRAW_EDIT
```
for editing existing images.
Prompts: The more specific the description, the better the effect. It is recommended to use English prompts for better results.
Reference Images: At least one reference image URL must be provided.
Resolution: Supports 1K/2K/4K, default is 1K.

Examples

1. Generate Product Scene Image with Default Model

json

{"imageUrls": ["https://example.com/product.jpg"], "prompt": "product photography on white background, studio lighting", "provider": "BANANA_PRO", "outputNum": 1, "resolution": "1K", "aspectRatio": "1:1", "quality": "high"}

2. Generate High-Quality Image with GPT_2_IMAGE

json

{"imageUrls": ["https://example.com/ref.jpg"], "prompt": "modern minimalist product showcase", "provider": "GPT_2_IMAGE", "outputNum": 1, "resolution": "1K", "aspectRatio": "16:9", "quality": "high"}

3. Batch Generate Multiple Images

json

{"imageUrls": ["https://example.com/ref.jpg"], "prompt": "creative product ad design", "provider": "BANANA_PRO", "outputNum": 4, "resolution": "2K", "aspectRatio": "1:1", "quality": "high"}

Limitations

At least one reference image URL must be provided.
Maximum 10 images can be generated per request.
Generation time varies by model and resolution, usually 10-120 seconds. The script automatically polls, with a timeout of 10 minutes.
No retries on failure (only one attempt).

Not Applicable Scenarios

Not applicable for:

Pure text generation →
```
linkfox-aigc-textgen
```
Video generation →
```
linkfox-aigc-videogen
```

Feedback

Refer to

references/api.md

.

Execution Instructions

Important: After receiving the

ARGUMENTS:

field at the end of this document, you must immediately execute

python scripts/aigc_imagegen.py '<JSON>'

, do not wait for user confirmation or additional input.

linkfox-aigc-imagegen

NPX Install

Tags

SKILL.md Content (Chinese)

AI Image Generation

Core Features

Model Description

Parameter Overview

Calling Methods

Resolve Authentication and Point Issues

Exception Scenarios

Usage Guide

Examples

Limitations

Not Applicable Scenarios

Feedback

Execution Instructions