image-creation

Files (5)

• SKILL.md
• run.py
• test_run.py
• __init__.py · tests/
• test_image_creation.py · tests/

SKILL.md (first lines)

# image-creation

Generate images via Seedream.

## Required Env
- `ARK_API_KEY` (required)
- `SEEDREAM_TEXT_ENDPOINT_ID` (optional; fallback: `SEEDREAM_TEXT_MODEL` -> built-in default model)
- `SEEDREAM_I2I_ENDPOINT_ID` (required for `refine`)

## Constraints
- Backend minimum pixels: `1920*1920`. Smaller inputs (for example `1024x1024`) are auto-upscaled.
- `success=true` only when the output file is actually written and non-empty.
- Backend response must contain `b64_json` or `url`; otherwise the call fails.
- Default output path is `/tmp` unless `output` is provided.
- `watermark` defaults to `false` (no "AI generated" watermark). Set to `true` only when you explicitly need watermark.

## Usage

```bash
# Text to image
python3 skills/image-creation/run.py generate --prompt 'white cat in moonlight' --style realistic --watermark false

# Image to image
python3 skills/image-creation/run.py refine --image_path /tmp/cat.png --prompt 'add starry sky background' --watermark false
```

## Parameters

### generate
| name | type | required | notes |
|------|------|------|------|
| prompt | string | yes | image description |
| style | string | no | style tag (default: `realistic`) |
| size | string | no | `WIDTHxHEIGHT`, default `1920x1920` |
| watermark | bool | no | default `false`; whether to enable API watermark |
| output | string | no | output file path (default `/tmp/seedream_<ts>.png`) |

### refine
| name | type | required | notes |
|------|------|------|------|
| image_path | string | yes | input image path |
| prompt | string | yes | refinement instruction |
| watermark | bool | no | default `false`; whether to enable API watermark |
| output | string | no | output path (default `/tmp/seedream_refined_<ts>.png`) |

From cklxx/elephant.ai, MIT.

More from cklxx/elephant.ai