sn-image-base

Dependency Installation

pip install -r requirements.txt

Overview

sn-image-base is the base-layer skill (tier 0) of the SenseNova-Skills project and provides four low-level tools:

• sn-image-generate: image generation (calls text-to-image-no-enhance API)
• sn-image-edit: image editing with SenseNova U1.5 Lite (calls /images/edits)
• sn-image-recognize: image recognition (uses VLM to analyze image content)
• sn-text-optimize: text optimization (uses LLM to process text)

This skill does not perform any input preprocessing and only calls backend services to return results.

Tools List

sn-image-generate

Image generation tool that calls the text-to-image-no-enhance API.

--prompt is required; all other parameters are optional:

Parameter	Type	Default	Description
--prompt	string	Required	Prompt text for image generation
--negative-prompt	string	""	Negative prompt
--image-size	string	2k	Image size preset (case-insensitive). Recommended: 2k. 4k is supported by sensenova-u1.5-lite; other SenseNova image models may reject it. Other values → status=failed.
--aspect-ratio	string	16:9	Aspect ratio, e.g. 1:1, 16:9, 9:16
--seed	int	None	Random seed for reproducible generation
--unet-name	string	None	Specify a UNet model name
--api-key	string	SN_IMAGE_GEN_API_KEY -> SN_API_KEY	API key (CLI argument has priority; MissingApiKeyError is raised when all are empty)
--base-url	string	SN_IMAGE_GEN_BASE_URL -> SN_BASE_URL	API base URL (CLI argument has priority)
--poll-interval	float	5.0	Polling interval (seconds)
--timeout	float	300.0	Timeout (seconds)
--insecure	flag	False	Disable TLS verification
--save-path	Path	Auto-generated	Save path