mcpField
A
alicloud-ai-image-zimage-turbo

alicloud-ai-image-zimage-turbo

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

关于 alicloud-ai-image-zimage-turbo

这是一个通过 DashScope 多模态生成 API 使用 Z-Image Turbo 进行文生图的技能，适用于需要按提示词生成图像的用户。它提供请求参数、生成脚本及区域端点说明。

主要功能

  1. 01通过提示词生成图像
  2. 02可设置图像尺寸和种子
  3. 03支持提示词扩展选项
  4. 04提供本地图像生成脚本
  5. 05说明区域端点与输出格式

适用场景

  1. 01从文字描述生成图像
  2. 02指定尺寸生成适配用途的图片
  3. 03保存生成图片并查看 API 响应

安装

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

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

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

包含的文件

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

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

详细介绍

类别：provider

Model Studio Z-Image Turbo

通过 DashScope multimodal-generation 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/alicloud-ai-image-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/alicloud-ai-image-zimage-turbo
for f in skills/ai/image/alicloud-ai-image-zimage-turbo/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-ai-image-zimage-turbo/validate.txt

通过标准：命令退出码为 0，且已生成 output/alicloud-ai-image-zimage-turbo/validate.txt。

输出与证据

  • 将产物、命令输出和 API 响应摘要保存到 output/alicloud-ai-image-zimage-turbo/ 下。
  • 在证据文件中包含关键参数（区域/资源 ID/时间范围），以便复现。

工作流

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

参考资料

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

评论

支持 Markdown