# Image Creation

> When the user wants to create or edit images → generate with Seedream (text-to-image + image-to-image).

- Skill: `cklxx/image-creation` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add cklxx/image-creation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cklxx/image-creation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: cklxx (https://skillmd.com/u/cklxx)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/cklxx/image-creation

---


# 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`) |