运行时依赖
安装命令
点击复制技能文档
分类:提供商 Model Studio Z-Image Turbo 使用 Z-Image Turbo 通过 DashScope 多模态生成 API 进行快速文本到图像生成。 关键模型名称 仅使用此确切的模型字符串:z-image-turbo 前置条件 在环境中设置 DASHSCOPE_API_KEY,或将 dashscope_api_key 添加到 ~/.alibabacloud/credentials(环境变量优先)。 选择区域端点(北京或新加坡)。如果不确定,请选择最合理的区域或询问用户。 标准化接口(image.generate) 请求 prompt(字符串,必需) size(字符串,可选)例如 10241024 seed(整数,可选) prompt_extend(布尔,可选;默认 false) base_url(字符串,可选) 覆盖 API 端点 响应 image_url(字符串) width(整数) height(整数) prompt(字符串) rewritten_prompt(字符串,可选) reasoning(字符串,可选) request_id(字符串) 快速开始(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 大小注意事项 总像素必须在 512512 和 20482048 之间。 更喜欢常见的大小,如 10241024、1280720、1536864。 费用注意事项 prompt_extend=true 的费用高于 false。仅在需要重写提示时启用。 输出位置 默认输出:output/ai-image-zimage-turbo/images/ 使用 OUTPUT_DIR 覆盖基本目录。 验证 mkdir -p output/aliyun-zimage-turbo for f in skills/ai/image/aliyun-zimage-turbo/scripts/*.py; do python3 -m py_compile "$f" done echo "py_compile_ok" > output/aliyun-zimage-turbo/validate.txt 通过标准:命令退出 0 且 output/aliyun-zimage-turbo/validate.txt 被生成。 输出和证据 将工件、命令输出和 API 响应摘要保存在 output/aliyun-zimage-turbo/ 下。 在证据文件中包含关键参数(区域/资源 ID/时间范围)以实现可复现性。 工作流程 确认用户意图、区域、标识符以及操作是否为只读或可变。 首先运行一个最小的只读查询以验证连接性和权限。 使用显式参数和有界范围执行目标操作。 验证结果并保存输出/证据文件。 参考 references/api_reference.md 用于请求/响应模式和区域端点。 references/sources.md 用于官方文档。 GitHub CLI API