360 Secure SkillHub
360 安全技能中心

Recraft AI

通过 uv 运行 scripts/recraft.py 调用 Recraft API,支持文生图、图生图、替换背景、移除背景、矢量化、锐化/创意放大、图像变体及查询用户信息;需 RECRAFT_API_TOKEN,结果图片保存到指定本地路径(矢量与图标样式输出 SVG)。

nkrcrft
nkrcrft
热度 92.80
最近更新 2026-05-11 15:53:42
分类:创作依赖:代码执行 / 读写文件 / 第三方 API应用场景:图像生成

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add recraft
Metadata
name
recraft
description
Generate, vectorize, upscale, replace background, variate, remove background, and transform images via Recraft API.
homepage
https://www.recraft.ai/
metadata
{"openclaw":{"emoji":"🎨","requires":{"bins":["uv"],"env":["RECRAFT_API_TOKEN"]},"primaryEnv":"RECRAFT_API_TOKEN","install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)"}]}}

Recraft

Use the bundled script to generate, vectorize, upscale, replace background, variate, remove background, and transform images via Recraft API.

Setup

  1. To access your API key, log in to Recraft and visit the page: https://www.recraft.ai/profile/api
  2. Generate a token by hitting ‘Generate new key’ button (available only if your API units balance is above zero)
  3. Set environment variable:
    export RECRAFT_API_TOKEN="your-api-token"
    

Commands

Generate Image

uv run {baseDir}/scripts/recraft.py generate --prompt "your image description" --style "Recraft V3 Raw" --filename "output.png" --size "16:9"

Image to Image

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

Replace Background

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

Vectorize Image

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

Remove Background

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

Crisp Upscale

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

Creative Upscale

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

Variate Image

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

Get User Information

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

Parameters

  • --prompt, -p: Text description for image generation or editing, max 1000 characters
  • --input, -i: Input image path (for editing/transformation commands)
  • --filename, -f: Output filename
  • --style, -s: Visual style (default: Recraft V3 Raw)
    • Recraft V3 Raw, Photorealism, Illustration, Vector art, Icon
  • --size: Output size as aspect ratio (default: 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: Transformation strength for image-to-image (0.0-1.0, default: 0.5), where 0 means almost identical, and 1 means minimal similarity

API Key

  • RECRAFT_API_TOKEN env var
  • Or set skills."recraft".apiKey / skills."recraft".env.RECRAFT_API_TOKEN in ~/.openclaw/openclaw.json

Notes

  • Use timestamps in filenames: yyyy-mm-dd-hh-mm-ss-name.png.
  • The script prints a MEDIA: line for OpenClaw to auto-attach on supported chat providers.
  • Do not read the image back; report the saved path only.
  • Vector art and Icon styles output SVG format.
  • Rate limits: 100 requests per minute; 5 requests per second.