Image Racer - 极速竞速文生图

作者: 张小帅

版本: 1.0.0

基于: nk-images API

---

🚀 核心优势

• ⚡ 最快1-3秒返回搜索结果（如果图片库已收录）
• 🎯 并发竞速：搜索和AI生成同时发起，谁先完成用谁
• 🔄 智能降级：搜索无结果时自动转入生成模式
• 📊 配额管理：检查并限制生成次数（30张/天免费）
• 🎨 多比例支持：1:1, 9:16, 16:9, 3:4, 4:3
• 🌐 中文友好：中文提示词自动增强转英文

---

📋 功能说明

工作流程

用户请求图片
    ↓
1. 并发发起：
   - 任务A: 快速搜索（1-3秒）
   - 任务B: AI生成（30-90秒）
    ↓
谁先完成优质结果 → 立即返回给用户
    ↓
另一个完成后 → 作为补充选项提供

触发词

• 画图、画、生成图片
• 文生图、imagine
• photo、picture

参数

参数	类型	必填	默认	说明
prompt	string	✅	-	图片描述（中英文均可）
negative	string	❌	标准负向词	不想出现的内容
ratio	string	❌	1:1	图片比例：1:1 / 9:16 / 16:9 / 3:4 / 4:3

---

🎯 使用示例

用户: 画一个赛博朋克风格的帅哥头像
Agent: (1-3秒内返回)
    找到 8 张相关图片（来自图库搜索）

    1. 📸 Cyberpunk Portrait #1
       View: https://nkimages.com/photo/xxx
       Download: https://...

    2. 📸 ...

    [后台生成中...] 🕐 预计30-90秒
    完成后会补充显示AI生成的独特图片

---

🔧 技术细节

API 依赖

• NK Images Search API: GET /api/public/images
• NK Images Generate API: POST /api/public/generate/anonymous
• Quota Check: GET /api/public/generate/quota
• Poll Status: GET /api/public/generate/anonymous/{id}/status

异步架构

async def run(context):
    # 并发执行搜索和生成
    search_task = asyncio.create_task(fast_search())
    generate_task = asyncio.create_task(background_generate())

    # 快速路径：搜索命中 → 立即返回
    search_result = await search_task
    if search_result.images:
        return quick_response(search_result)

    # 慢速路径：等待生成完成
    generate_result = await generate_task
    return generate_response(generate_result)

错误处理

• 网络超时自动重试
• API失败降级到另一条路径
• 配额超限友好提示
• 异常捕获，不阻塞主线程

---

📊 性能对比

方案	最快	最慢	稳定性	说明
原 nk-images-search	~30s	~120s	✅	串行：搜索→生成
Image Racer (新)	1-3s	30-90s	✅	**并发：搜索	生成**
豆包模拟网页	~30s	~60s	⚠️	模拟浏览器慢

---

🔐 限制与配额

• 免费生成额度: 30张/天（按 NK Images 政策）
• 搜索限制: 无限制（图库100万+）
• 超限处理: 提示用户明天再试或使用搜索结果

---

🛠️ 部署说明

1. 依赖: aiohttp (已安装)
2. 放置位置: .openclaw/skills/image-racer/
3. 文件结构:

   image-racer/
   ├── image_racer.py
   ├── image_racer.skill.json
   └── SKILL.md (本文件)

1. 重启网关: openclaw gateway restart
2. 测试: 发送"画一只猫"

---

📝 版本历史

v1.0.0 (2026-03-30)

• 初始版本
• 实现搜索+生成并发竞速
• 基于 nk-images API
• 异步架构，OpenClaw 兼容

---

关键词: 文生图, AI绘画, 快速生图, 竞速, nk-images