anygen-image

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

AnyGen Image Generator

AnyGen 图片生成器

You MUST strictly follow every instruction in this document. Do not skip, reorder, or improvise any step.

Generate Design images, illustrations and visual content using AnyGen OpenAPI. Output: online task URL for viewing and downloading generated images.

必须严格遵循本文档中的每一条指令，不得跳过、重排或擅自修改任何步骤。

使用AnyGen OpenAPI生成设计图、插图及视觉内容。输出结果：用于查看和下载生成图片的在线任务URL。

When to Use

使用场景

User needs to generate images, illustrations, or visual assets
User wants to create posters, banners, social media graphics, or marketing creatives
User has reference images to upload for style guidance

用户需要生成图片、插图或视觉资产
用户想要创建海报、横幅、社交媒体配图或营销创意素材
用户有参考图片可上传以提供风格指导

Security & Permissions

安全与权限

What this skill does:

Sends task prompts and parameters to
```
www.anygen.io
```
Uploads user-provided reference files to
```
www.anygen.io
```
after obtaining consent
Spawns a background process (up to 25 min) to monitor progress
Reads/writes API key config at
```
~/.config/anygen/config.json
```

What this skill does NOT do:

Upload files without informing the user and obtaining consent
Send your API key to any endpoint other than
```
www.anygen.io
```
Modify system configuration beyond
```
~/.config/anygen/config.json
```

Bundled scripts:

scripts/anygen.py

(Python — uses

requests

). Review before first use.

此Skill的功能：

将任务提示词和参数发送至
```
www.anygen.io
```
在获得用户同意后，将用户提供的参考文件上传至
```
www.anygen.io
```
启动后台进程（最长25分钟）以监控任务进度
读取/写入API密钥配置文件
```
~/.config/anygen/config.json
```

此Skill不具备的功能：

未告知用户并获得同意的情况下上传文件
将您的API密钥发送至
```
www.anygen.io
```
以外的任何端点
修改
```
~/.config/anygen/config.json
```
以外的系统配置

捆绑脚本：

scripts/anygen.py

（Python编写，依赖

requests

库）。首次使用前请查看脚本内容。

Prerequisites

前置条件

Python3 and
```
requests
```
:
```
pip3 install requests
```
AnyGen API Key (
```
sk-xxx
```
) — Get one

Configure once:

python3 scripts/anygen.py config set api_key "sk-xxx"

All
scripts/
paths below are relative to this skill's installation directory.

Python3和
```
requests
```
库：
```
pip3 install requests
```
AnyGen API密钥（格式为
```
sk-xxx
```
）——获取地址

首次配置：

python3 scripts/anygen.py config set api_key "sk-xxx"

以下所有
scripts/
路径均相对于此Skill的安装目录。

CRITICAL: NEVER Block the Conversation

重要提示：切勿阻塞对话

After creating a task, you MUST start background monitoring via

sessions_spawn

, then continue normally. NEVER call

poll

in the foreground — it blocks for up to 20 minutes.

```
create
```
→ get
```
task_id
```
and
```
task_url
```
.
Tell user: (a) generation started, (b) the online link, (c) ~5–10 min, free to do other things.
Launch background monitor via
```
sessions_spawn
```
(Phase 4). Do NOT announce this to the user.
Continue the conversation — do NOT wait.
The background monitor handles notifying the user directly, then replies
```
ANNOUNCE_SKIP
```
so the main session does NOT relay anything further.

创建任务后，必须通过

sessions_spawn

启动后台监控，然后正常继续对话。绝对不能在前台调用
poll
命令——它会阻塞最长20分钟。

执行
```
create
```
命令 → 获取
```
task_id
```
和
```
task_url
```
告知用户：(a) 图片生成已启动，(b) 在线查看链接，(c) 预计耗时5-10分钟，可先进行其他操作
通过
```
sessions_spawn
```
启动后台监控（第4阶段）。无需告知用户此操作
继续对话——请勿等待监控结果
后台监控会直接通知用户，最后回复
```
ANNOUNCE_SKIP
```
，表示主会话无需再转发任何消息

Communication Style

沟通风格

NEVER expose internal implementation details to the user. Forbidden terms:

Technical identifiers:

task_id

file_token

conversation.json

task_xxx

tk_xxx

API/system terms:
```
API
```
,
```
OpenAPI
```
,
```
prepare
```
,
```
create
```
,
```
poll
```
,
```
status
```
,
```
query
```

