BigImg API

在你自己的代码里调用 BigImg 的工具。在仪表盘生成一个密钥——调用消耗的是该账号本来就有的每月免费额度、积分或套餐,没有单独的 API 专属免费额度。

鉴权方式

每次请求都要带上你的密钥作为 Bearer token:

Authorization: Bearer bigimg_live_...

放大一张图片

POST https://bigimg.ai/api/v1/upscale

字段类型说明
imageUrlstring(必填)源图片的公开可访问 URL
scalenumber2、4、8 或 16。默认 2。8/16 需要付费套餐或积分。
imageTypestring"photo" 或 "anime"。默认 "photo"。
denoisestring"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 一个接口。去背景、去水印、降噪、增强都在计划中——告诉我们你最想先用到哪个。