alicloud-ai-image-qwen-image-edit

Original🇺🇸 English
Translated
1 scriptsChecked / no sensitive code detected

Edit images with Alibaba Cloud Model Studio Qwen Image Edit Max (qwen-image-edit-max). Use when modifying existing images (inpaint, replace, style transfer, local edits), preserving subject consistency, or documenting image edit request/response mappings.

3installs
Added on

NPX Install

npx skill4agent add cinience/alicloud-skills alicloud-ai-image-qwen-image-edit
Category: provider

Model Studio Qwen Image Edit

Use Qwen Image Edit models for instruction-based image editing instead of text-to-image generation.

Critical model names

Use one of these exact model strings:
  • qwen-image-edit-max
  • qwen-image-edit-max-2026-01-16

Prerequisites

  • Install SDK in a virtual environment:
bash
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
  • Set
    DASHSCOPE_API_KEY
    in your environment, or add
    dashscope_api_key
    to
    ~/.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:
bash
.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/ai-image-qwen-image-edit/images/
  • Override base dir with
    OUTPUT_DIR
    .

References

  • references/sources.md