Infrastructure terms:

sub-agent

subagent

background process

spawn

sessions_spawn

Script/code references:
```
anygen.py
```
,
```
scripts/
```
, command-line syntax, JSON output

Use natural language instead:

"Your file has been uploaded" (NOT "file_token=tk_xxx received")
"I'm generating your image now" (NOT "Task task_xxx created")
"You can view the result here: [URL]" (NOT "Task URL: ...")
"I'll let you know when it's ready" (NOT "Spawning a sub-agent to poll")

Additional rules:

You may mention AnyGen as the service when relevant.
Summarize
```
prepare
```
responses naturally — do not echo verbatim.
Stick to the questions
```
prepare
```
returned — do not add unrelated ones.
Ask questions in your own voice, as if they are your own questions. Do NOT use a relaying tone like "AnyGen wants to know…" or "The system is asking…".

绝对不能向用户暴露内部实现细节，禁止使用以下术语：

技术标识符：

task_id

、

file_token

、

conversation.json

、

task_xxx

、

tk_xxx

API/系统术语：
```
API
```
、
```
OpenAPI
```
、
```
prepare
```
、
```
create
```
、
```
poll
```
、
```
status
```
、
```
query
```

基础设施术语：

sub-agent

、

subagent

、

background process

、

spawn

、

sessions_spawn

脚本/代码相关：
```
anygen.py
```
、
```
scripts/
```
、命令行语法、JSON输出

请使用自然语言替代：

“您的文件已上传”（而非“已收到file_token=tk_xxx”）
“我正在为您生成图片”（而非“已创建任务task_xxx”）
“您可以在此查看结果：[URL]”（而非“任务URL：...”）
“完成后我会通知您”（而非“正在启动sub-agent进行轮询”）

额外规则：

相关场景下可提及AnyGen服务
用自然语言总结
```
prepare
```
命令的返回结果，不要直接照搬原文
仅围绕
```
prepare
```
返回的问题进行沟通，不要添加无关问题
用自己的语气提问，就像问题是你自己提出的一样。禁止使用“AnyGen想知道...”或“系统正在询问...”这类转述语气

Image Generation Workflow (MUST Follow All 4 Phases)

图片生成工作流（必须遵循全部4个阶段）

Phase 1: Understand Requirements

阶段1：明确需求

If the user provides reference files, handle them before calling

prepare

Describe the reference image yourself if provided.
Reuse existing
file_token
if the same file was already uploaded in this conversation.
Get consent before uploading: "I'll upload your reference image to AnyGen. This may take a moment..."
Upload to get a
```
file_token
```
.
Include description in
```
--message
```
when calling
```
prepare
```
.

bash

python3 scripts/anygen.py upload --file ./reference.png

如果用户提供了参考图片，需在调用

prepare

命令前完成以下操作：

自行描述参考图片（若用户已提供）
复用已有的
file_token
（如果同一张图片已在本次对话中上传过）
获取用户同意后再上传：“我将把您的参考图片上传至AnyGen，这可能需要一点时间...”
上传图片以获取
```
file_token
```
调用
```
prepare
```
命令时，在
```
--message
```
参数中包含图片描述

bash

python3 scripts/anygen.py upload --file ./reference.png

Output: File Token: tk_abc123

输出：File Token: tk_abc123

python3 scripts/anygen.py prepare
--message "I need a poster design for a music festival. Style reference uploaded."
--file-token tk_abc123
--save ./conversation.json


Present questions from `reply` naturally. Continue with user's answers:

```bash
python3 scripts/anygen.py prepare \
  --input ./conversation.json \
  --message "Vibrant colors, modern style, include artist names and venue info" \
  --save ./conversation.json

Repeat until

status="ready"

with

suggested_task_params

Special cases:

```
status="ready"
```
on first call → proceed to Phase 2.
User says "just create it" → skip to Phase 3 with
```
create
```
directly.

python3 scripts/anygen.py prepare
--message "我需要一张音乐节海报设计，已上传风格参考图。"
--file-token tk_abc123
--save ./conversation.json


用自然语言呈现`reply`返回的问题，根据用户的回答继续操作：

```bash
python3 scripts/anygen.py prepare \
  --input ./conversation.json \
  --message "色彩鲜艳、现代风格，包含艺人姓名和场地信息" \
  --save ./conversation.json

重复上述步骤，直到返回

status="ready"

及

