简体中文 | English

Giggle Video Generation

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

Generates AI videos via giggle.pro's Generation API. Supports text-to-video and image-to-video. Submit task → query when ready. No polling, no Cron, no file writes—all operations via exec.

---

Installation Requirements

Requirement	Value
Binary	INLINECODE0
Environment

GIGGLE_API_KEY (required; obtain from https://giggle.pro/) |
| Pip | requests |

Set GIGGLE_API_KEY before use. The script will prompt if not configured.

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

---

Supported Models

Model	Supported Durations (s)	Default	Description
grok	6, 10	6	Strong overall capability, recommended
grok-fast

6, 10 | 6 | grok fast version | | sora2 | 4, 8, 12 | 4 | OpenAI Sora 2 | | sora2-pro | 4, 8, 12 | 4 | Sora 2 Pro | | sora2-fast | 10, 15 | 10 | Sora 2 Fast | | sora2-pro-fast | 10, 15 | 10 | Sora 2 Pro Fast | | kling25 | 5, 10 | 5 | Kling video model | | seedance15-pro | 4, 8, 12 | 4 | Seedance Pro (with audio) | | seedance15-pro-no-audio | 4, 8, 12 | 4 | Seedance Pro (no audio) | | veo31 | 4, 6, 8 | 4 | Google Veo 3.1 (with audio) | | veo31-no-audio | 4, 6, 8 | 4 | Google Veo 3.1 (no audio) | | minimax23 | 6 | 6 | MiniMax model | | wan25 | 5, 10 | 0 | Wanxiang model |

Note: --duration must be chosen from the model's supported durations, otherwise the API will error.

---

Frame Reference (Image-to-Video)

For image-to-video, --start-frame and --end-frame support three mutually exclusive formats:

Method	Format	Example
asset_id	INLINECODE7	INLINECODE8
url

url:<URL> | url:https://example.com/img.jpg |
| base64 | base64:<DATA> | base64:iVBORw0KGgo... |

Each frame parameter can only use one of these methods.

---

Execution Flow: Submit and Query

Video generation is asynchronous (typically 60–300 seconds). Submit a task to get task_id, then query when the user wants to check status. All commands run via exec; API key from system env.

---

Step 1: Submit Task

First send a message to the user: "Video generation submitted. Usually takes 1–5 minutes. You can ask me about the progress anytime."

CODEBLOCK0

Response example:
CODEBLOCK1

Store task_id in memory (addMemory):

giggle-generation-video task_id: xxx (submitted: YYYY-MM-DD HH:mm)

---

Step 2: Query When User Asks

When the user asks about video progress (e.g. "is my video ready?", "progress?"), run:

CODEBLOCK3

Output handling:

stdout pattern	Action
Plain text with video links (视频已就绪)	Forward to user as-is
Plain text with error

Forward to user as-is |
| JSON {"status": "processing", "task_id": "..."} | Tell user "Still in progress, please ask again in a moment" |

Link return rule: Video links in results must be full signed URLs (with Policy, Key-Pair-Id, Signature query params). Keep as-is when forwarding.

---

New Request vs Query Old Task

When the user initiates a new video generation request, must run Step 1 to submit a new task. Do not reuse old task_id from memory.

Only when the user explicitly asks about a previous task's progress should you query the old task_id from memory.

---

Parameter Reference

Parameter	Default	Description
INLINECODE17	required	Video description prompt
INLINECODE18

grok | See "Supported Models" table |
| --duration | model default | Must choose from model's supported durations |
| --aspect-ratio | 16:9 | 16:9, 9:16, 1:1, 3:4, 4:3 |
| --resolution | 720p | 480p, 720p, 1080p |
| --start-frame | - | Image-to-video start frame: asset_id:ID, url:URL, or base64:DATA |
| --end-frame | - | Image-to-video end frame, same format as start |

Note: base64 parameter supports base64-encoded images. Pass the raw Base64 string directly, do not add the data:image/xxx;base64, prefix.

---

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 (required)

Before generating, must introduce available models and let the user choose. Display the model list from "Supported Models" table. Wait for explicit user choice before continuing.

Step 2: Video Duration

For the chosen model, show supported duration options. Default to the model's default duration.

Step 3: Generation Mode

CODEBLOCK4

Step 4: Aspect Ratio

CODEBLOCK5

Step 5: Execute and Display

Follow the flow: send message → Step 1 submit → user asks → Step 2 query. Forward exec stdout to the user as-is.