# Send pony-image to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "pony-image",
    "name": "pony-image",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/lirule007/pony-image",
    "canonicalUrl": "https://clawhub.ai/lirule007/pony-image",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/pony-image",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=pony-image",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "pony-image",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T03:24:31.965Z",
      "expiresAt": "2026-05-12T03:24:31.965Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=pony-image",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=pony-image",
        "contentDisposition": "attachment; filename=\"pony-image-1.2.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "pony-image"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/pony-image"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/pony-image",
    "downloadUrl": "https://openagent3.xyz/downloads/pony-image",
    "agentUrl": "https://openagent3.xyz/skills/pony-image/agent",
    "manifestUrl": "https://openagent3.xyz/skills/pony-image/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/pony-image/agent.md"
  }
}
```
## Documentation

### Pony Image Agent — AI 商业图片生成

版本: v2.0 | 最后更新: 2026-02-23

### 环境配置

本技能需要以下环境变量：

PONY_SUPABASE_ANON_KEY — Supabase anon 公钥（JWT 格式，以 eyJ 开头）

API 基础地址（固定）：

BASE_URL=https://vecarpahagopuqbwxbjh.supabase.co/functions/v1

所有请求需携带以下 Header：

Authorization: Bearer $PONY_SUPABASE_ANON_KEY
Content-Type: application/json

### 快速决策

🤔 不知道选哪个功能？按以下决策树选择：

有参考图片想复制风格吗？ → 风格复刻 (/image replicate)
需要多张主题统一的图片？ → 套图生成 (/image suite)
只需要一张新图片？ → 单图生成 (/image generate)

### 🎨 场景1：单图生成

何时使用：只需要一张新图片，无需参考图

对话示例：

用户：帮我生成一张产品图
助手：好的！请告诉我：
  1. 产品描述是什么？
  2. 想要什么风格？（product/lifestyle/minimalist/vintage/dark）
  3. 图片比例？（默认 1:1）

执行方式：收集完信息后，执行以下命令：

curl -s -X POST "$BASE_URL/generate-image" \\
  -H "Authorization: Bearer $PONY_SUPABASE_ANON_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "prompt": "用户描述的内容",
    "style": "minimalist",
    "ratio": "1:1"
  }'

返回格式：

{
  "imageUrl": "data:image/png;base64,...",
  "prompt": "增强后的完整 prompt"
}

将 imageUrl 展示给用户即可。

### 🖼️ 场景2：风格复刻（两步流程）

何时使用：有参考图片，想让新图片保持相同视觉风格

对话示例：

用户：我想复刻这张图的风格
助手：收到参考图！正在分析风格...

（执行 Step 1）

助手：✅ 风格分析完成：
  - 主色调：暖金色
  - 光影：柔和侧光
  - 构图：居中对称
  
  请上传你的产品图，我将按此风格生成新图。

Step 1 — 分析参考图风格：

curl -s -X POST "$BASE_URL/replicate-image" \\
  -H "Authorization: Bearer $PONY_SUPABASE_ANON_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "action": "analyze",
    "referenceImages": ["参考图URL或Base64"]
  }'

返回 plan 对象，包含 styleAnalysisSummary、colorSystem、photographyStyle 等。

Step 2 — 用风格生成新图：

curl -s -X POST "$BASE_URL/replicate-image" \\
  -H "Authorization: Bearer $PONY_SUPABASE_ANON_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "productImages": ["产品图URL或Base64"],
    "plan": { "...Step1返回的plan对象..." },
    "ratio": "1:1"
  }'

返回 imageUrl（生成的图片）。

### 📦 场景3：套图生成（两步流程）

何时使用：需要一组视觉统一的系列图片（如电商主图+详情图）

对话示例：

用户：帮我生成一组电商产品图
助手：好的！我需要了解：
  1. 产品名称和描述？
  2. 需要哪些场景？（主图/场景图/细节图/对比图）
  3. 整体风格偏好？
  
  我会先生成统一设计方案，确认后再逐张生成。

Step 1 — 生成统一设计方案：

curl -s -X POST "$BASE_URL/generate-suite-plan" \\
  -H "Authorization: Bearer $PONY_SUPABASE_ANON_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "productName": "产品名称",
    "productDesc": "产品描述",
    "scenes": ["主图", "场景图", "细节图"],
    "style": "minimalist",
    "ratio": "1:1"
  }'

返回 plan 对象，包含 overallDesign（配色、字体、光影）和每张图的 images 数组。

Step 2 — 逐张生成：对 plan.images 中每张图，将 overallDesign + 该图信息合并到 prompt，调用：

curl -s -X POST "$BASE_URL/generate-image" \\
  -H "Authorization: Bearer $PONY_SUPABASE_ANON_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "prompt": "合并 overallDesign 和 images[i] 信息的完整描述",
    "style": "minimalist",
    "ratio": "1:1"
  }'

### 风格预设 (style)

值说明适用场景product专业产品摄影，干净背景，影棚灯光电商主图、产品展示lifestyle生活场景，自然环境，温暖氛围社交媒体、品牌故事minimalist极简风格，白色背景，现代感官网、品牌手册vintage复古美学，暖色调，怀旧感文艺品牌、咖啡/手工艺dark暗调高级感，戏剧性灯光，高对比科技产品、奢侈品

### 宽高比预设 (ratio)

值适用场景1:1Instagram 帖子、电商主图3:4产品详情页4:5Instagram 竖版帖子9:16手机竖屏、TikTok/抖音4:3横版展示16:9网页横幅、YouTube 封面2:3海报、杂志21:9超宽电影画幅

### AI 模型 (model)

值说明google/gemini-2.5-flash-image默认，快速生成，仅 1Kgoogle/gemini-3-pro-image-preview高质量，支持 2K/4K

### 错误处理

HTTP 状态错误信息解决方案401Unauthorized检查 PONY_SUPABASE_ANON_KEY 是否已配置429请求频率超限等待几秒后重试402AI 额度不足充值后继续使用500图片生成失败简化 prompt 描述，避免过长内容

### 限制

单次请求超时 60 秒
Base64 图片大小建议 < 4MB
生成结果为 Base64 格式
2K/4K 分辨率仅限 Pro 模型
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: lirule007
- Version: 1.2.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T03:24:31.965Z
- Expires at: 2026-05-12T03:24:31.965Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/pony-image)
- [Send to Agent page](https://openagent3.xyz/skills/pony-image/agent)
- [JSON manifest](https://openagent3.xyz/skills/pony-image/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/pony-image/agent.md)
- [Download page](https://openagent3.xyz/downloads/pony-image)