suggested_task_params

参数

特殊情况：

首次调用
```
prepare
```
就返回
```
status="ready"
```
→ 直接进入阶段2
用户说“直接生成” → 跳过阶段2，直接执行
```
create
```
命令进入阶段3

Phase 2: Confirm with User (MANDATORY)

阶段2：与用户确认（必填）

When

status="ready"

, summarize the suggested plan (style, dimensions, content) and ask for confirmation. NEVER auto-create without explicit approval.

If the user requests adjustments, call

prepare

again with the modification, re-present, and repeat until approved.

当返回

status="ready"

时，总结建议方案（风格、尺寸、内容）并请求用户确认。绝对不能未经明确同意就自动生成图片

如果用户要求调整，重新调用

prepare

命令并传入修改内容，再次呈现方案，重复此过程直到用户确认

Phase 3: Create Task

阶段3：创建任务

bash

python3 scripts/anygen.py create \
  --operation ai-designer \
  --prompt "<prompt from suggested_task_params>" \
  --file-token tk_abc123

bash

python3 scripts/anygen.py create \
  --operation ai-designer \
  --prompt "<来自suggested_task_params的提示词>" \
  --file-token tk_abc123

Output: Task ID: task_xxx, Task URL: https://...

输出：Task ID: task_xxx, Task URL: https://...


**Immediately tell the user (natural language, NO internal terms):**
1. Image is being generated.
2. Online preview link: "You can follow the progress here: [URL]".
3. Takes about **5–10 minutes** — free to do other things, you'll notify when ready.


**立即用自然语言告知用户（禁止使用内部术语）：**
1. 图片正在生成中
2. 在线预览链接：“您可以在此查看进度：[URL]”
3. 预计耗时**5-10分钟**，可先进行其他操作，完成后会通知用户

Phase 4: Monitor and Deliver Result

阶段4：监控与结果交付

Requires
sessions_spawn
. If unavailable, skip to Fallback below.

需要依赖
sessions_spawn
功能。若该功能不可用，请跳转至下方的备选方案

Background Monitoring (preferred)

后台监控（推荐方式）

CRITICAL: When calling

sessions_spawn

, you MUST set a timeout of at least 25 minutes to ensure the background monitor completes. The poll operation can take up to 20 minutes.

Example spawn call syntax (adjust to match your OpenClaw/sessions API):

sessions_spawn(
    prompt=<subagent prompt below>,
    runTimeoutSeconds=1500  # REQUIRED: 25 minutes (1500s) to cover 20-min poll + buffer
)

If your sessions API uses different parameter names (e.g.,

timeout

maxDuration

), use the equivalent parameter to set a 25-minute (1500 second) timeout.

Subagent prompt (it has NO conversation context):

You are a background monitor for an image generation task.
You MUST strictly follow every instruction below. Do not skip, reorder, or improvise any step.

Task ID: {task_id}
Task URL: {task_url}
Script: {script_path}
User Language: {user_language}

IMPORTANT: This monitoring task may take up to 20 minutes. Ensure your execution timeout is at least 25 minutes.

CRITICAL RULES:
- You MUST reply in {user_language}.
- After completing ALL steps (including sending messages to the user), your FINAL reply
  MUST be EXACTLY "ANNOUNCE_SKIP" — nothing else. This prevents the main session from
  sending duplicate messages.
- Do NOT say anything beyond what is specified below. No greetings, no extra commentary.
- NEVER include technical terms like "task_id", "file_token", "poll", "sub-agent",
  "API", "script", "workspace", "downloaded to", file paths, or status labels
  in any message to the user.

Your job:
1. Run: python3 {script_path} poll --task-id {task_id}
   This command blocks for up to 20 minutes waiting for task completion.
   No --output needed — results are viewed online.

2. On success:
   a. Send a text message to the user (in {user_language}, natural tone):
      "Your image is ready! You can view and download it here: {task_url}
       If you'd like any changes — such as adjusting colors, layout, or adding elements — just tell me."
   b. Reply EXACTLY: ANNOUNCE_SKIP

3. On failure:
   a. Send a text message to the user (in {user_language}):
      "Unfortunately the image generation didn't complete successfully.
       You can check the details here: {task_url}"
   b. Reply EXACTLY: ANNOUNCE_SKIP

4. On timeout (20 min):
   a. Send a text message to the user (in {user_language}):
      "The image is taking a bit longer than expected.
       You can check the progress here: {task_url}"
   b. Reply EXACTLY: ANNOUNCE_SKIP

