---
name: minecraft-pixel-art
display-name-zh: 像素方块画
summary-cn: 图片一键转Minecraft像素方块画
summary-en: Convert images to Minecraft pixel art
version: 0.1.4
description: |
  将用户提供的图片转换为 Minecraft 像素风格图片（16x16 体素方块风格）。
  触发短语（中文）：Minecraft 像素画、MC 像素风格、把图片转成 Minecraft、帮我做 Minecraft 像素画、生成像素方块画、MC 风格图片。
  触发短语（英文）：minecraft pixel art、convert to minecraft style、make minecraft version、minecraft block art。
  dag_id: 17759317728971100
tags: [Image, Pixel-Art, Minecraft]
tags-cn: [图片, 像素画, 我的世界]
allowed-tools: hilo_tools_run_dag hilo_tools_query_dag_result hilo_tools_upload_to_cdn
exported-by: MiniMax-hub
---

# Minecraft 像素画生成

将任意图片转换为 Minecraft 风格的 16x16 体素像素画。

## DAG 信息

- dag_id: `17759317728971100`

## 输入参数

### 固定输入（内置在 DAG 中，用户无需提供）

- Minecraft 像素风格 prompt（16x16 体素方块、MC 方块色板、像素游戏截图风格）

### 可变输入（用户每次提供）

- `ref_image`: image — 用户提供的参考图片（本地文件路径或已有 URL），**必填**

## 输出资产 (asset_keys)

请求以下 asset_keys：

- `minecraft_pixel_art`: 最终生成的 Minecraft 像素风格图片（image）

## 执行流程

### STEP 1: 收集用户输入

向用户收集：
- 要转换的图片（本地文件路径）

若用户未提供图片，提示："请提供一张图片，我来帮你转换为 Minecraft 像素风格。"

### STEP 2: 上传图片到 CDN

调用 `hilo_tools_upload_to_cdn`，将用户图片上传并获取 CDN URL：

```
hilo_tools_upload_to_cdn(file_path=<用户本地图片路径>)
→ 返回：cdn_url
```

### STEP 3: 提交 DAG

调用 `hilo_tools_run_dag`：

- dag_id: `17759317728971100`
- inputs: `{ "ref_image": "<cdn_url>" }`
- asset_keys: `["minecraft_pixel_art"]`
- 返回：run_id

**重要：inputs 中每个参数都必须传递，可选参数无值时传空字符串 "" 占位。**

### STEP 4: 轮询结果

调用 `hilo_tools_query_dag_result(run_id)` 持续轮询：

- 轮询间隔：5–10 秒
- `running`：继续轮询，可告知用户"正在生成中，请稍候…"
- `succeeded`：从 `asset_outputs` 中找 `key == "minecraft_pixel_art"` 且 `status == "finished"` 的条目，取其 `url`
- `failed`：向用户报告 `error_message`，建议换一张图片重试

### STEP 5: 展示结果

生成成功后：
1. 以 Markdown 图片格式展示结果：`![Minecraft Pixel Art](<url>)`
2. 提供 CDN URL 供用户下载或分享
3. 提示用户可以继续上传其他图片进行转换

## 错误处理

- **上传失败**：确认本地文件路径是否正确，文件是否存在
- **DAG 提交失败**：检查 inputs 中 `ref_image` 是否为有效 URL
- **轮询超时**：图片生成通常需要 30–120 秒，建议继续等待后重试轮询
- **DAG 执行失败**：展示 `error_message`，建议用户更换图片或调整输入后重试
- **内容审核拦截**：`asset_outputs` 中 `status == "sensitive"` 时，提示图片内容不符合平台规范