Easy GIF to Sprites

Convert GIFs to sprite sheets or frames, and combine PNGs or sprite sheets back into animated GIFs. Background removal, custom grid layout, padding, dimension handling — all in one API.

原始信息汇总

Easy GIF to Sprites API 数据集概述

基本信息

• API 名称：Easy GIF to Sprites
• 类别：Video, Images
• 提供商：ClawStudio
• 订阅者数量：1
• 服务等级：100%
• 延迟：3123ms
• 测试通过率：100%
• 受欢迎度：9.1

定价计划

• BASIC：$0.00 / 月
• PRO：$10.00 / 月

核心功能

• 将 GIF 动画转换为游戏就绪的精灵图（PNG）或单独的帧（ZIP）。
• 支持自动背景移除。
• 无需图像编辑软件或手动逐帧提取。

目标用户

• 游戏开发者——为 Unity、Godot、Phaser 或任何引擎生成精灵图。
• 前端工程师——从任何 GIF 创建 CSS 精灵动画。
• 内容创作者——提取单独的帧用于编辑、缩略图或视频项目。
• 自动化管道——通过 REST API 将 GIF 到精灵转换集成到您的资产工作流程中。

端点详情

POST /to-spritesheet

将 GIF 转换为单个 PNG 精灵图，所有帧排列在网格中。

请求参数：

• file：要上传的 GIF 文件（与 url 二选一）。
• url：GIF 文件的公开可访问 URL（与 file 二选一）。
• columns：网格列数（可选，默认自动计算为最接近的平方数）。
• padding：帧之间的像素间隙（可选，默认 0）。
• remove_bg：是否移除背景（可选，默认 false）。
• bg_color：要移除的背景颜色（可选，默认 "auto" 或指定十六进制颜色）。
• tolerance：背景移除的颜色距离阈值 0–255（可选，默认 30）。

响应：

• 200 OK：image/png 格式的原始 PNG 二进制数据。

POST /to-frames

提取 GIF 的所有帧作为单独的 PNG，并打包在 ZIP 存档中返回。

请求参数：

• file：要上传的 GIF 文件（与 url 二选一）。
• url：GIF 文件的公开可访问 URL（与 file 二选一）。
• remove_bg：是否移除背景（可选，默认 false）。
• bg_color：要移除的背景颜色（可选，默认 "auto" 或指定十六进制颜色）。
• tolerance：背景移除的颜色距离阈值 0–255（可选，默认 30）。

响应：

• 200 OK：application/zip 格式的 ZIP 存档，包含按零填充索引命名的 PNG 文件（例如 frame_000.png）。

GET /health

服务健康检查，无需认证。

响应：

• { "status": "ok" }

输入选项

• 直接上传 GIF 文件（multipart/form-data）。
• 或提供公开可访问的 GIF URL。
• 文件大小限制：20 MB。
• 支持 GIF87a 和 GIF89a 格式。

背景移除功能

• 算法：使用从每个帧的四个角同时开始的泛洪填充算法。
• 颜色模式：
  • "auto"：采样四个角像素的 RGBA 值，如果所有角在 tolerance 范围内，则使用其平均值作为目标颜色。
  • 十六进制颜色：使用指定颜色作为所有帧的目标。
• 容差指南：
  • 0：仅精确颜色匹配。
  • 15–30：适用于干净的纯色背景（默认 30）。
  • 50–80：处理轻微渐变或压缩背景。
  • > 100：激进——可能移除接近背景颜色的前景像素。

认证

• Base URL：https://easy-gif-to-sprites.p.rapidapi.com
• 所有请求必须包含标准 RapidAPI 认证头：
  • X-RapidAPI-Key: YOUR_API_KEY
  • X-RapidAPI-Host: easy-gif-to-sprites.p.rapidapi.com

错误响应

所有错误响应遵循模式：{ "detail": "Human-readable error message" }

常见错误状态：

• 400 Bad Request：不是 GIF 文件；同时提供了 file 和 url；未提供 file 或 url；URL 不可访问或返回非 GIF；bg_color 不是 "auto" 或有效的 #RRGGBB 十六进制字符串。
• 413 Content Too Large：输入文件或 URL 下载超过 20 MB。
• 422 Unprocessable Entity：columns < 1；padding < 0；tolerance 超出 0–255。
• 500 Internal Server Error：意外的处理失败。

限制

• 最大输入大小：20 MB。
• 接受格式：仅 GIF（GIF87a 和 GIF89a）。
• URL 下载超时：10 秒。
• 最大请求超时：60 秒。

代码示例

提供 Python（requests）、JavaScript（fetch）和 PHP（cURL）的示例代码，演示如何使用端点。

可靠性

• 正确处理所有 GIF 处置方法和透明度——帧准确合成。
• 优雅处理截断或格式错误的 GIF，直到最后一个可读帧。
• 完全内存处理——服务器上不存储文件，无数据保留。

教程资源

• Spotlight：超簡易 GIF 轉 Spritesheet（中文教程）。
• Spotlight：Easy GIF to Sprites（英文教程）。