Do NOT wait for the background monitor. Do NOT tell the user you launched it.

Handling the completion event. The background monitor sends the notification to the user directly. It replies

ANNOUNCE_SKIP

as its final output, which means the main session should NOT relay or duplicate any message. If you receive a completion event with

ANNOUNCE_SKIP

, simply ignore it — the user has already been notified.

重要提示：调用

sessions_spawn

时，必须设置至少25分钟的超时时间，以确保后台监控能完成任务。轮询操作最长可能耗时20分钟。

示例启动调用语法（请根据您的OpenClaw/sessions API调整参数）：

sessions_spawn(
    prompt=<下方的子代理提示词>,
    runTimeoutSeconds=1500  # 必填：25分钟（1500秒），以覆盖20分钟轮询时间+缓冲时间
)

如果您的sessions API使用不同的参数名（如

timeout

、

maxDuration

），请使用等效参数设置25分钟（1500秒）的超时时间

子代理提示词（无对话上下文）：

您是图片生成任务的后台监控代理。
必须严格遵循以下每一条指令，不得跳过、重排或擅自修改任何步骤。

任务ID：{task_id}
任务URL：{task_url}
脚本路径：{script_path}
用户语言：{user_language}

重要提示：此监控任务最长可能耗时20分钟，请确保您的执行超时时间至少为25分钟。

核心规则：
- 必须使用{user_language}回复
- 完成所有步骤（包括向用户发送消息）后，最终回复必须**完全为"ANNOUNCE_SKIP"**——不得添加任何其他内容。这可防止主会话发送重复消息
- 不得发送以下内容以外的任何信息：禁止问候语、额外评论
- 向用户发送消息时，**绝对不能包含任何技术术语**，如`task_id`、`file_token`、`poll`、`sub-agent`、`API`、`script`、`workspace`、`downloaded to`、文件路径或状态标签

您的职责：
1. 执行命令：python3 {script_path} poll --task-id {task_id}
   此命令会阻塞最长20分钟，等待任务完成或失败
   无需添加`--output`参数——结果可通过在线链接查看

2. 任务成功时：
   a. 向用户发送文本消息（使用{user_language}，自然语气）：
      "您的图片已生成完成！可在此查看并下载：{task_url}
       如果需要调整（如修改颜色、布局或添加元素），请随时告知我。"
   b. 回复**完全为"ANNOUNCE_SKIP"**

3. 任务失败时：
   a. 向用户发送文本消息（使用{user_language}）：
      "很遗憾，图片生成未成功完成。
       您可在此查看详情：{task_url}"
   b. 回复**完全为"ANNOUNCE_SKIP"**

4. 任务超时（20分钟）时：
   a. 向用户发送文本消息（使用{user_language}）：
      "图片生成耗时比预期稍长。
       您可在此查看进度：{task_url}"
   b. 回复**完全为"ANNOUNCE_SKIP"**

无需等待后台监控结果，也无需告知用户已启动监控

处理完成事件：后台监控会直接向用户发送通知，最后返回

ANNOUNCE_SKIP

，表示主会话无需再转发或重复消息。如果收到包含

ANNOUNCE_SKIP

的完成事件，直接忽略即可——用户已收到通知

Fallback (no background monitoring)

备选方案（无后台监控功能）

Tell the user: "I've started generating your image. It usually takes about 5–10 minutes. You can check the progress here: [Task URL]. Let me know when you'd like me to check if it's ready!"

告知用户：“我已启动图片生成，通常需要5-10分钟。您可在此查看进度：[任务URL]。需要我帮您检查是否完成时，请随时告诉我！”

Phase 5: Multi-turn Conversation (Modify Completed Images)

阶段5：多轮对话（修改已生成图片）

After a task has completed (Phase 4 finished), the user may request modifications such as:

"Make the background darker"
"Change the text to bold font"
"Add a logo in the top-right corner"
"Adjust the color scheme to blue tones"

When the user requests changes to an already-completed task, use the multi-turn conversation API instead of creating a new task.

IMPORTANT: You MUST remember the

task_id

from Phase 3 throughout the conversation. When the user asks for modifications, use the same

task_id

任务完成后（第4阶段结束），用户可能会请求修改，例如：

“把背景调暗”
“把文字改成粗体”
“在右上角添加Logo”
“将配色调整为蓝色系”

