SKILL.md
$27
Critical model names
Use one of these exact model strings:
qwen-image-edit
qwen-image-edit-plus
qwen-image-edit-max
qwen-image-2.0
qwen-image-2.0-pro
qwen-image-2.0-2026-03-03
qwen-image-2.0-pro-2026-03-03
qwen-image-edit-plus-2025-12-15
qwen-image-edit-max-2026-01-16
Prerequisites
- Install SDK in a virtual environment:
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope- Set
DASHSCOPE_API_KEYin your environment, or adddashscope_api_keyto~/.alibabacloud/credentials.
Normalized interface (image.edit)
Request
prompt(string, required)
image(string | bytes, required) source image URL/path/bytes
mask(string | bytes, optional) inpaint region mask
size(string, optional) e.g.1024*1024
seed(int, optional)
Response
image_url(string)
seed(int)
request_id(string)
Operational guidance
- Keep prompts task-oriented: describe what to change and what to preserve.
- Use masks for deterministic local edits.
- Save output assets to object storage and persist only URLs.
- For subject consistency, provide explicit constraints in prompt.
Local helper script
Prepare a normalized request JSON and validate response schema:
.venv/bin/python skills/ai/image/alicloud-ai-image-qwen-image-edit/scripts/prepare_edit_request.py \
--prompt "Replace the sky with sunset, keep buildings unchanged" \
--image "https://example.com/input.png"Output location
- Default output:
output/alicloud-ai-image-qwen-image-edit/images/
- Override base dir with
OUTPUT_DIR.
Workflow
- Confirm user intent, region, identifiers, and whether the operation is read-only or mutating.
- Run one minimal read-only query first to verify connectivity and permissions.
- Execute the target operation with explicit parameters and bounded scope.
- Verify results and save output/evidence files.
References
references/sources.md