Qwen Pixel Art保姆级教学如何导出JSON元数据尺寸/调色板/帧率等1. 前言为什么需要导出元数据像素艺术创作不仅仅是生成一张图片那么简单。在实际项目中我们经常需要记录和管理以下关键信息画布尺寸如16x16、32x32等使用的调色板颜色索引和RGB值动画帧率如果是动态像素图创作时间和作者信息Qwen Pixel Art镜像内置了元数据导出功能可以一键生成包含所有这些信息的JSON文件。这对于团队协作、版本管理和后续编辑都至关重要。2. 准备工作启动服务并生成像素图2.1 启动Docker容器如果你还没有运行服务使用以下命令启动docker run -d \ --name qwen-pixel-art \ --gpus all \ -p 7860:7860 \ -v /path/to/models:/root/ai-models \ qwen-pixel-art:latest等待3-5分钟模型加载完成后访问 http://localhost:78602.2 生成示例像素图在提示词输入框输入你的创作想法如a red dragon点击生成像素艺术按钮等待生成完成后你会看到预览图3. 导出JSON元数据的三种方法3.1 通过Web界面导出这是最简单的方法生成像素图后在结果区域找到导出按钮组点击导出JSON按钮浏览器会自动下载一个名为pixel_art_metadata.json的文件3.2 通过API获取元数据如果你需要编程方式获取数据可以使用REST APIimport requests response requests.post( http://localhost:7860/api/generate, json{prompt: a red dragon} ) # 获取生成的图片ID image_id response.json()[image_id] # 获取该图片的元数据 metadata requests.get( fhttp://localhost:7860/api/metadata/{image_id} ).json() print(metadata)3.3 从已保存图片读取元数据如果你已经保存了PNG图片元数据实际上存储在PNG文件的文本块中from PIL import Image import json img Image.open(pixel_art.png) metadata json.loads(img.text[Description]) print(metadata[palette]) # 查看调色板信息4. JSON元数据结构详解导出的JSON文件包含以下关键字段{ version: 1.0, image_id: a1b2c3d4, created_at: 2024-03-15T10:30:00Z, dimensions: { width: 32, height: 32, unit: pixels }, palette: [ {index: 0, hex: #FF0000, rgb: [255, 0, 0]}, {index: 1, hex: #00FF00, rgb: [0, 255, 0]} ], animation: { frames: 5, fps: 12, loop: true }, generation_params: { prompt: a red dragon, seed: 123456, steps: 30 } }4.1 关键字段说明dimensions图像的宽高尺寸单位永远是像素palette使用的颜色索引最多256色animation如果是动画包含帧数和帧率generation_params生成时使用的参数可用于复现5. 实际应用场景5.1 游戏开发中的使用将元数据导入游戏引擎如Unity/Godot// Unity示例代码 void LoadPixelArt(string jsonPath) { string jsonText File.ReadAllText(jsonPath); PixelArtData data JsonUtility.FromJsonPixelArtData(jsonText); texture new Texture2D(data.dimensions.width, data.dimensions.height); texture.filterMode FilterMode.Point; // 保持像素风格 }5.2 调色板共享与复用你可以将palette字段导出为各种格式# 导出为ASE调色板Photoshop可用 def save_ase(palette, filename): with open(filename, wb) as f: f.write(bASEF) # 文件头 # 写入颜色数据...5.3 批量处理与资产管理使用元数据批量重命名文件# 使用jq处理JSON并重命名文件 for file in *.json; do name$(jq -r .generation_params.prompt $file | tr _) mv ${file%.json}.png ${name}.png done6. 常见问题解答6.1 为什么我的JSON文件没有动画信息如果生成的图片是静态的animation字段会缺失。确保在生成时勾选了生成动画选项。6.2 如何修改已生成的元数据有两种方法直接编辑JSON文件后重新关联到图片通过API更新requests.put( http://localhost:7860/api/metadata/update, json{image_id: a1b2c3d4, palette: [...]} )6.3 元数据会影响图片质量吗不会。元数据是独立存储的附加信息不会修改像素数据本身。7. 总结与最佳实践通过本教程你应该已经掌握三种导出JSON元数据的方法元数据各字段的含义和作用实际项目中的应用技巧建议工作流程生成像素图 → 2. 导出JSON → 3. 版本控制管理 → 4. 团队共享使用记住定期备份你的元数据文件它们比图片本身更容易丢失获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。