pony-image-agent

AI 商业图片生成工具,支持单图生成、风格复刻、套图生成三大能力

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "pony-image-agent" with this command: npx skills add lirule007/pony-image

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

快速决策

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

  1. 有参考图片想复制风格吗? → 风格复刻 (/image replicate)
  2. 需要多张主题统一的图片? → 套图生成 (/image suite)
  3. 只需要一张新图片? → 单图生成 (/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 对象,包含 styleAnalysisSummarycolorSystemphotographyStyle 等。

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默认,快速生成,仅 1K
google/gemini-3-pro-image-preview高质量,支持 2K/4K

错误处理

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

限制

  • 单次请求超时 60 秒
  • Base64 图片大小建议 < 4MB
  • 生成结果为 Base64 格式
  • 2K/4K 分辨率仅限 Pro 模型

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

Tencent Cloud Rum

Query Tencent Cloud RUM data, analyze Web performance (LCP/FCP/WebVitals), troubleshoot JS/Promise errors, analyze API latency & error rates, diagnose slow s...

Registry SourceRecently Updated
General

Generator Video

Skip the learning curve of professional editing software. Describe what you want — generate a 30-second promotional video from this script with background mu...

Registry SourceRecently Updated
General

A Video Using

Skip the learning curve of professional editing software. Describe what you want — trim the intro, add background music, and export as a highlight reel — and...

Registry SourceRecently Updated
General

Power Automate Monitoring

**Pro+ subscription required.** Tenant-wide Power Automate flow health monitoring, failure rate analytics, and asset inventory using the FlowStudio MCP cache...

Registry SourceRecently Updated