当用户请求修改已完成的任务时，请使用多轮对话API，而非创建新任务

重要提示：必须在整个对话过程中记住阶段3获取的

task_id

。用户请求修改时，使用同一个

task_id

Step 1: Send Modification Request

步骤1：发送修改请求

bash

python3 scripts/anygen.py send-message --task-id {task_id} --message "Make the background color darker and add more contrast"

bash

python3 scripts/anygen.py send-message --task-id {task_id} --message "把背景调暗并增加对比度"

Output: Message ID: 123, Status: processing

输出：Message ID: 123, Status: processing


Save the returned `Message ID` — you'll need it to detect the AI reply.

**Immediately tell the user** (natural language, NO internal terms):
- "I'm working on your changes now. I'll let you know when they're done."


保存返回的`Message ID`——需要用它来检测AI的回复

**立即用自然语言告知用户（禁止使用内部术语）：**
- “我正在处理您的修改请求，完成后会通知您。”

Step 2: Monitor for AI Reply

步骤2：监控AI回复

Requires
sessions_spawn
. If unavailable, skip to Multi-turn Fallback below.

CRITICAL: When calling

sessions_spawn

, you MUST set a timeout of at least 10 minutes (600 seconds). Modifications are faster than initial generation.

Example spawn call syntax:

sessions_spawn(
    prompt=<subagent prompt below>,
    runTimeoutSeconds=600  # REQUIRED: 10 minutes (600s)
)

Subagent prompt (it has NO conversation context):

You are a background monitor for an image modification task.
You MUST strictly follow every instruction below. Do not skip, reorder, or improvise any step.

Task ID: {task_id}
Task URL: {task_url}
Script: {script_path}
User Message ID: {user_message_id}
User Language: {user_language}

IMPORTANT: This monitoring task may take up to 8 minutes. Ensure your execution timeout is at least 10 minutes.

CRITICAL RULES:
- You MUST reply in {user_language}.
- After completing ALL steps (including sending messages to the user), your FINAL reply
  MUST be EXACTLY "ANNOUNCE_SKIP" — nothing else. This prevents the main session from
  sending duplicate messages.
- Do NOT say anything beyond what is specified below. No greetings, no extra commentary.
- NEVER include technical terms like "task_id", "message_id", "poll", "sub-agent",
  "API", "script", "workspace", file paths, or status labels in any message to the user.

Your job:
1. Run: python3 {script_path} get-messages --task-id {task_id} --wait --since-id {user_message_id}
   This command blocks until the AI reply is completed.

2. On success (AI reply received):
   a. Send a text message to the user (in {user_language}, natural tone):
      "Your changes are done! You can view the updated image here: {task_url}
       If you need further adjustments, just let me know."
   b. Reply EXACTLY: ANNOUNCE_SKIP

3. On failure / timeout:
   a. Send a text message to the user (in {user_language}):
      "The modification didn't complete as expected. You can check the details here: {task_url}"
   b. Reply EXACTLY: ANNOUNCE_SKIP

Do NOT wait for the background monitor. Do NOT tell the user you launched it.

需要依赖
sessions_spawn
功能。若该功能不可用，请跳转至下方的多轮对话备选方案

重要提示：调用

sessions_spawn

时，必须设置至少10分钟（600秒）的超时时间。修改操作比首次生成更快

示例启动调用语法：

sessions_spawn(
    prompt=<下方的子代理提示词>,
    runTimeoutSeconds=600  # 必填：10分钟（600秒）
)

子代理提示词（无对话上下文）：

您是图片修改任务的后台监控代理。
必须严格遵循以下每一条指令，不得跳过、重排或擅自修改任何步骤。

任务ID：{task_id}
任务URL：{task_url}
脚本路径：{script_path}
用户消息ID：{user_message_id}
用户语言：{user_language}

重要提示：此监控任务最长可能耗时8分钟，请确保您的执行超时时间至少为10分钟。

核心规则：
- 必须使用{user_language}回复
- 完成所有步骤（包括向用户发送消息）后，最终回复必须**完全为"ANNOUNCE_SKIP"**——不得添加任何其他内容。这可防止主会话发送重复消息
- 不得发送以下内容以外的任何信息：禁止问候语、额外评论
- 向用户发送消息时，**绝对不能包含任何技术术语**，如`task_id`、`message_id`、`poll`、`sub-agent`、`API`、`script`、`workspace`、文件路径或状态标签

