mcpField
A
aliyun-zimage-turbo

aliyun-zimage-turbo

github.com/cinience创意与媒体39661 次安装11 周前更新
代码仓库

关于 aliyun-zimage-turbo

aliyun-zimage-turbo 是面向图像生成任务的技能，通过 DashScope API 调用 Z-Image Turbo 将文本提示词生成图像。它提供标准化请求参数和本地辅助脚本。

主要功能

  1. 01通过提示词生成图像
  2. 02设置尺寸与随机种子
  3. 03可选扩展提示词
  4. 04使用本地脚本生成并保存图像

适用场景

  1. 01从文字描述生成图像
  2. 02指定画布尺寸生成图像

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-zimage-turbo

安装后在 Claude Code 中输入/aliyun-zimage-turbo确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
api_reference.md
sources.md
scripts/
generate_image.py

详细介绍

类别：提供方

Model Studio Z-Image Turbo

通过 DashScope 多模态生成 API 使用 Z-Image Turbo 快速生成文本图像。

关键模型名称

仅使用以下确切的模型字符串：

  • z-image-turbo

前提条件

  • 在环境中设置 DASHSCOPE_API_KEY，或将 dashscope_api_key 添加到 ~/.alibabacloud/credentials（环境变量优先）。
  • 选择区域端点（北京或新加坡）。如果不确定，请选择最合适的区域，或询问用户。

规范化接口（image.generate）

请求
  • prompt（字符串，必填）
  • size（字符串，可选），例如 1024*1024
  • 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": "1024*1024",
      "prompt_extend": false
    }
  }'

本地辅助脚本

python skills/ai/image/aliyun-zimage-turbo/scripts/generate_image.py \
  --request '{"prompt":"a fishing scene at dawn, cinematic, realistic","size":"1024*1024"}' \
  --output output/ai-image-zimage-turbo/images/fishing.png \
  --print-response

尺寸说明

  • 总像素数必须介于 512*512 和 2048*2048 之间。
  • 优先选择常见尺寸，例如 1024*1024、1280*720、1536*864。

费用说明

  • 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／时间范围），以便复现。

工作流

  1. 确认用户意图、区域、标识符，以及操作是只读还是会产生变更。
  2. 先运行一次最小化的只读查询，以验证连接和权限。
  3. 使用明确的参数和受限范围执行目标操作。
  4. 验证结果并保存输出／证据文件。

参考资料

  • references/api_reference.md：请求／响应架构和区域端点。
  • references/sources.md：官方文档。

评论

支持 Markdown