返回技能市场
内容创作 安全 需要 API Key

千问AI-图像生成

@qianwen-ai/qianwen-image-generation

使用 Wan 和千问图像模型生成和编辑图像。支持文生图、图像编辑（风格迁移、主体一致性、文本渲染）以及图文交错输出。适用场景：用户希望创作插图、产品图像、艺术设计、海报，进行文生图，编辑/转换现有图像，应用风格迁移，根据参考照片生成图像，创作图文交错内容，提及 Wan/千问图像模型/AI 艺术创作，或明确按名称调用此 skill（例如使用 qianwen-image-generation）。不适用场景：用户希望理解/分析现有图像或进行 OCR（使用 qianwen-vision）、生成视频（使用 qianwen-video-generation）或处理纯文本任务。

千问AI平台 热度 2,593v0.0.2

Qwen 图像生成

使用 Wan 和 Qwen Image 模型生成和编辑图像。支持文生图、参考图像编辑（风格 迁移、主体一致性、多图合成、文本渲染）和图文交错输出。 此 skill 是 QianWen-AI/qianwen-ai 中的一部分。

Skill 目录

使用此 skill 的内部文件来执行和学习。默认路径失效或需要详细信息时，按需加载参考文件。

| 位置 | 用途 | |----------|---------| | scripts/image.py | 默认执行方式 — 同步/异步、上传、下载 | | references/execution-guide.md | 备用方案：curl（同步/异步）、代码生成 | | references/prompt-guide.md | Prompt 公式、风格关键词、negative_prompt、prompt_extend 决策 | | references/api-guide.md | API 补充说明 | | references/sources.md | 官方文档 URL |

安全

严禁以明文输出任何 API 密钥或凭证。 始终使用变量引用（shell 中使用 $DASHSCOPE_API_KEY，Python 中使用 os.environ["DASHSCOPE_API_KEY"]）。任何凭证检查或检测都必须采用 非明文 方式：仅报告状态（例如“已设置”/“未设置”、“有效”/“无效”），禁止报告其值。禁止显示 .env 或可能包含敏感信息的配置文件的内容。

未配置 API 密钥时，禁止要求用户直接提供密钥。 而应协助创建包含占位值（DASHSCOPE_API_KEY=sk-your-key-here）的 .env 文件，并指示用户将该占位值替换为从千问AI平台控制台获取的实际密钥。仅当用户明确提出要求时，才写入实际密钥值。

密钥兼容性

同时支持 PAYG 密钥（sk-ws-...；旧版 sk-...）和 Token Plan 密钥（sk-sp-...）。在不暴露密钥的情况下检测 API 密钥类型：

python3 -c "
import sys; sys.path.insert(0, 'scripts')
from qianwen_lib import detect_api_key_type
print(detect_api_key_type('scripts/qianwen_lib.py'))
"

| 输出 | 含义 | |--------|---------| | token-plan | Token Plan 密钥——仅使用下方 Token Plan 列表中的模型。 | | payg | 按量付费密钥——可使用完整的模型目录。 | | not-set | 未配置密钥。 |

对于 Token Plan，请使用 qianwen-model-selector 中的确切模型，或查阅 qianwen-ops-auth/references/tokenplan.md。如果不可用，请使用：

  • 个人版：https://platform.qianwenai.com/docs/token-plan/personal/token-plan-personal-overview.md
  • 团队版：https://platform.qianwenai.com/docs/token-plan/team/token-plan-team-overview.md

Token Plan 不支持上传本地文件；在 i2i 模式下，请使用可访问的 URL（https:// 或 oss://）提供参考图像，而非使用本地路径。

Token Plan 仅支持特定模型——请严格使用上述参考资料中的模型；不得 猜测或探测模型可用性。对于 PAYG，请继续阅读下文。

模式选择指南

