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