Darkroom Upscaler API

Upscale images by 1-4x using high-quality resampling algorithms. Supports JPEG, PNG, WebP, TIFF, BMP.

原始信息汇总

数据集概述：Darkroom Upscaler API

基本信息

• 数据集名称：Darkroom Upscaler API
• 类别：视频，图片
• API 版本：2.0.0（当前版本）
• 创建者：Vinay Iyer
• 订阅人数：1 人

功能描述

该 API 通过高质量重采样算法将图像放大 1–4 倍。无需账户，无存储——图像在内存中处理并立即丢弃。支持 JPEG、PNG、WebP、TIFF、BMP 格式。最大输入尺寸为 3000×3000 像素，单文件最大 10 MB。最大输出尺寸为 6000×6000 像素（超出此限制的输入会在放大前自动缩小）。

端点列表

方法	路径	描述
POST	/upscale/base64	推荐 通过 JSON + base64 上传放大。可靠地通过 API 代理工作。
POST	/upscale	通过多部分上传放大。仅当客户端原生支持多部分时使用。
GET	/methods	列出可用的放大方法。
GET	/health	健康检查。

请求与参数

1. 推荐方式：POST /upscale/base64

• 请求格式：JSON
• 参数：

字段名	类型	必需	默认值	说明
file	string	是	—	图像的 URL 安全 base64 编码。支持 JPEG、PNG、WebP、TIFF、BMP。最大 10 MB，3000×3000 像素。
filename	string	否	image.jpg	决定输出格式，请设置扩展名以匹配图像（例如 photo.jpg、logo.png）。
scale	integer	否	2	放大倍数：1、2、3 或 4。
method	string	否	lanczos	放大方法，详见 /methods 端点。

• 重要提醒：必须使用 URL 安全的 base64 编码（RFC 4648 §5），将 + 替换为 -，/ 替换为 _。标准 base64 的 + 字符可能被某些 API 代理（包括 RapidAPI）静默丢弃，导致图像损坏。
• 响应：与输入格式相同的二进制图像。响应头包含 X-Original-Size（原始大小）、X-Upscaled-Size（放大后大小）和 X-Credits-Remaining（剩余积分）。
• 输出限制：最大输出尺寸为 6000×6000 像素，超出此范围的输入会自动缩小。

2. 备选方式：POST /upscale

• 请求格式：multipart/form-data
• 参数：

字段名	类型	必需	默认值	说明
file	binary	是	—	图像二进制文件。支持 JPEG、PNG、WebP、TIFF、BMP。最大 10 MB，3000×3000 像素。
scale	integer	否	2	放大倍数：1、2、3 或 4。
method	string	否	lanczos	放大方法，详见 /methods 端点。

• 响应：与输入格式相同的二进制图像。响应头包含 X-Original-Size、X-Upscaled-Size 和 X-Credits-Remaining。
• 输出限制：最大输出尺寸为 6000×6000 像素，超出此范围的输入会自动缩小。

错误代码

HTTP 状态码	含义
400	文件太大（>10 MB）或不支持的格式。
402	积分不足。
422	验证错误（例如放大倍数超出范围）。
503	服务器繁忙——请稍后重试。

隐私说明

所有处理均在内存中进行，不存储用户的图像。图像不会被保存、记录或共享。