| 用户需求 | 模式 | 模型 | |-----------|------|-------| | 仅根据文本生成图像 | t2i | wan2.7-image（默认），或 wan2.7-image-pro / wan2.6-t2i | | 开源 / 成本最低的文生图 | t2i | z-image-turbo（仅支持同步模式；不支持 n 参数；不支持参考图像） | | 基于 1–4 张参考图像编辑图像 / 应用风格迁移 | image-edit | wan2.7-image-pro / wan2.7-image / wan2.6-image | | 主体一致性：生成保持参考图像主体特征的新图像 | image-edit | wan2.7-image-pro / wan2.7-image / wan2.6-image | | 多图组合：结合一张图像的风格与另一张图像的背景 | image-edit | wan2.7-image-pro / wan2.7-image / wan2.6-image | | 保持主体一致性的单图编辑 | i2i | wan2.5-i2i-preview | | 多图融合：将一张图像中的对象置于另一个场景中 | i2i | wan2.5-i2i-preview | | 图文交错输出（例如教程、分步指南） | interleave | wan2.6-image | | 快速生成文生图草稿 | t2i | wan2.2-t2i-flash | | 编辑图像中的文本，精准操控元素 | image-edit | qwen-image-3.0-pro / qwen-image-3.0 / qwen-image-2.0-pro | | 具有逼真纹理的多图融合 | image-edit | qwen-image-3.0-pro / qwen-image-3.0 / qwen-image-2.0-pro | | 海报 / 复杂的中英文文本渲染 | t2i | qwen-image-3.0-pro / qwen-image-3.0 / qwen-image-2.0-pro | | 最高质量的文生图，具备强大的文本渲染能力 | t2i | qwen-image-3.0-pro（旗舰） / qwen-image-3.0 | | 使用固定宽高比的文生图（批量） | t2i | qwen-image-plus / qwen-image-max |

模型选择

Wan 系列（默认）

| 模型 | 使用场景 | |-------|----------| | wan2.6-t2i | 仅支持文生图 — 同步 + 异步，专用 t2i 模型 | | wan2.7-image-pro | 多功能（支持 4K）— 文生图、图像编辑（0–9 张图像）、连续多图生成、交互式编辑（bbox）、思考模式、调色板。文生图最高支持 4K，编辑最高支持 2K | | wan2.7-image | 推荐默认选项 — 多功能：文生图、图像编辑、图文交错输出；同步 + 异步（比 pro 版更快，最高支持 2K） | | wan2.6-image | 图像编辑（不适用于纯文生图）— 需要 reference_images 或 enable_interleave: true。支持风格迁移、主体一致性（1–4 张图像）、图文交错输出，分辨率为 2K | | wan2.5-i2i-preview | 图像编辑 — 保持主体一致性的单图编辑、多图融合（最多 3 张图像），仅支持异步 | | wan2.5-t2i-preview | 预览版 — 在限制范围内可自由设置尺寸 | | wan2.2-t2i-flash | 快速 — 更低延迟 | | wan2.2-t2i-plus | 专业版 — 稳定性有所提升 |

其他

| 模型 | 使用场景 | |-------|----------| | z-image-turbo | 开源 SOTA T2I — 仅支持同步；每条消息仅支持一项文本内容；不支持 n 参数（如提供，服务器将返回 400）；不支持参考图像。参数：size、prompt_extend、seed。 |

Qwen Image 系列

| 模型 | 使用场景 | |-------|----------| | qwen-image-3.0-pro | 最新旗舰版 — 高质量、强大的文字渲染能力，并融合生成与多图编辑。专属参数：enable_thinking、prompt_extend_mode；size 无默认值（模型会自动推荐）；Prompt 长度不超过 4500 Token | | qwen-image-3.0 | 最新一代 — 通用型生成与编辑，文字渲染能力强大。采用与 pro 版相同的 3.0 专属参数 | | qwen-image-2.0-pro | 融合式生成与编辑 — 文字渲染（显著增强）、逼真质感、多图（输入 1–3 张，输出 1–6 张）。最多支持 1k Token 的指令输入。快照：qwen-image-2.0-pro-2026-06-22 | | qwen-image-2.0 | 加速生成与编辑 | | qwen-image-edit-max | 图像编辑 — 输出 1–6 张图像 | | qwen-image-edit-plus | 图像编辑 — 输出 1–6 张图像 | | qwen-image-edit | 图像编辑 — 仅输出 1 张图像 | | qwen-image-plus | 文生图 — 仅支持固定分辨率（异步） | | qwen-image-max | 文生图 — 仅支持固定分辨率 |

