简体中文 | English

Giggle Image Generation (Multi-Model)

Source: giggle-official/skills · API: giggle.pro

Generates AI images via giggle.pro's Generation API. Supports multiple models (Seedream, Midjourney, Nano Banana). Submit task → query when ready. No polling or Cron.

API Key: Set system environment variable GIGGLE_API_KEY. The script will prompt if not configured.

No inline Python: All commands must be executed via the exec tool. Never use python3 << 'EOF' or heredoc inline code.

No Retry on Error: If script execution encounters an error, do not retry. Report the error to the user directly and stop.

Supported Models

Execution Flow: Submit and Query

Image generation is asynchronous (typically 30–120 seconds). Submit a task to get task_id, then query when the user wants to check status.

Important: Never pass GIGGLE_API_KEY in exec's env parameter. API Key is read from system environment variable.

Step 1: Submit Task

CODEBLOCK0

Response example:
CODEBLOCK1

Store task_id in memory (addMemory):
CODEBLOCK2

Tell the user: "Image generation started. It usually takes 30–120 seconds. You can ask me 'is it ready?' to check the status."

Step 2: Query Task (when user asks for status)

CODEBLOCK3

Behavior:

• - completed: Output image links for user
• failed/error: Output error message
• processing/pending: Output JSON {"status": "...", "task_id": "xxx"}; user can query again later

New Request vs Query Old Task

When the user initiates a new image generation request, run submit to create a new task. Do not reuse old task_id from memory.

When the user asks about a previous task's progress (e.g. "is it ready?", "check status"), query the task_id from memory.

Parameter Reference

Image-to-Image Reference: Three Input Methods

The image-to-image API's reference_images is an array of objects. Each element can be one of these three formats (can be mixed):

Method 1: URL

CODEBLOCK4

Method 2: Base64

CODEBLOCK5

Base64 format: Pass the raw Base64 string directly. Do not add the data:image/xxx;base64, prefix.

Method 3: asset_id

CODEBLOCK6

For multiple reference images, add more objects to the reference_images array.

Interaction Guide

When the user request is vague, guide per the steps below. If the user has provided enough info, run the command directly.

Step 1: Model Selection

CODEBLOCK7

Step 2: Aspect Ratio

CODEBLOCK8

Step 3: Generation Mode

CODEBLOCK9

Step 4: Execute and Display

Submit task → store task_id → inform user. When user asks for status, run query and forward stdout to user.

Link return rule: Image links in results must be full signed URLs (with Policy, Key-Pair-Id, Signature query params). Correct: https://assets.giggle.pro/...?Policy=...&Key-Pair-Id=...&Signature=.... Wrong: do not return unsigned URLs with only the base path (no query params).