recraft

🎨 专业级 AI 图像生成与编辑

设计榜 #40

基于 Recraft V3 API 的专业图像工具,支持文生图、矢量化、背景移除等 9 种功能,需配置 API Token,适合设计师自动化图像工作流。

收藏
7.1k
安装
2.5k
版本
3.10
CLS 安全性认证2026-04-30
点击查看完整报告 >

使用说明

核心用法

Recraft 技能通过 Python 脚本封装了 Recraft AI 的完整 API 能力,用户通过 uv run 命令调用脚本执行图像处理任务。核心功能涵盖四大类:一是生成类,包括文本生成图像(generate)、图像生成图像(image-to-image)和图像变体(variate);二是编辑类,包括背景替换(replace-background)和背景移除(remove-background);三是增强类,包括清晰放大(crisp-upscale)和创意放大(creative-upscale);四是转换类,支持位图转矢量图(vectorize)。所有操作均需预先配置 RECRAFT_API_TOKEN 环境变量,支持 5 种视觉风格和 13 种宽高比,输出格式根据功能自动适配 PNG 或 SVG。

显著优点

该技能的最大优势在于功能的高度集成与代码的安全规范。相比单一功能工具,Recraft 提供了从生成到后期处理的全链路解决方案,特别适合需要多种图像处理场景的自动化工作流。技术实现上,脚本完全避免了 eval()、exec()、subprocess 等危险函数,依赖版本严格锁定(requests>=2.31.0),且通过 argparse 的 choices 机制对 style、size 等枚举参数进行硬限制,有效防止了注入攻击。错误处理机制完善,API 失败时仅输出状态码和响应文本,不会泄露敏感信息。此外,使用 uv 进行脚本内联依赖管理,无需用户手动维护虚拟环境。

潜在缺点或局限性

首先,该技能完全依赖 Recraft 云端 API,存在网络延迟和服务可用性风险,且受限于 100 请求/分钟、5 请求/秒的速率限制,不适合大批量高并发场景。其次,所有图像处理均需上传至第三方云端,对于包含敏感信息的医疗、法律或商业机密图像存在数据隐私隐患。第三,API 需要付费使用(生成 Token 需账户余额大于零),且未实现请求重试和退避策略,网络波动时可能任务失败。最后,当前缺乏对输入文件 MIME 类型的校验,仅依赖文件扩展名,存在潜在的格式错误风险。

适合的目标群体

该技能特别适合三类用户:一是 UI/UX 设计师和产品经理,需要快速生成界面插图、图标或营销素材;二是电商运营人员,可利用背景移除和矢量化功能批量处理商品图片;三是开发者和自动化工程师,需要将图像生成能力集成到 CI/CD 流程或内容管理系统中。对于学术研究者,矢量化和风格迁移功能也可用于数据可视化增强。不适合对数据隐私要求极高的涉密场景,或需要完全离线处理的环境。

使用风险

常规风险主要包括:API Token 泄露风险(需通过环境变量配置,避免命令行明文暴露);网络依赖风险(脚本执行需稳定连接 Recraft 服务器);数据隐私风险(用户主动上传的图片会被传输至第三方云端存储和处理);文件冲突风险(输出文件直接写入指定路径,若文件名重复可能覆盖已有文件);以及成本风险(API 调用消耗账户余额,大流量使用需注意费用控制)。

安全解读

核心用法

Recraft Skill是一个功能全面的AI图像处理工具,基于Recraft官方API提供9种核心能力:

生成类generate文生图(支持16种比例)、image-to-image图生图(强度0-1可调)、variate图像变体
编辑类replace-background智能背景替换、remove-background一键抠图

增强类crisp-upscale清晰放大、creative-upscale创意放大(AI细节重绘)

专业输出vectorize位图转SVG矢量(支持Vector art/Icon风格直接输出SVG)

所有命令通过uv run执行Python脚本,参数支持--prompt描述(最高1000字符)、--style风格选择(Recraft V3 Raw/Photorealism/Illustration/Vector art/Icon)、--size比例控制。输出文件建议采用yyyy-mm-dd-hh-mm-ss-name.png时间戳命名规范。

显著优点

  • 专业级矢量能力:少数支持直接生成SVG的AI图像工具,设计师可直接获取可编辑矢量文件
  • 风格体系成熟:5种预设风格覆盖从真实摄影到扁平插画的完整光谱,V3 Raw模型质量稳定
  • 工作流友好:命令行设计便于批量处理、脚本集成和自动化管线,输出路径自动打印MEDIA:标签供OpenClaw识别
  • 弹性架构:支持环境变量、配置文件、命令行参数三种密钥配置方式,适应不同部署场景

潜在局限

  • 云端依赖:所有图像处理必须上传至Recraft服务器,离线不可用,存在数据出境风险
  • 速率限制严格:100请求/分钟、5请求/秒的限制对批量处理形成瓶颈
  • 成本门槛:需预充值API units才能生成密钥,无免费额度试错
  • 无本地回退:第三方服务故障时无降级方案,网络波动直接影响可用性

适合人群

UI/UX设计师(矢量图标/插画生产)、电商运营(商品图背景处理)、内容创作者(社交媒体配图批量生成)、开发者(构建AI图像自动化工作流)。尤其适合需要将AI生成内容直接纳入专业设计软件(Figma/Illustrator)的矢量工作流场景。

常规风险

  • 数据隐私:上传图像存储于第三方云服务,敏感/机密图像不应处理
  • API密钥泄露:环境变量配置需避免提交至版本控制
  • 输出一致性:AI生成存在随机性,相同提示词可能产生差异结果,关键项目建议固定seed或增加variate储备

recraft 内容

scripts文件夹
手动下载zip · 4.6 kB
recraft.pytext/plain
请选择文件