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.