Picture to Excel Pixel Art API

Convert any image into an Excel (.xlsx) file where the image is recreated as colored pixel-art cells. Upload a photo and get back a spreadsheet you can zoom out to see the picture.

原始信息汇总

数据集名称

Picture to Excel Pixel Art API

概述

该API可将任意图片转换为Excel (.xlsx) 文件，图片在Excel中会被重建为彩色像素艺术单元格（pixel-art cells）。放大查看时，每个单元格的颜色对应原始图像的像素点。非常适合制作新颖礼物、十字绣/刺绣图案、课堂艺术项目等。

主要功能

• POST /convert：上传图片，返回.xlsx文件。
  • 请求参数（multipart/form-data）：
    • file（必填）：源图片文件（支持jpg/png/webp等格式）。
    • width（可选）：网格列数，高度按比例自动缩放，默认值：80。
    • cell_size（可选）：每个Excel单元格宽度（字符单位），默认值：2.2。
    • original（可选）：布尔值，设为true则使用图片原始像素分辨率（1单元格=1像素），默认值：false。
    • resolution（可选）：字符串，强制指定网格大小，格式如300x500，会覆盖width/original。
    • max_colors（可选）：整数，限制颜色数量（如256）以加快处理速度并减小文件大小。
  • 响应：二进制.xlsx文件（Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet）。
• GET /health：健康检查，返回{ "status": "ok" }。

错误状态码

• 400：文件缺失/为空、非有效图片，或无效的width/resolution。
• 413：请求的网格大小超过限制（400万单元格），需降低width/resolution或使用max_colors。
• 500：生成Excel文件时内部错误。

处理时间与限制

• 最大网格：400万单元格（width×计算高度，或resolution）。超出将返回413。
• 小型/中型网格（几百列以内）：1秒内返回。
• 大型网格（数万单元格）：通常几秒内完成。
• 超大网格（接近400万单元格，如original=true的高分辨率图片）：可能需数分钟，生成的.xlsx文件可达10-60 MB。建议为客户端请求设置至少5分钟的超时时间。
• max_colors（如：256）可显著加快大请求速度、缩小文件体积，推荐用于超过几十万单元格的请求。

提供商信息

• API创建者：The Api Guy Use
• 订阅量：1
• 分类：视觉识别（Visual Recognition）