SuperAPI AI 工具集

aliyun-zimage-turbo

设计与创作

查看项目

更新于 10-15 17:34

技能介绍

用途:通过 DashScope 多模态生成 API 使用阿里云百炼 Z-Image Turbo(模型名必须为 z-image-turbo)进行快速文生图。

主要能力:接受文本提示词生成图像,支持 size(如 10241024)、seed、prompt_extend(默认 false)及 base_url 覆盖;返回 image_url、width、height、prompt,可选 rewritten_prompt、reasoning、request_id。总像素须介于 512512 与 20482048 之间,推荐 10241024、1280720、1536864。

使用方式:先设置环境变量 DASHSCOPE_API_KEY,或在 ~/.alibabacloud/credentials 中配置 dashscope_api_key(环境变量优先);选择北京或新加坡地域端点,不确定时可询问用户。可用 curl 直接请求接口,例如: curl -sS 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' -H 'Content-Type: application/json' -H "Authorization: Bearer $DASHSCOPE_API_KEY" -d '{"model": "z-image-turbo", "input": {"messages": [{"role": "user", "content": [{"text": "A calm lake at dawn, a lone angler casting a line, cinematic lighting"}]}]}, "parameters": {"size": "10241024", "prompt_extend": false}}' 也可使用本地脚本:python skills/ai/image/aliyun-zimage-turbo/scripts/generate_image.py --request '{"prompt":"a fishing scene at dawn, cinematic, realistic","size":"10241024"}' --output output/ai-image-zimage-turbo/images/fishing.png --print-response

输出与验证:默认输出目录为 output/ai-image-zimage-turbo/images/,可通过 OUTPUT_DIR 覆盖。可运行验证命令检查脚本语法,通过标准为退出码 0 并生成 output/aliyun-zimage-turbo/validate.txt。建议将产物、命令输出与 API 响应摘要保存在 output/aliyun-zimage-turbo/ 下,并在证据文件中记录地域、资源 ID、时间范围等关键参数。

限制与注意:prompt_extend=true 计费高于 false,仅在需要改写提示词时启用。工作流建议先确认意图、地域、标识及操作是否只读,先执行一次最小只读查询验证连通性与权限,再以明确参数和有界范围执行目标操作并验证结果。请求/响应结构与各地域端点详见 references/api_reference.md,官方文档见 references/sources.md。其他细节暂未提供。