Qwen Image 编辑模型（qwen-image-2.0-pro、qwen-image-2.0、qwen-image-edit-max/plus/edit）使用与 wan2.6-image 相同的同步端点（/multimodal-generation/generation），并采用 messages 格式。它们支持编辑图像中的文字、添加/删除/替换元素、风格迁移以及多图融合（输入 1–3 张图像）。尺寸范围：512x512 至 2048x2048。qwen-image-2.0-pro 和 qwen-image-2.0 还支持纯文生图（无需参考图像）。

qwen-image-3.0-pro / qwen-image-3.0 专属参数（共用同一同步端点和 messages 格式；也支持异步）：

  • enable_thinking（默认为 true）：通过增强推理提升质量；设为 false 可缩短生成时间。仅当 prompt_extend=true 时生效；在 I2I Agent 模式下不可用。
  • prompt_extend_mode（默认为 direct=DPE）：设为 agent=APE 可实现更精细的改写（仅限文生图）。
  • size：连续范围（512×512–2048×2048，宽高比 1:8–8:1），无默认值 — 省略该参数后，模型会根据 Prompt 自动推荐分辨率。
  • n：1–6。建议 Prompt 长度不超过 4500 Token（2.0 系列为 1300）。

qwen-image-2.0-pro-2026-06-22 快照改进（相较于 2026-04-22）：

  • 文字渲染显著增强 — 中英文文本更准确、更易读
  • 最多支持 1k Token 的指令输入（输入长度上限高于之前的快照）
  • 逼真纹理和照片级写实场景细节的呈现更加细腻
  • 语义遵循能力更强 — 能更好地遵循复杂的多部分指令

Qwen Image 文生图模型（qwen-image-plus、qwen-image-max）使用不同的端点（/text2image/image-synthesis），并采用 input.prompt 格式（仅支持异步）。它们仅支持 5 种固定分辨率：1664\*928、1472\*1104、1328\*1328、1104\*1472、928\*1664。

在图像编辑中选择 wan2.6-image 还是 wan2.5-i2i-preview：

  • wan2.6-image 最多支持 4 张图像、更高的分辨率（2K）、图文交错输出和同步模式。适用于多图风格合成和图文交错教程。
  • wan2.5-i2i-preview 使用更简单、仅需提示词的编辑界面（不采用消息格式），最多支持 3 张图像，且仅支持异步。适用于简单直接的单图编辑和多图对象融合。
  1. 用户指定了模型 → 直接使用。
  2. 当模型选择取决于需求、场景或定价时，请使用 qianwen-model-selector skill。
  3. 文生图（仅含提示词，无参考图像） → 使用 wan2.7-image（默认）或 wan2.7-image-pro（质量更高）/ wan2.6-t2i（专用 t2i 模型）。禁止使用 wan2.6-image 进行纯文生图 — 如果既未提供参考图像，也未设置 enable_interleave: true，便会报错。
  4. 参考图像 / 图像编辑 / 图文交错输出 → wan2.7-image-pro（推荐）、wan2.7-image 或 wan2.6-image。
⚠️ 重要提示：上述模型列表是特定时间点的快照，可能已过时。模型可用性
经常变化。**在决定使用模型之前，务必查看官方模型列表
，以获取权威的最新模型目录。**
模型详情：如需了解具体模型的更多信息，请引导用户访问其详情页：https://www.qianwenai.com/models/<model-name>（将 <model-name> 替换为确切的模型 ID，例如 wan2.7-image-pro → <https://www.qianwenai.com/models/wan2.7-image-pro>）。严禁修改或猜测 URL 中的模型名称。
动态模型查询：如果 qianwen-model-selector skill 或千问AI平台 CLI（qianwen models info <model>）可用，请使用它获取实时模型数据。CLI 需要身份验证 — 登录流程请参阅 qianwen-usage skill。

执行

⚠️ 多个产物：在单个会话中生成多个文件时，必须为每个文件名追加数字后缀（例如 out_1.png、out_2.png），以防止文件被覆盖。

