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---5
6# Recraft
7
8Use the bundled script to generate, vectorize, upscale, replace background, variate, remove background, and transform images via Recraft API.
9
10## Setup
11
121. To access your API key, log in to Recraft and visit the page: https://www.recraft.ai/profile/api
132. Generate a token by hitting ‘Generate new key’ button (available only if your API units balance is above zero)
143. Set environment variable:
15 ```bash
16 export RECRAFT_API_TOKEN="your-api-token"
17 ```
18
19## Commands
20
21### Generate Image
22
23```bash
24uv run {baseDir}/scripts/recraft.py generate --prompt "your image description" --style "Recraft V3 Raw" --filename "output.png" --size "16:9"
25```
26
27### Image to Image
28
29```bash
30uv 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
31```
32
33### Replace Background
34
35```bash
36uv run {baseDir}/scripts/recraft.py replace-background --prompt "your background description" --style "Recraft V3 Raw" --input "/path/to/input.png" --filename "output.png"
37```
38
39### Vectorize Image
40
41```bash
42uv run {baseDir}/scripts/recraft.py vectorize --input "/path/to/input.png" --filename "output.svg"
43```
44
45### Remove Background
46
47```bash
48uv run {baseDir}/scripts/recraft.py remove-background --input "/path/to/input.png" --filename "output.png"
49```
50
51### Crisp Upscale
52
53```bash
54uv run {baseDir}/scripts/recraft.py crisp-upscale --input "/path/to/input.png" --filename "output.png"
55```
56
57### Creative Upscale
58
59```bash
60uv run {baseDir}/scripts/recraft.py creative-upscale --input "/path/to/input.png" --filename "output.png"
61```
62
63### Variate Image
64
65```bash
66uv run {baseDir}/scripts/recraft.py variate --input "/path/to/input.png" --filename "output.png" --size "16:9"
67```
68
69### Get User Information
70
71```bash
72uv run {baseDir}/scripts/recraft.py user-info
73```
74
75## Parameters
76
77- `--prompt`, `-p`: Text description for image generation or editing, max 1000 characters
78- `--input`, `-i`: Input image path (for editing/transformation commands)
79- `--filename`, `-f`: Output filename
80- `--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 similarity
85
86## API Key
87
88- `RECRAFT_API_TOKEN` env var
89- Or set `skills."recraft".apiKey` / `skills."recraft".env.RECRAFT_API_TOKEN` in `~/.openclaw/openclaw.json`
90
91## Notes
92
93- 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.
modbender