mcpField
A
alicloud-ai-image-qwen-image-edit

alicloud-ai-image-qwen-image-edit

github.com/cinience创意与媒体396335 次安装11 周前更新
代码仓库

关于 alicloud-ai-image-qwen-image-edit

通过 DashScope SDK 调用 Qwen Image Edit 模型，按指令编辑输入图像。支持可选遮罩，并可准备规范化的编辑请求。

主要功能

  1. 01按指令编辑图像
  2. 02支持可选修复遮罩
  3. 03图像 URL、路径或字节输入
  4. 04规范化编辑请求准备

适用场景

  1. 01替换图像背景并保留物体
  2. 02使用遮罩进行局部编辑

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cinience/alicloud-skills --skill alicloud-ai-image-qwen-image-edit

安装后在 Claude Code 中输入/alicloud-ai-image-qwen-image-edit确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
sources.md
scripts/
prepare_edit_request.py

详细介绍

Category: 提供商

Model Studio Qwen 图像编辑

验证

mkdir -p output/alicloud-ai-image-qwen-image-edit
python -m py_compile skills/ai/image/alicloud-ai-image-qwen-image-edit/scripts/prepare_edit_request.py && echo "py_compile_ok" > output/alicloud-ai-image-qwen-image-edit/validate.txt

通过标准：命令以退出码 0 结束，并生成 output/alicloud-ai-image-qwen-image-edit/validate.txt。

输出与证据

  • 将编辑请求载荷、结果 URL 和模型参数保存到 output/alicloud-ai-image-qwen-image-edit/。
  • 保留一组示例请求/响应对，以便复现。

使用 Qwen Image Edit 模型根据指令编辑图像，而不是通过文本生成图像。

关键模型名称

使用以下精确模型字符串之一：

  • 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

前置条件

  • 在虚拟环境中安装 SDK：
python3 -m venv .venv
. .venv/bin/activate
python -m pip install dashscope
  • 在环境中设置 DASHSCOPE_API_KEY，或将 dashscope_api_key 添加到 ~/.alibabacloud/credentials。

标准化接口（image.edit）

请求
  • prompt（字符串，必填）
  • image（字符串 | 字节，必填）源图像 URL/路径/字节
  • mask（字符串 | 字节，可选）局部修复区域蒙版
  • size（字符串，可选），例如 1024*1024
  • seed（整数，可选）
响应
  • image_url（字符串）
  • seed（整数）
  • request_id（字符串）

操作指南

  • 让提示词以任务为导向：说明要更改和保留的内容。
  • 使用蒙版进行确定性的局部编辑。
  • 将输出素材保存到对象存储，并仅持久化 URL。
  • 为保持主体一致性，请在提示词中明确约束条件。

本地辅助脚本

准备标准化请求 JSON 并验证响应架构：

.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/alicloud-ai-image-qwen-image-edit/images/
  • 使用 OUTPUT_DIR 覆盖基础目录。

工作流

  1. 确认用户意图、区域、标识符，以及操作是只读还是会修改数据。
  2. 先执行一条最简只读查询，以验证连接和权限。
  3. 使用明确参数和有限范围执行目标操作。
  4. 验证结果并保存输出/证据文件。

参考资料

  • references/sources.md

评论

支持 Markdown