mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
docs: audit all 157 tool pages against live schemas
Reconcile every tool page's parameters, defaults, and response shape against the tool's Zod settings schema and executionHint in code. Notable fixes: color-palette (add count + format params, hex output, median-cut algorithm), favicon (add 5 params, was documented as having none), qr-generate (add logoDataUri), convert (add ppm/eps/tga formats), video-loudnorm (-16 LUFS not -14), smart-crop (async 202 not sync 200), images-to-video (1080x1080 square), and several output-filename and behavior-note corrections. Also normalize API endpoint paths to /api/v1/tools/<id> (no modality segment) and standardize curl examples on the Docker API port 1349. Verified with a clean docs build.
This commit is contained in:
@@ -4,7 +4,7 @@ Seam carving resize that intelligently removes or adds pixels along paths of lea
|
||||
|
||||
## API Endpoint
|
||||
|
||||
`POST /api/v1/tools/image/content-aware-resize`
|
||||
`POST /api/v1/tools/content-aware-resize`
|
||||
|
||||
**Processing:** Synchronous (returns result directly)
|
||||
|
||||
@@ -15,8 +15,8 @@ Seam carving resize that intelligently removes or adds pixels along paths of lea
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| file | file | Yes | - | Image file (multipart) |
|
||||
| width | integer | No | - | Target width in pixels |
|
||||
| height | integer | No | - | Target height in pixels |
|
||||
| width | number | No | - | Target width in pixels |
|
||||
| height | number | No | - | Target height in pixels |
|
||||
| protectFaces | boolean | No | `false` | Detect and protect faces from seam removal |
|
||||
| blurRadius | number | No | `4` | Pre-processing blur radius for energy calculation (0-20) |
|
||||
| sobelThreshold | number | No | `2` | Sobel edge detection threshold (1-20). Higher values make the algorithm more aggressive |
|
||||
@@ -27,7 +27,7 @@ At least one of `width`, `height`, or `square` must be specified.
|
||||
## Example Request
|
||||
|
||||
```bash
|
||||
curl -X POST http://localhost:13490/api/v1/tools/image/content-aware-resize \
|
||||
curl -X POST http://localhost:1349/api/v1/tools/content-aware-resize \
|
||||
-F "file=@landscape.jpg" \
|
||||
-F 'settings={"width":800,"protectFaces":true}'
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user