Firefly Image 2 · 1K 生图【星元科技·Firefly·出品】
把文字想法或参考图变成一张 1K 图片，适合社媒配图、海报草图、电商创意和视觉方向预览。每次成功生成收费 0.20 元；无法生成时自动原路退款。
使用前检查
先确认当前 Agent 已安装并可调用 weixinpay 扩展。若不可用，直接告诉用户当前环境暂不支持微信支付，不要发起生图请求。
整理输入
从用户要求中整理以下字段：
prompt：必填，清楚描述主体、场景、风格、光线、构图和需要保留的文字。aspect_ratio：可选。只允许1:1、16:9、9:16、4:3、3:4、3:2、2:3；未指定时使用1:1。reference_images：可选，填入 1–14 个可公开访问的http或https图片地址。没有参考图时传空数组。
画幅意图出现在提示词中时，要同步转换为 aspect_ratio：
| 用户意图 | aspect_ratio |
|---|---|
| 方形、头像、商品主图 | 1:1 |
| 横版、封面、视频画面 | 16:9 |
| 竖版、手机海报、短视频封面 | 9:16 |
| 常规横图 | 4:3 |
| 常规竖图 | 3:4 |
| 摄影横幅 | 3:2 |
| 摄影竖幅 | 2:3 |
若用户只提供了本地文件，当前版本不能直接上传；先请用户提供可公开访问的图片地址，不要把本地路径放入请求。
发起调用
向以下地址发起 POST 请求：
https://firefly.qwjxqn.xyz/api/skillpay/image2-1k
请求头：
Content-Type: application/json
请求体示例：
{
"prompt": "白色背景上的透明蓝绿色玻璃奖杯，产品摄影，柔和侧光，细节清晰",
"aspect_ratio": "4:3",
"reference_images": []
}
首次调用若收到 HTTP 402：
- 保存响应头
WeixinPay-Required与X-Out-Trade-No。 - 交由
weixinpay扩展向用户申请本次 0.20 元支付授权。 - 支付成功后，用完全相同的 JSON 请求体重新调用原地址。
- 重试时原样带上这两个响应头，不得修改提示词、画幅或参考图顺序。
Content-Type: application/json
WeixinPay-Required: <首次响应中的值>
X-Out-Trade-No: <首次响应中的值>
不得绕过支付步骤，也不得为同一订单重复付款。
等待结果
支付后的重试通常返回 HTTP 202，其中包含：
status_urltask_tokenout_trade_no
每 3 秒请求一次 status_url，请求头如下：
Authorization: Bearer <task_token>
最多等待 5 分钟。按返回的 code 处理：
code |
处理方式 |
|---|---|
PROCESSING |
继续等待并轮询 |
SUCCESS |
从 content.output[0].url 取图片地址并返回给用户 |
NOT_PAID |
等待 2 秒后，用同一订单重试，不要再次付款 |
REFUND_PENDING |
告知用户生成失败，退款处理中；停止生图重试 |
REFUNDED |
告知用户生成失败且已全额退款；停止生图重试 |
FULFILL_AND_REFUND_FAILED |
告知用户生成与自动退款均失败，保留订单号并联系 Firefly |
图片链接保存 7 天。成功后直接展示图片，并提醒用户及时下载；不要只返回任务号或内部状态。
边界
- 本 Skill 固定使用 Image 2 · 1K，不接受 2K、4K 或其他模型要求。
- 一次调用只生成一张图片。
- 文生图、单参考图和多参考图价格相同。
- 不承诺复刻受版权保护的作品，也不生成违法、欺诈、色情或伤害性内容。
