pony-image

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

Security Scan

技能在描述、说明和所需环境变量之间内部一致——它通过一个固定的 Supabase 函数端点接收 prompt/图片并返回生成的 Base64 图片；主要风险来自你是否信任该外部后端（数据/图片会被发送到该 Supabase 项目）。

Purpose & Capability

技能名/描述是图片生成（单图/风格复刻/套图），所需的唯一环境变量是 PONY_SUPABASE_ANON_KEY，SKILL.md 的所有示例请求都调用同一 BASE_URL 的 Supabase 函数端点，所请求的权限与功能一致。

Instruction Scope

运行时说明只要求将 prompt 和参考/产品图（URL 或 Base64）POST 到技能内定的 Supabase 函数端点并返回 Base64 图像；没有指示读取本地敏感配置或其它环境变量。但说明隐含会把用户上传的图片/描述传到第三方后端（固定的 BASE_URL），这会导致数据外发——功能内可预见但值得用户注意。

Install Mechanism

无安装脚本、无代码文件，纯说明文档——不会在本地写入或执行下载代码，安装面向风险最低的“instruction-only”类型。

Credentials

仅请求一个环境变量 PONY_SUPABASE_ANON_KEY，并将其用作 Authorization header。就功能而言这是合理的（用于调用 Supabase edge functions）。注意：Supabase anon key 通常权限受限但若项目配置不当可能泄露更多能力；此密钥与技能固定的 BASE_URL 绑定，泄露会让能调用该项目函数的主体伪装请求。

Persistence & Privilege

技能不是 always:true，且无安装步骤或修改其他技能/系统配置的指示；默认的自主调用能力未和其它高权限设置结合出现，因此不存在额外持久特权。

Assessment

这个技能本身在目的和要求上内部一致：它会把你写的 prompt 和你上传的参考/产品图片（URL 或 Base64）POST 到一个固定的 Supabase 函数端点，并返回 Base64 格式的生成图片。你在决定是否安装/使用前应考虑： - 该 BASE_URL（vecarpahagopuqbwxbjh.supabase.co）不是公共知名厂商域名，而是某个 Supabase 项目，意味着你将把数据发送到第三方后端；只在你信任该后端或已核实所有者时使用。 - 提供的 PONY_SUPABASE_ANON_KEY 为调用凭证：anon key 权限通常受限，但若该 Supabase 项目错误配置，key 仍可能用于读取/写入数据；避免将高敏感或受版权保护的图片/机密信息上传。 - 如果你管理自己的数据隐私，最好自行部署同类服务（创建自己的 Supabase 项目并替换 BASE_URL 和 anon key），或要求提供方出示来源/隐私声明和代码/托管仓库以便审查。 - 若担心滥用，可在使用时监控网络请求、为该 key 设置短期/可撤销凭证，并在不使用时撤销或更换它。 总体：功能上一致且实现方式透明，但风险来自后端信任和数据外发——在信任后端前不要上传敏感内容。

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 对象，包含 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:1	Instagram 帖子、电商主图
3:4	产品详情页
4:5	Instagram 竖版帖子
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 状态	错误信息	解决方案
401	Unauthorized	检查 PONY_SUPABASE_ANON_KEY 是否已配置
429	请求频率超限	等待几秒后重试
402	AI 额度不足	充值后继续使用
500	图片生成失败	简化 prompt 描述，避免过长内容

---

限制

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