Recraft
Use the bundled script to generate, vectorize, upscale, replace background, variate, remove background, and transform images via Recraft API.
Setup
- To access your API key, log in to Recraft and visit the page: https://www.recraft.ai/profile/api
- Generate a token by hitting ‘Generate new key’ button (available only if your API units balance is above zero)
- 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.
1---2name: recraft3description: Generate, vectorize, upscale, replace background, variate, remove background, and transform images via Recraft API.4---56# Recraft78Use the bundled script to generate, vectorize, upscale, replace background, variate, remove background, and transform images via Recraft API.910## Setup11121. To access your API key, log in to Recraft and visit the page: https://www.recraft.ai/profile/api132. Generate a token by hitting ‘Generate new key’ button (available only if your API units balance is above zero)143. Set environment variable:15 ```bash16 export RECRAFT_API_TOKEN="your-api-token"17 ```1819## Commands2021### Generate Image2223```bash24uv run {baseDir}/scripts/recraft.py generate --prompt "your image description" --style "Recraft V3 Raw" --filename "output.png" --size "16:9"25```2627### Image to Image2829```bash30uv 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.531```3233### Replace Background3435```bash36uv run {baseDir}/scripts/recraft.py replace-background --prompt "your background description" --style "Recraft V3 Raw" --input "/path/to/input.png" --filename "output.png"37```3839### Vectorize Image4041```bash42uv run {baseDir}/scripts/recraft.py vectorize --input "/path/to/input.png" --filename "output.svg"43```4445### Remove Background4647```bash48uv run {baseDir}/scripts/recraft.py remove-background --input "/path/to/input.png" --filename "output.png"49```5051### Crisp Upscale5253```bash54uv run {baseDir}/scripts/recraft.py crisp-upscale --input "/path/to/input.png" --filename "output.png"55```5657### Creative Upscale5859```bash60uv run {baseDir}/scripts/recraft.py creative-upscale --input "/path/to/input.png" --filename "output.png"61```6263### Variate Image6465```bash66uv run {baseDir}/scripts/recraft.py variate --input "/path/to/input.png" --filename "output.png" --size "16:9"67```6869### Get User Information7071```bash72uv run {baseDir}/scripts/recraft.py user-info73```7475## Parameters7677- `--prompt`, `-p`: Text description for image generation or editing, max 1000 characters78- `--input`, `-i`: Input image path (for editing/transformation commands)79- `--filename`, `-f`: Output filename80- `--style`, `-s`: Visual style (default: Recraft V3 Raw)81 - `Recraft V3 Raw`, `Photorealism`, `Illustration`, `Vector art`, `Icon`82- `--size`: Output size as aspect ratio (default: 1:1)83 - `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`84- `--strength`: Transformation strength for image-to-image (0.0-1.0, default: 0.5), where 0 means almost identical, and 1 means minimal similarity8586## API Key8788- `RECRAFT_API_TOKEN` env var89- Or set `skills."recraft".apiKey` / `skills."recraft".env.RECRAFT_API_TOKEN` in `~/.openclaw/openclaw.json`9091## Notes9293- Use timestamps in filenames: `yyyy-mm-dd-hh-mm-ss-name.png`.94- The script prints a `MEDIA:` line for OpenClaw to auto-attach on supported chat providers.95- Do not read the image back; report the saved path only.96- Vector art and Icon styles output SVG format.97- Rate limits: 100 requests per minute; 5 requests per second.
dvcrn