AgentSkillsCN

recraft

通过 Recraft API，生成、矢量化、放大图像、替换背景、变换图像，甚至移除背景、调整图像风格。

SKILL.md
--- frontmatter
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:
    bash
    export RECRAFT_API_TOKEN="your-api-token"

Commands

Generate Image

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

Image to Image

bash
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

bash
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

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

Remove Background

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

Crisp Upscale

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

Creative Upscale

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

Variate Image

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

Get User Information

bash
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.