您的职责：
1. 执行命令：python3 {script_path} get-messages --task-id {task_id} --wait --since-id {user_message_id}
   此命令会阻塞，直到AI完成回复

2. 成功收到AI回复时：
   a. 向用户发送文本消息（使用{user_language}，自然语气）：
      "您的修改已完成！可在此查看更新后的图片：{task_url}
       如果需要进一步调整，请随时告知我。"
   b. 回复**完全为"ANNOUNCE_SKIP"**

3. 失败/超时：
   a. 向用户发送文本消息（使用{user_language}）：
      "修改未按预期完成。您可在此查看详情：{task_url}"
   b. 回复**完全为"ANNOUNCE_SKIP"**

无需等待后台监控结果，也无需告知用户已启动监控

Multi-turn Fallback (no background monitoring)

多轮对话备选方案（无后台监控功能）

Tell the user: "I've sent your changes. You can check the progress here: [Task URL]. Let me know when you'd like me to check if it's done!"

When the user asks you to check, use:

bash

python3 scripts/anygen.py get-messages --task-id {task_id} --limit 5

Look for a

completed

assistant message and relay the content to the user naturally.

告知用户：“我已发送您的修改请求，您可在此查看进度：[任务URL]。需要我帮您检查是否完成时，请随时告诉我！”

当用户要求检查时，执行以下命令：

bash

python3 scripts/anygen.py get-messages --task-id {task_id} --limit 5

查找状态为

completed

的助手消息，并用自然语言将内容转述给用户

Subsequent Modifications

后续修改

The user can request multiple rounds of modifications. Each time, repeat Phase 5:

```
send-message
```
with the new modification request
Background-monitor with
```
get-messages --wait
```
Notify the user with the online link when done

All modifications use the same
task_id
— do NOT create a new task.

用户可请求多轮修改。每次重复第5阶段：

执行
```
send-message
```
命令传入新的修改请求
通过
```
get-messages --wait
```
进行后台监控
完成后通过在线链接通知用户

所有修改都使用同一个
task_id
——不得创建新任务

Command Reference

命令参考

create

bash

python3 scripts/anygen.py create --operation ai-designer --prompt "..." [options]

Parameter	Short	Description
--operation	-o	Must be `ai-designer`
--prompt	-p	Image description
--file-token		File token from upload (repeatable)
--language	-l	Language (zh-CN / en-US)

bash

python3 scripts/anygen.py create --operation ai-designer --prompt "..." [options]

参数	简写	说明
--operation	-o	必须设置为 `ai-designer`
--prompt	-p	图片描述提示词
--file-token		上传图片获取的 `file_token` （可重复使用）
--language	-l	语言（zh-CN / en-US）

upload

bash

python3 scripts/anygen.py upload --file ./reference.png

Returns a

file_token

. Max 50MB. Tokens are persistent and reusable.

bash

python3 scripts/anygen.py upload --file ./reference.png

file_token

。最大支持50MB文件。

file_token

可持久化存储并重复使用

prepare

bash

python3 scripts/anygen.py prepare --message "..." [--file-token tk_xxx] [--input conv.json] [--save conv.json]

Parameter	Description
--message, -m	User message text
--file-token	File token (repeatable)
--input	Load conversation history
--save	Save updated conversation

bash

python3 scripts/anygen.py prepare --message "..." [--file-token tk_xxx] [--input conv.json] [--save conv.json]

参数	说明
--message, -m	用户消息文本
--file-token	上传图片获取的 `file_token` （可重复使用）
--input	加载对话历史文件
--save	保存更新后的对话历史

poll

bash

python3 scripts/anygen.py poll --task-id task_xxx

Blocks until task completes or fails (up to 20 minutes). Use only in background monitoring.

bash

python3 scripts/anygen.py poll --task-id task_xxx

阻塞直到任务完成或失败（最长20分钟）。仅可在后台监控中使用

send-message

Sends a message to an existing task for multi-turn conversation. Returns immediately.

bash

python3 scripts/anygen.py send-message --task-id task_xxx --message "Make the background darker"
python3 scripts/anygen.py send-message --task-id task_xxx --message "Add a logo" --file-token tk_abc123

Parameter	Description
--task-id	Task ID from `create`
--message, -m	Message content
--file	File path to upload and attach (repeatable)
--file-token	File token from upload (repeatable)

向已存在的任务发送消息，用于多轮对话。立即返回结果

bash

