名称： recraft
描述： 通过 Recraft API 生成、矢量化、放大、替换背景、变换、移除背景及转换图像。
主页： https://www.recraft.ai/
元数据：
{
"openclaw":
{
"emoji": "🎨",
"requires": { "bins": ["uv"], "env": ["RECRAFT_API_TOKEN"] },
"primaryEnv": "RECRAFT_API_TOKEN",
"install":
[
{
"id": "uv-brew",
"kind": "brew",
"formula": "uv",
"bins": ["uv"],
"label": "安装 uv (brew)",
},
],
},
}

Recraft

使用内置脚本通过 Recraft API 实现图像生成、矢量化、放大、背景替换、变换、背景移除及格式转换。

环境配置

1. 登录 Recraft，访问 API 密钥页面：https://www.recraft.ai/profile/api
2. 点击“生成新密钥”按钮创建令牌（仅当 API 余额大于零时可用）
3. 设置环境变量：
   bash export RECRAFT_API_TOKEN="你的API令牌"

命令列表

生成图像

uv run {baseDir}/scripts/recraft.py generate --prompt "图像描述" --style "Recraft V3 Raw" --filename "output.png" --size "16:9"

图像到图像转换

uv run {baseDir}/scripts/recraft.py image-to-image --prompt "图像描述" --style "Recraft V3 Raw" --input "/path/to/input.png" --filename "output.png" --strength 0.5

替换背景

uv run {baseDir}/scripts/recraft.py replace-background --prompt "背景描述" --style "Recraft V3 Raw" --input "/path/to/input.png" --filename "output.png"

图像矢量化

uv run {baseDir}/scripts/recraft.py vectorize --input "/path/to/input.png" --filename "output.svg"

移除背景

uv run {baseDir}/scripts/recraft.py remove-background --input "/path/to/input.png" --filename "output.png"

清晰放大

uv run {baseDir}/scripts/recraft.py crisp-upscale --input "/path/to/input.png" --filename "output.png"

创意放大

uv run {baseDir}/scripts/recraft.py creative-upscale --input "/path/to/input.png" --filename "output.png"

图像变换

uv run {baseDir}/scripts/recraft.py variate --input "/path/to/input.png" --filename "output.png" --size "16:9"

获取用户信息

uv run {baseDir}/scripts/recraft.py user-info

参数说明

• --prompt, -p: 图像生成或编辑的文本描述，最多 1000 字符
• --input, -i: 输入图像路径（用于编辑/转换命令）
• --filename, -f: 输出文件名
• --style, -s: 视觉风格（默认：Recraft V3 Raw）
• Recraft V3 Raw, Photorealism, Illustration, Vector art, Icon
• --size: 输出尺寸比例（默认：1:1）
• 1:1, 2:1, 1:2, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 6:10, 14:10, 10:14, 16:9, 9:16
• --strength: 图像到图像转换的强度（0.0-1.0，默认：0.5），0 表示几乎相同，1 表示相似度最低

API 密钥配置

• 环境变量 RECRAFT_API_TOKEN
• 或在 ~/.openclaw/openclaw.json 中设置 skills."recraft".apiKey / skills."recraft".env.RECRAFT_API_TOKEN

注意事项

• 建议在文件名中使用时间戳：yyyy-mm-dd-hh-mm-ss-name.png
• 脚本会输出 MEDIA: 行，以便 OpenClaw 在支持的聊天平台自动附加文件
• 无需读取图像内容，仅报告保存路径
• 矢量艺术和图标风格输出 SVG 格式
• 频率限制：每分钟 100 次请求；每秒 5 次请求