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