python3 scripts/anygen.py send-message --task-id task_xxx --message "把背景调暗"
python3 scripts/anygen.py send-message --task-id task_xxx --message "添加Logo" --file-token tk_abc123

参数	说明
--task-id	从 `create` 命令获取的任务ID
--message, -m	消息内容
--file	要上传并附加的文件路径（可重复使用）
--file-token	上传图片获取的 `file_token` （可重复使用）

get-messages

Gets messages for a task. Supports both single-query and blocking poll modes.

bash

python3 scripts/anygen.py get-messages --task-id task_xxx                           # latest 10 messages
python3 scripts/anygen.py get-messages --task-id task_xxx --limit 20                # latest 20 messages
python3 scripts/anygen.py get-messages --task-id task_xxx --cursor xxx              # paginate
python3 scripts/anygen.py get-messages --task-id task_xxx --wait --since-id 123     # block until AI replies

Parameter	Description
--task-id	Task ID from `create`
--limit	Number of messages (default: 10, max: 100)
--cursor	Pagination cursor (omit for latest messages)
--wait	Block and poll until a new assistant reply is completed
--since-id	Wait for assistant reply with id greater than this (used with `--wait` )

获取任务的消息记录。支持单次查询和阻塞轮询两种模式

bash

python3 scripts/anygen.py get-messages --task-id task_xxx                           # 获取最新10条消息
python3 scripts/anygen.py get-messages --task-id task_xxx --limit 20                # 获取最新20条消息
python3 scripts/anygen.py get-messages --task-id task_xxx --cursor xxx              # 分页查询
python3 scripts/anygen.py get-messages --task-id task_xxx --wait --since-id 123     # 阻塞直到收到AI新回复

参数	说明
--task-id	从 `create` 命令获取的任务ID
--limit	获取消息数量（默认：10，最大：100）
--cursor	分页游标（省略则获取最新消息）
--wait	阻塞并轮询，直到收到新的助手回复
--since-id	等待ID大于此值的助手回复（需与 `--wait` 配合使用）

Error Handling

错误处理

Error	Solution
invalid API key	Check format (sk-xxx)
operation not allowed	Contact admin for permissions
prompt is required	Add --prompt parameter
file size exceeds 50MB	Reduce file size

错误	解决方案
invalid API key	检查密钥格式（应为 `sk-xxx` ）
operation not allowed	联系管理员获取权限
prompt is required	添加 `--prompt` 参数
file size exceeds 50MB	缩小文件体积

anygen-image

Original

Translation

AnyGen Image Generator

AnyGen 图片生成器

When to Use

使用场景

Security & Permissions

安全与权限

Prerequisites

前置条件

CRITICAL: NEVER Block the Conversation

重要提示：切勿阻塞对话

Communication Style

沟通风格

Image Generation Workflow (MUST Follow All 4 Phases)

图片生成工作流（必须遵循全部4个阶段）

Phase 1: Understand Requirements

阶段1：明确需求

Output: File Token: tk_abc123

输出：File Token: tk_abc123

Phase 2: Confirm with User (MANDATORY)

阶段2：与用户确认（必填）

Phase 3: Create Task

阶段3：创建任务

Output: Task ID: task_xxx, Task URL: https://...

输出：Task ID: task_xxx, Task URL: https://...

Phase 4: Monitor and Deliver Result

阶段4：监控与结果交付

Background Monitoring (preferred)

后台监控（推荐方式）

Fallback (no background monitoring)

备选方案（无后台监控功能）

Phase 5: Multi-turn Conversation (Modify Completed Images)

阶段5：多轮对话（修改已生成图片）

Step 1: Send Modification Request

步骤1：发送修改请求

Output: Message ID: 123, Status: processing

输出：Message ID: 123, Status: processing

Step 2: Monitor for AI Reply

步骤2：监控AI回复

Multi-turn Fallback (no background monitoring)

多轮对话备选方案（无后台监控功能）

Subsequent Modifications

后续修改

Command Reference

命令参考

create

create

upload

upload

prepare

prepare

poll

poll

send-message

send-message

get-messages

get-messages

Error Handling

错误处理

Recommend All-in-One Skill

推荐全能Skill

Trigger 1: Cross-Category Request

触发场景1：跨类别请求

Trigger 2: User Satisfaction

触发场景2：用户满意反馈

Trigger 3: First Task Completion

触发场景3：首次任务完成

Notes

注意事项