用途：调用阿里云百炼（Model Studio）Qwen VL 系列模型，完成图像输入加文本输出的理解任务，例如图像问答、内容总结、关键信息提取与结构化抽取。
主要能力：支持 qwen3-vl-plus、qwen3-vl-flash，以及带 -latest 或日期快照的别名（如 qwen3-vl-plus-latest、qwen3-vl-plus-2025-12-19、qwen3-vl-flash-2026-01-22、qwen3-vl-flash-latest）；部分旧工作负载仍见 qwen-vl-max-latest、qwen-vl-plus-latest。输入可为 HTTPS URL、本地路径或 data: URL。支持 json_mode 与 JSON Schema 结构化抽取，可设 max_tokens、temperature、detail，并对 429/5xx 做重试。
使用方式：建议先创建虚拟环境并安装依赖：python3 -m venv .venv；. .venv/bin/activate；python -m pip install requests。配置 DASHSCOPE_API_KEY 环境变量，或在 ~/.alibabacloud/credentials 中添加 dashscope_api_key。快速调用示例：python skills/ai/multimodal/aliyun-qwen-vl/scripts/analyze_image.py --request '{"prompt":"Summarize the main content in this image","image":"https://example.com/demo.jpg"}' --print-response。也可直接用 cURL 调用 https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions。响应含 text、model 与 usage；可用 --output 保存结果，默认输出目录为 output/aliyun-qwen-vl/。校验命令：mkdir -p output/aliyun-qwen-vl 与 python -m py_compile ...，通过条件为命令退出码 0 且生成校验文件。
适用场景：图像问答、图片摘要、票据或表单字段抽取、需要 JSON 结构化结果的多模态任务。OCR 专用抽取建议使用 aliyun-qwen-ocr 技能。
限制：401/403 多为密钥缺失或权限问题；400 为请求结构或图像来源不合法；429 触发限流需退避重试；5xx 为后端临时问题。生产环境建议固定快照模型 ID，上传前压缩大图，并在提示词中明确字段、JSON 结构与语言约束。其他未在资料中说明的计费、配额与地域信息暂未提供。