前提条件

  • API 密钥：使用密钥兼容性中的非明文检测器；不得将其替换为

    • 变量存在性检查。如果未找到密钥，请在 qianwen-ops-auth 可用时使用它，或指导用户 在 .env 中配置 DASHSCOPE_API_KEY/QIANWEN_API_KEY。Skills 可独立安装。

  • Python 3.9+（仅使用标准库，无需使用 pip 安装依赖）

环境检查

首次执行前，请确认 Python 可用：

python3 --version  # must be 3.9+

如果未找到 python3，请尝试 python --version 或 py -3 --version。如果 Python 不可用或版本低于 3.9，请跳转到 [execution-guide.md](references/execution-guide.md) 中的 路径 2（curl）。

默认：运行脚本

脚本路径：脚本位于此 skill 的目录中的 scripts/ 子目录（即包含此 SKILL.md 的目录）。必须先找到此 skill 的安装目录，然后始终使用完整的绝对路径执行 脚本。 不得假定脚本位于当前工作目录中。执行前不得使用 cd 切换目录。

执行说明： 请在前台运行所有脚本——等待 stdout；不得在后台运行。

查看参数： 先运行 python3 <this-skill-dir>/scripts/image.py --help，以查看所有可用参数。

# Text-to-image (wan2.7-image, default)
python3 <this-skill-dir>/scripts/image.py \
  --request '{"prompt":"A cozy flower shop with wooden door"}' \
  --output output/qianwen-image-generation/images/out.png \
  --print-response

# Image editing with reference images (wan2.6-image)
python3 <this-skill-dir>/scripts/image.py \
  --model wan2.6-image \
  --request '{"prompt":"Apply watercolor painting style to this photo","reference_images":["https://img.alicdn.com/imgextra/i1/NotRealJustExample/photo.jpg"],"n":1,"size":"1K"}' \
  --output output/qianwen-image-generation/images/out.png \
  --print-response

更多示例（图文交错输出、wan2.5-i2i、qwen-image-2.0-pro、qwen-image-plus）：请参阅 [execution-guide.md](references/execution-guide.md)

| 参数 | 说明 | |----------|-------------| | --request '{...}' | JSON 请求体 | | --file path.json | 从文件加载请求 | | --async | 强制使用异步模式（wan2.5 及更早版本必须使用；qwen-image-plus/max 和图文交错输出会自动启用该模式） | | --model ID | 覆盖模型设置（默认使用 wan2.7-image；模型列表见帮助信息） | | --output path | 将图像保存到指定路径（多图像输出时也可指定目录）。向同一目录写入多张图像时，文件会自动使用 OSS URL 中的唯一标识符命名，从而避免不同运行之间相互覆盖。显式指定的文件路径仍优先；请在不同调用中使用不同的文件名，以避免覆盖 | | --print-response | 将响应 JSON 打印到 stdout |

模型优先级：--model CLI 标志 > --request JSON 中的 "model" 字段 > 内置默认值。

