--- name: printpal-3d description: Generate 3D models for 3D printing from images or text prompts using PrintPal API. Use when the user wants to create 3D printable models, convert images to STL/GLB/OBJ files, or generate 3D assets from text descriptions. Supports text-to-image via WaveSpeed when WAVESPEED_API_KEY is configured. Works with file paths, URLs, or images pasted directly into chat. credentials: - name: PRINTPAL_API_KEY required: true description: API key for PrintPal 3D generation (get from https://printpal.io/api-keys) - name: WAVESPEED_API_KEY required: false description: API key for text-to-image and product photo generation (get from https://wavespeed.ai/accesskey) - name: OPENROUTER_API_KEY required: false description: API key for SEO metadata generation (get from https://openrouter.ai/keys) ---

PrintPal 3D Model Generator

Generate 3D models from images or text prompts for 3D printing.

Quick Start

From an image path or URL:

python3 {baseDir}/scripts/generate_3d.py --image /path/to/image.png

From text prompt:

python3 {baseDir}/scripts/generate_3d.py --prompt "a cute robot toy"

Installation

Required Python packages:

pip install printpal requests

For text-to-image and SEO features:

pip install wavespeed

Configure API keys in your OpenClaw settings (~/.openclaw/openclaw.json under env):

• PRINTPAL_API_KEY - required for 3D generation
• WAVESPEED_API_KEY - for text-to-image and product photos
• OPENROUTER_API_KEY - for SEO metadata generation

Workflow

1. Get the image:

- If user provides a file path → use it directly - If user provides a URL → download it - If user pastes an image → use it directly (it will be available as a file path or URL in context) - If user provides text → generate image via WaveSpeed first

1. Generate 3D model:

- Use PrintPal API with super quality (768 cubed) - Default output format: STL - Save to printpal-output/ directory in workspace

1. Provide downloads:

- Start file server if needed - Return clickable URLs

Default Settings

| Setting | Default | Options | |---------|---------|---------| | Quality | super | default, high, ultra, super, super_texture, superplus, superplus_texture | | Format | stl | stl, glb, obj, ply, fbx |

Scripts

generate_3d.py

Main script for generating 3D models.

python3 scripts/generate_3d.py [OPTIONS]

Options:
  -i, --image PATH      Input image file path or URL
  -p, --prompt TEXT     Text prompt (uses WaveSpeed to generate image first)
  -q, --quality TEXT    Quality level (default: super)
  -f, --format TEXT     Output format (default: stl)
  -o, --output-dir DIR  Output directory
  --json                Output results as JSON

serve_files.py

Start HTTP server for file downloads.

python3 scripts/serve_files.py [OPTIONS]

Options:
  -d, --directory DIR   Directory to serve (default: printpal-output/)
  -p, --port PORT       Port number (default: 8765)
  --host HOST           Host to bind to (default: 127.0.0.1)
  --public              Bind to 0.0.0.0 to allow network access
  --url-only            Just print URL without starting server

Quality Levels

| Quality | Resolution | Credits | Est. Time | |---------|-----------|---------|-----------| | default | 256³ | 4 | 20 sec | | high | 384³ | 6 | 30 sec | | ultra | 512³ | 8 | 60 sec | | super | 768³ | 20 | 3 min | | superplus | 1024³ | 30 | 4 min |

Output Formats

| Format | Best For | |--------|----------| | STL | 3D printing (default) | | GLB | Web/games | | OBJ | Universal compatibility | | PLY | Point clouds | | FBX | Autodesk software |

API Keys

Required environment variables (configure in ~/.openclaw/openclaw.json under env):

• PRINTPAL_API_KEY - Get from https://printpal.io/api-keys (required for 3D generation)
• WAVESPEED_API_KEY - Get from https://wavespeed.ai/accesskey (optional, for text-to-image)
• OPENROUTER_API_KEY - Get from https://openrouter.ai/keys (optional, for SEO generation)

Output Directory

Default output is printpal-output/ in the skill's workspace. Override with:

• Environment variable: PRINTPAL_OUTPUT_DIR=/path/to/output
• Command option: --output-dir /path/to/output

Security Notes

• File server: The serve_files.py script defaults to localhost (127.0.0.1) for security. Use --public flag to expose to network.
• Third-party packages: Scripts import printpal, wavespeed, and requests packages. Review these packages before installing.
• Downloaded content: The skill downloads images from user-supplied URLs. Treat as untrusted input.

Error Handling

| Error | Solution | |-------|----------| | WAVESPEED_API_KEY not set | Provide image directly or configure API key | | PRINTPAL_API_KEY not set | Configure in OpenClaw settings | | Insufficient credits | Purchase at printpal.io/buy-credits | | Package not installed | Run pip install printpal wavespeed |

---

SEO Product Listing Generator

Generate SEO-optimized metadata and product photos for selling 3D models/prints on marketplaces like Etsy, TikTok Shop, etc.

Quick Start

python3 scripts/seo_product_photos.py \
  --image /path/to/model_photo.jpg \
  --description "A cute dragon figurine" \
  --purpose "Collectible toy for fantasy fans" \
  --audience "Fantasy enthusiasts, collectors, parents buying for kids"

Workflow

1. Input: User provides an image of their 3D model/print + description, purpose, and target audience
2. SEO Generation: OpenRouter MiniMax generates optimized title, description, tags
3. Photo Generation: WaveSpeed nano-banana/edit creates 5 polished product photos
4. Output: ZIP file with metadata + photos, served via local HTTP server

Required Environment Variables

# OpenRouter (for SEO generation)
OPENROUTER_API_KEY=your_openrouter_key

# WaveSpeed (for product photos)
WAVESPEED_API_KEY=your_wavespeed_key

Get OpenRouter key: https://openrouter.ai/keys Get WaveSpeed key: https://wavespeed.ai/accesskey

Options

| Option | Short | Description | Default | |--------|-------|-------------|---------| | --image | -i | Path or URL to input image | (required) | | --description | -d | Description of the 3D model/print | (required) | | --purpose | -p | What the item is for/its use | (required) | | --audience | -a | Target audience/customers | (required) | | --num-photos | -n | Number of photos to generate | 5 | | --port | - | Download server port | 8766 | | --json | - | Output results as JSON | false |

Output

The script generates:

• seo_metadata.txt - Full metadata (title, description, tags, features, etc.)
• product_photo_01.png through product_photo_05.png - Generated product photos
• seo_product_listing.zip - All files packaged for download

Download URL is provided at the end (e.g., http://hostname:8766/seo_product_listing.zip)

SEO Metadata Fields

The generated metadata includes:

• title: Full SEO title (max 140 chars, keywords included)
• short_title: Catchy thumbnail title (max 40 chars)
• description: Detailed listing description (500-1000 words)
• tags: 15 optimized tags for search
• category: Primary marketplace category
• search_terms: 5 high-value search terms
• key_features: 4 key product features
• target_marketplace: Recommended platform

Example

python3 scripts/seo_product_photos.py \
  --image /workspace/my_mug_holder.jpg \
  --description "A custom 3D printed mug holder with dragon design" \
  --purpose "Keeps mugs organized on desk or kitchen, great gift" \
  --audience "Office workers, coffee lovers, home office enthusiasts"

Troubleshooting

...