BigImg API
在你自己的代码里调用 BigImg 的工具。在仪表盘生成一个密钥——调用消耗的是该账号本来就有的每月免费额度、积分或套餐,没有单独的 API 专属免费额度。
鉴权方式
每次请求都要带上你的密钥作为 Bearer token:
Authorization: Bearer bigimg_live_...
放大一张图片
POST https://bigimg.ai/api/v1/upscale
| 字段 | 类型 | 说明 |
|---|---|---|
imageUrl | string(必填) | 源图片的公开可访问 URL |
scale | number | 2、4、8 或 16。默认 2。8/16 需要付费套餐或积分。 |
imageType | string | "photo" 或 "anime"。默认 "photo"。 |
denoise | string | "none" | "low" | "mid" | "high" | "max"。默认 "max"。 |
示例
curl https://bigimg.ai/api/v1/upscale \
-H "Authorization: Bearer bigimg_live_..." \
-H "Content-Type: application/json" \
-d '{
"imageUrl": "https://example.com/photo.jpg",
"scale": 4
}'返回结果
{
"url": "https://replicate.delivery/.../output.png",
"resizedTo": null,
"via": "credit"
}url 是一个临时链接(大约一小时后过期)——如果需要长期保留,请自行下载或转存。via 会告诉你这次调用消耗的是哪种额度:free_pool、credit、unlimited 或 share_bonus。
错误码
| 状态码 | 含义 |
|---|---|
| 401 | 密钥缺失、无效或已被撤销 |
| 400 | 请求参数有误(缺少 imageUrl、scale 不合法、文件大小超出你套餐的限制) |
| 403 | 该功能需要付费套餐(放大倍数或文件大小超出免费范围) |
| 429 | 额度已用完——购买积分或订阅 Unlimited |
| 502 / 504 | 上游模型出错或超时——可以直接重试 |
更多工具
目前只有 /api/v1/upscale 一个接口。去背景、去水印、降噪、增强都在计划中——告诉我们你最想先用到哪个。