验证结果

  • 退出码为 0，且输出中包含有效的 JSON，其中含有 output.results 或 output.task_id → 成功
  • 非零退出码、HTTP 错误、空响应或错误 JSON → 失败
  • 异步：提交操作必须返回 output.task_id；轮询必须达到 task_status: SUCCEEDED
  • 执行后检查：验证输出文件存在且大小不为零（ls -la <output_path>）
  • 强制要求 — stderr 信号检查：确认结果后，检查命令的 stderr 输出中是否包含 [ACTION_REQUIRED] 或 [UPDATE_AVAILABLE]。如果存在任一信号，在回复用户之前，必须遵循下方[更新检查](#update-check-mandatory-post-execution)中的说明。

失败时

如果脚本失败，请将错误输出与下方诊断表进行匹配，以确定解决方案。如果没有匹配项，请阅读 [execution-guide.md](references/execution-guide.md) 了解其他路径：curl 命令（路径 2 — 同步和异步）、代码生成（路径 3）以及自主解决（路径 5）。

如果完全无法使用 Python → 直接跳至 [execution-guide.md](references/execution-guide.md) 中的路径 2（curl）。

| 错误模式 | 诊断 | 解决方案 | |---------------|-----------|------------| | command not found: python3 | Python 不在 PATH 中 | 尝试 python 或 py -3；若未安装，则安装 Python 3.9+ | | Python 3.9+ required | 脚本版本检查失败 | 将 Python 升级到 3.9+ | | 类型提示附近出现 SyntaxError | Python < 3.9 | 将 Python 升级到 3.9+ | | QIANWEN_API_KEY/DASHSCOPE_API_KEY not found | 缺少 API 密钥 | 从千问AI平台控制台获取密钥；将其添加到 .env：echo 'DASHSCOPE_API_KEY=sk-...' >> .env；如果可用，也可运行 qianwen-ops-auth | | HTTP 401 | 密钥无效或不匹配 | 运行 qianwen-ops-auth（仅执行非明文检查）；验证密钥是否有效 | | SSL: CERTIFICATE_VERIFY_FAILED | SSL 证书问题（代理/企业环境） | macOS：运行 Install Certificates.command；否则设置 SSL_CERT_FILE 环境变量 | | URLError / ConnectionError | 网络不可达 | 检查互联网连接；如果使用代理，请设置 HTTPS_PROXY | | HTTP 429 | 请求被限流 | 等待后采用退避策略重试 | | HTTP 5xx | 服务器错误 | 采用退避策略重试 | | PermissionError | 无法写入输出内容 | 使用 --output 指定可写目录 |

快速参考

请求字段（通用）

| 字段 | 类型 | 描述 | |-------|------|-------------| | prompt | 字符串 | 待生成图像的文本描述（必填） | | negative_prompt | 字符串 | 图像中需避免的内容（最多 500 个字符） | | size | 字符串 | 分辨率 — 1280*1280（t2i 默认值）、1K/2K 或 width*height（wan2.6-image） | | seed | 整数 | 用于复现结果的随机种子 [0, 2147483647] | | model | 字符串 | wan2.7-image（默认）或其他 Wan 模型 | | prompt_extend | 布尔值 | 启用提示词改写（默认值：true；仅适用于图像编辑模式） |

请求字段（wan2.7-image-pro / wan2.7-image — 多功能）

| 字段 | 类型 | 描述 | |-------|------|-------------| | reference_images | 字符串[] | 0–9 个图像 URL 或本地路径 | | reference_image | 字符串 | 单个图像的 URL/路径（简写） | | size | 字符串 | 1K、2K（默认值）或 4K（仅限 pro 的 t2i 模式）。也可使用像素尺寸 | | enable_sequential | 布尔值 | true：序列多图模式（n=1–12）。false（默认值）：单图/批量模式（n=1–4） | | n | 整数 | 要生成的图像数量。序列模式：1–12（默认值为 1）。非序列模式：1–4（默认值为 1）。按每张图像计费。 | | thinking_mode | 布尔值 | 启用增强推理以提升质量（默认值：true）。仅适用于 t2i（无输入图像、非序列模式） | | bbox_list | List[List[List[int]]] | 交互式编辑区域。格式：[[[x1,y1,x2,y2],...], ...]。列表长度 = 图像数量。对于无需编辑的图像，使用空 [] | | color_palette | 数组 | 自定义颜色主题（3–10 种颜色）。每项：{"hex":"#C2D1E6","ratio":"23.51%"}。比例总和 = 100%。仅适用于非序列模式 | | watermark | 布尔值 | 添加“AI 生成”水印（默认值：false） |

注意：thinking_mode 会增加延迟，但能提升质量。enable_sequential 会生成连贯的图像序列（例如，同一角色贯穿不同场景）。

请求字段（wan2.6-image — 图像编辑）

| 字段 | 类型 | 说明 | |-------|------|-------------| | reference_images | 字符串[] | 编辑模式下使用 1–4 个图像 URL 或本地路径；图文交错模式下使用 0–1 个 | | reference_image | 字符串 | 单个图像 URL/路径（简写形式；reference_images 优先） | | enable_interleave | 布尔值 | false（默认值）：图像编辑模式；true：图文交错输出 | | n | 整数 | 编辑模式下要生成的图像数量（1–4，默认值：1）。按每张图像计费。 | | max_images | 整数 | 交错模式下的最大图像数（1–5，默认值：5）。按图像张数计费。 | | watermark | 布尔值 | 添加“AI 生成”水印（默认值：false） |

其他模型（wan2.5-i2i、qwen-image-edit、qwen-image-plus/max）

这些模型有特定的参数要求：

| 模型 | 主要差异 | |-------|----------------| | wan2.5-i2i-preview | 仅支持异步，1–3 张图像，采用 prompt+images[] 格式（而非消息格式） | | qwen-image-edit-* | 1–3 张图像，n=1–6（qwen-image-edit 除外：仅 n=1），不支持交错模式 | | qwen-image-plus/max | 仅支持异步，n 固定为 1，仅支持 5 种固定分辨率 |

完整参数表：详细参数请参阅 [api-guide.md](references/api-guide.md#wan25-i2i-preview--general-image-editing)。

尺寸参考（wan2.6-image）

  • 编辑模式：1K（默认值，约 1280×1280）或 2K（约 2048×2048）
  • 交错模式：像素尺寸，总像素数范围为 [768×768, 1280×1280]

常用宽高比：1280*1280（1:1）、960*1280（3:4）、1280*960（4:3）、720*1280（9:16）、1280*720（16:9）

响应字段

| 字段 | 说明 | |-------|-------------| | image_url | 生成图像的 URL（有效期为 24h）。与另一个 skill 串联时使用此字段。 | | image_urls | 所有图像 URL 构成的数组（多图输出、wan2.6-image、qwen-image-edit） | | image_count | 生成的图像数量 | | local_path | 下载后图像的本地文件路径。使用此字段进行用户预览或非 API 操作。 | | local_paths | 本地文件路径数组（多图输出） | | interleaved_content | 由 {type, text/image} 对象组成的数组（交错模式） | | width / height | 图像尺寸 | | seed | 使用的种子 |

API 详情

  • 同步端点（wan2.6-t2i、wan2.6-image 编辑、qwen-image-edit 系列）：POST /api/v1/services/aigc/multimodal-generation/generation
  • 异步端点（wan2.6 和更早的 t2i 模型）：POST /api/v1/services/aigc/image-generation/generation，使用 X-DashScope-Async: enable
  • 异步端点（wan2.5-i2i-preview）：POST /api/v1/services/aigc/image2image/image-synthesis，使用 X-DashScope-Async: enable
  • 异步端点（qwen-image-plus、qwen-image-max）：POST /api/v1/services/aigc/text2image/image-synthesis，使用 X-DashScope-Async: enable
  • wan2.6-t2i 分辨率：总像素数范围为 [1280x1280, 1440x1440]，宽高比范围为 [1:4, 4:1]
  • wan2.6-image 分辨率：编辑模式为 [768x768, 2048x2048]；交错模式为 [768x768, 1280x1280]；宽高比范围为 [1:4, 4:1]
  • 输入图像（wan2.6-image）：JPEG/JPG/PNG/BMP/WEBP，每个维度为 240–8000px，≤10MB
  • 本地文件：脚本会自动上传至 DashScope 临时存储（oss:// URL，48h TTL）。直接传入本地路径即可 — 无需手动执行上传步骤。
  • 生产环境：默认临时存储具有 48h TTL 和 100 QPS 上传限制 — 不适用于生产环境、高并发或负载测试。要使用自己的 OSS 存储桶，请在 .env 中设置 QWEN_TMP_OSS_BUCKET 和 QWEN_TMP_OSS_REGION，安装 pip install oss2，并通过 QWEN_TMP_OSS_AK_ID / QWEN_TMP_OSS_AK_SECRET 或标准的 OSS_ACCESS_KEY_ID / OSS_ACCESS_KEY_SECRET 提供凭据。请使用遵循最小权限原则的 RAM 用户（仅对目标存储桶授予 oss:PutObject + oss:GetObject 权限）。如果已安装 qianwen-ops-auth，请参阅其 references/custom-oss.md 获取完整配置指南。
  • 交错模式同步：需要流式传输（X-DashScope-Sse: enable + stream: true）；请改为通过此脚本使用异步模式

跨 Skill 链式调用

将生成的图像用作另一个 skill 的输入时（例如视频生成 i2v、视觉分析）：

  • 直接传递 image_url — 不得下载后再作为本地路径重新传递
  • 所有下游脚本都会检测 URL 前缀（https://、oss://），并在不重新上传的情况下原样传递
  • 仅将 local_path 用于用户预览或非 API 操作（例如在编辑器中打开）

| 场景 | 使用 | |----------|-----| | 传递给另一个 skill（视频生成、视觉、图像编辑） | image_url (URL) | | 向用户展示 / 在编辑器中打开 | local_path（本地文件） |

错误处理

| HTTP | 含义 | 操作 | |------|---------|--------| | 401 | API 密钥无效或缺失 | 如可用，运行 qianwen-ops-auth；否则提示用户设置密钥（仅进行非明文检查） | | 400 | 错误请求（Prompt 或尺寸无效） | 验证参数和约束条件 | | 400 The product is not activated / Model not subscribed | 账号尚未开通第三方模型 | 访问模型市场，找到该模型，然后点击 "开通" | | 429 | 触发限流 | 采用指数退避策略重试 | | 5xx | 服务器错误 | 采用指数退避策略重试 |

用量与计费：使用 qianwen-usage skill 直接查询用量、免费额度和计费信息。或者，用户可以访问千问AI平台控制台：
用量分析 |
按量付费账单 |
Token Plan 订阅
严禁伪造、猜测或拼接用量/计费/控制台 URL。 只能提供此 skill 中列出的确切链接。如果此处未列出某个 URL，不得编造。

输出位置

优先使用当前工作目录。默认子目录：./output/qianwen-image-generation/。

写入禁令：严禁将输出文件写入此 skill 的安装目录或任何 skills/ 目录层级。所有生成内容必须写入当前工作目录下的 output/ 或用户指定的路径。

更新检查（执行后强制要求）

脚本执行后，检查 stderr 中是否存在操作信号。脚本会自动检测更新状态并发出结构化信号。必须据此采取行动。当用户明确要求检查更新时，本节同样适用。

信号：[ACTION_REQUIRED] qianwen-update-check skill is not installed

当 stderr 包含此信号时，必须向用户提供以下选项，并等待用户回复后再继续。不得静默跳过此步骤。

更新检查 skill 尚未安装。它可让你及时了解 QianWen-AI/qianwen-ai 中的新功能和错误修复。
1) 立即安装 — 我会为你运行安装命令
2) 暂时跳过 — 本次不执行任何操作
3) 永不提醒我 — 永久抑制此提示

