forked from farhoodlabs/skills
refactor: apply FAR-95 skills review follow-ups
- Remove `playwright-ephemeral/` and `shannon/` entirely per board direction - Fix `minimax-image-generation/SKILL.md` so YAML frontmatter is at line 1 - Add `minimax-image-generation/scripts/generate.sh` (argparse, error-checked, executable) and document invoking it via `bash scripts/generate.sh ...` - Deduplicate `minimax-image-generation/CLAUDE.md` against SKILL.md - `github-app-token`: write token to `$GH_CONFIG_DIR/.gh-token` (preferred) or `$AGENT_HOME/.gh-token` (fallback), fail loudly if neither is set instead of leaking to `mktemp` - Refresh root `CLAUDE.md` to match actual directory contents and patterns - Add root `README.md` with human-facing skills index Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
@@ -1,62 +1,32 @@
|
||||
# MiniMax Image Generation — Implementation Notes
|
||||
|
||||
User-facing docs (aspect ratios, usage, env vars) live in `SKILL.md`. This file is for maintenance notes only.
|
||||
|
||||
## API Reference
|
||||
|
||||
- **Endpoint**: `POST /v1/image_generation`
|
||||
- **Base URL**: `https://api.minimax.io` (international) or `https://api.minimaxi.com` (China)
|
||||
- **Auth**: `Authorization: Bearer <MINIMAX_API_KEY>`
|
||||
- **Model**: `image-01`
|
||||
- **Response**: JSON with `data.image_base64[]` array
|
||||
|
||||
## Example API Call
|
||||
|
||||
```bash
|
||||
curl -X POST "https://api.minimax.io/v1/image_generation" \
|
||||
-H "Authorization: Bearer ${MINIMAX_API_KEY}" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"model": "image-01",
|
||||
"prompt": "men Dressing in white t shirt, full-body stand front view image :25, outdoor",
|
||||
"aspect_ratio": "16:9",
|
||||
"num_images": 1,
|
||||
"response_format": "base64"
|
||||
}'
|
||||
```
|
||||
- **Response**: JSON with `data.image_base64[]` array; errors surface in `base_resp.status_code` / `base_resp.status_msg`.
|
||||
|
||||
## Response Format
|
||||
|
||||
```json
|
||||
{
|
||||
"data": {
|
||||
"image_base64": ["<base64-encoded-jpeg>"]
|
||||
},
|
||||
"data": { "image_base64": ["<base64-encoded-jpeg>"] },
|
||||
"model": "image-01",
|
||||
"request_id": "<id>"
|
||||
"request_id": "<id>",
|
||||
"base_resp": { "status_code": 0, "status_msg": "success" }
|
||||
}
|
||||
```
|
||||
|
||||
## Aspect Ratios
|
||||
|
||||
| Ratio | Dimensions | Use Case |
|
||||
|-------|-----------|----------|
|
||||
| `16:9` | 1920×1080 | Desktop wallpaper, banners |
|
||||
| `1:1` | 1024×1024 | Social media, profile images |
|
||||
| `9:16` | 1080×1920 | Mobile wallpaper, stories |
|
||||
| `4:3` | 1024×768 | Presentations |
|
||||
| `3:4` | 768×1024 | Posters, portraits |
|
||||
|
||||
## Dependencies
|
||||
|
||||
- `curl` — HTTP requests
|
||||
- `jq` — JSON parsing
|
||||
- `base64` — Decode image data (coreutils)
|
||||
|
||||
All three are standard Unix tools. No Python or Node required.
|
||||
|
||||
## File Structure
|
||||
|
||||
```
|
||||
minimax-image-generation/
|
||||
├── SKILL.md # Skill definition + user-facing docs
|
||||
└── CLAUDE.md # These implementation notes
|
||||
├── SKILL.md # Skill definition + user-facing docs
|
||||
├── CLAUDE.md # These implementation notes
|
||||
└── scripts/
|
||||
└── generate.sh # Generate images (invoke via `bash scripts/generate.sh …`)
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user