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