Recraft AI

核心功能

Recraft 是一款面向专业设计师和开发者的 AI 图像生成与编辑工具，通过命令行接口提供完整的视觉内容工作流：

生成能力：支持文本生成图像（文生图）和图像风格迁移（图生图），内置 Recraft V3 Raw、Photorealism、Illustration、Vector art、Icon 五种视觉风格，覆盖从写实照片到矢量图标的多元场景。

编辑与优化：提供背景替换、背景移除、Crisp/Creative 双模式智能放大、图像变体生成等精细化操作，满足电商、UI 设计、营销物料等高频需求。矢量化功能可将位图转换为 SVG，直接对接印刷与开发场景。

技术特性：基于 uv 运行时环境，Python 脚本封装 REST API，支持 16 种预设宽高比输出；通过 MEDIA: 协议行实现与 OpenClaw 对话系统的自动附件挂载。

显著优势

• 专业级矢量输出：区别于多数文生图工具，Recraft 原生支持 SVG 矢量格式，可直接用于 Logo、图标系统的规模化生产
• 风格控制精准：V3 模型在插画、图标类任务中结构稳定性较好，Vector art 和 Icon 风格对提示词响应度高
• 自动化友好：纯 CLI 接口、标准化文件输出、OpenClaw 生态集成，适合 CI/CD 流水线与批量内容生成

局限与风险

成本门槛：需预充值 API units 才能生成密钥，无免费额度；按请求计费模式对高频调用场景成本敏感

速率限制：100 次/分钟、5 次/秒的限流对批量处理形成约束，大规模任务需配合队列与重试机制

内容合规：AI 生成图像存在版权归属模糊、训练数据争议及潜在有害内容风险；商业场景需核查 Recraft 服务条款与用户授权范围

技术依赖：强依赖 uv 运行时与网络稳定性，本地环境配置（Token 管理、路径处理）对非技术用户存在门槛

适合人群

• 需要将 AI 图像能力脚本化的开发者、技术型设计师
• 运营团队批量生成营销物料、社媒配图
• UI/UX 设计师快速产出图标、插画原型
• 追求矢量输出以规避分辨率限制的专业用户

安全建议

• 妥善保管 RECRAFT_API_TOKEN，避免硬编码或提交至版本控制
• 敏感行业（金融、医疗、政务）需评估 AI 生成内容的合规披露义务
• 商业使用前确认生成图像的授权范围，警惕潜在版权争议

核心用法

Recraft 技能提供了一套完整的 AI 图像处理工作流，通过命令行工具调用 Recraft 官方 API 实现多种图像生成与编辑功能。核心命令包括：generate 文生图、image-to-image 图生图重绘、replace-background 智能换背景、remove-background 自动抠图、vectorize 图像矢量化、以及 crisp-upscale/creative-upscale 两种超分辨率增强模式。

用户需先获取 Recraft API Token 并配置环境变量，所有操作均通过 uv run 执行 Python 脚本完成。技能支持丰富的风格参数（如 Photorealism、Illustration、Vector art 等）和多尺寸比例输出，生成的图像会自动保存并输出 MEDIA: 标记便于 OpenClaw 自动附加到对话中。

显著优点

该技能的最大优势在于功能集成度高，将原本需要多个专业工具（如 Midjourney、Remove.bg、Vectorizer.ai 等）才能完成的操作整合为统一的命令行接口。Recraft V3 模型在矢量图形和插画风格上表现优异，生成的 SVG 格式文件可直接用于印刷和规模化设计生产。

从安全架构看，技能代码质量优秀：无硬编码密钥、无危险系统调用、依赖精简（仅 requests 库），且网络通信全程 HTTPS 加密。隐私合规方面仅传输功能必需的图像数据和 API Token，符合 GDPR 数据最小化原则。S 级安全认证和 T2 可信来源评级为生产环境部署提供了信心保障。

潜在缺点与局限性

首先，该技能依赖外部商业 API，存在成本门槛——Recraft API 按 Units 计费，用户需确保账户余额充足。其次，网络调用存在 100 req/min 和 5 req/s 的速率限制，批量处理场景下可能形成瓶颈。功能层面，图像生成质量受提示词工程能力影响较大，且不支持本地模型运行，完全依赖云端服务可用性。

技术局限方面，当前脚本对输入验证较为基础，错误处理采用直接退出策略，缺乏重试机制和详细的日志分级。此外，creative-upscale 等功能的实际效果存在不确定性，可能与用户预期产生偏差。

适合的目标群体

该技能特别适合三类用户：一是 UI/UX 设计师和视觉创作者，需要快速生成矢量插画、图标和营销素材；二是电商运营人员，可利用抠图、换背景功能批量处理商品图；三是开发者和自动化工作流构建者，希望将图像生成能力集成到 CI/CD 或内容发布管道中。

不适合对数据主权要求极高、必须本地离线运行的场景，以及预算敏感且调用量极大的企业级批量生产需求。

使用风险

成本风险：API 调用消耗 Credits，高频使用可能产生意外费用，建议设置用量监控。
数据合规风险：图像上传至第三方云服务，含敏感信息的素材需评估合规性。
性能风险：网络延迟和速率限制影响批量任务效率，大文件传输可能超时。
依赖风险：requests 库版本未锁定，未来更新可能引入兼容性变更。
可用性风险：服务完全依赖 Recraft 平台稳定性，单点故障将导致功能中断。