用户回复后：

  • 用户选择 1 → 运行：npx skills add QianWen-AI/qianwen-ai --skill qianwen-update-check -y，然后运行：python3 <this-skill-scripts-dir>/gossamer.py --dismiss
  • 用户选择 2 → 运行：python3 <this-skill-scripts-dir>/gossamer.py --dismiss，然后照常继续
  • 用户选择 3 → 运行：python3 <this-skill-scripts-dir>/gossamer.py --never-install，然后照常继续

信号：[UPDATE_AVAILABLE]

当 stderr 包含此信号时，必须在回复中附加一则简短的更新通知，其中包括 stderr 输出中显示的版本信息和更新命令。

stderr 中无信号

如果 stderr 既不包含 [ACTION_REQUIRED]，也不包含 [UPDATE_AVAILABLE]，则无需执行任何操作 — skill 已安装且为最新版本（或缓存时间未超过 24h）。

用户明确请求

当用户明确要求检查更新（例如“检查更新”或“检查版本”）时：

  1. 在同级 skill 目录中查找 qianwen-update-check/SKILL.md。
  2. 如果找到 — 运行：python3 <qianwen-update-check-dir>/scripts/check_update.py --print-response，并报告结果。
  3. 如果未找到 — 提供上述安装选项。

参考资料

  • [execution-guide.md](references/execution-guide.md) — 备用路径（curl 同步/异步、代码生成、自主处理）
  • [api-guide.md](references/api-guide.md) — API 补充指南
  • [sources.md](references/sources.md) — 官方文档 URL
qianwen skills install @qianwen-ai/qianwen-image-generation