94 lines
3.2 KiB
Markdown
94 lines
3.2 KiB
Markdown
---
|
||
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 图片格式展示结果：``
|
||
2. 提供 CDN URL 供用户下载或分享
|
||
3. 提示用户可以继续上传其他图片进行转换
|
||
|
||
## 错误处理
|
||
|
||
- **上传失败**：确认本地文件路径是否正确，文件是否存在
|
||
- **DAG 提交失败**：检查 inputs 中 `ref_image` 是否为有效 URL
|
||
- **轮询超时**：图片生成通常需要 30–120 秒，建议继续等待后重试轮询
|
||
- **DAG 执行失败**：展示 `error_message`，建议用户更换图片或调整输入后重试
|
||
- **内容审核拦截**：`asset_outputs` 中 `status == "sensitive"` 时，提示图片内容不符合平台规范
|