SuperAPI AI 工具集

aliyun-qwen-image

设计与创作

查看项目

更新于 10-15 17:34

技能介绍

用途:该技能用于在 Model Studio(百炼)DashScope SDK 中调用 Qwen Image 系列图像生成模型,属于 provider 类能力,可标准化 image.generate 的输入输出,服务于视频智能体流水线等场景。

主要能力:支持提示词 prompt(必填)、负向提示词 negative_prompt、尺寸 size(WxH 格式,如 10241024、7681024)、风格 style、随机种子 seed 以及参考图 reference_image;返回 image_url、width、height、seed。可使用模型标识包括 qwen-image、qwen-image-plus、qwen-image-max、qwen-image-2.0、qwen-image-2.0-pro 等。

使用方式:先安装 SDK:python3 -m venv .venv,. .venv/bin/activate,python -m pip install dashscope。设置环境变量 DASHSCOPE_API_KEY,或在 ~/.alibabacloud/credentials 中配置 dashscope_api_key(环境变量优先)。Python 侧使用 from dashscope.aigc.image_generation import ImageGeneration,调用 ImageGeneration.call 传入 model、messages、size、api_key 等参数;qwen-image-max 目前通过 ImageGeneration(messages 形式)成功,而非 ImageSynthesis。预览可先下载再打开。

适用场景:需要按统一接口批量或流程化生成图片的场景,如视频智能体中的配图环节。输出默认写入 output/aliyun-qwen-image/images/,可用 OUTPUT_DIR 覆盖。

限制:negative_prompt、style、seed 为尽力而为参数,后端可能忽略;不支持或非法尺寸可能返回 400;401/403 通常为密钥缺失或无效,429 为限流,5xx 为临时错误,建议指数退避重试。不要自行编造模型名称或别名,仅使用官方模型 ID;避免在数据库中存储大体积 base64,应使用对象存储;长时间生成需向用户展示进度。缓存可以 (prompt, negative_prompt, size, seed, reference_image hash) 为键避免重复费用。