API de BigImg

Llama a las herramientas de BigImg desde tu propio código. Obtén una clave desde tu panel — el uso cuenta contra las imágenes gratuitas mensuales, créditos o plan de esa cuenta. No hay un nivel gratuito exclusivo para la API.

Autenticación

Envía tu clave como token bearer en cada solicitud:

Authorization: Bearer bigimg_live_...

Escalar una imagen

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

Campo	Tipo	Descripción
`imageUrl`	string (obligatorio)	URL públicamente accesible de la imagen de origen
`scale`	number	2, 4, 8 o 16. Por defecto 2. 8/16 requieren un plan de pago o créditos.
`imageType`	string	"photo" o "anime". Por defecto "photo".
`denoise`	string	"none" \| "low" \| "mid" \| "high" \| "max". Por defecto "max".

Ejemplo

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
  }'

Respuesta

{
  "url": "https://replicate.delivery/.../output.png",
  "resizedTo": null,
  "via": "credit"
}

url es un enlace temporal (expira en aproximadamente una hora) — descárgalo o vuelve a alojarlo si necesitas conservarlo. via indica de qué cuota se descontó: free_pool, credit, unlimited o share_bonus.

Errores

Estado	Significado
401	Clave ausente, inválida o revocada
400	Solicitud incorrecta (falta imageUrl, scale inválido, archivo demasiado grande para tu plan)
403	La función requiere un plan de pago (escala/tamaño de archivo fuera del nivel gratuito)
429	Cuota agotada — compra créditos o suscríbete a Unlimited
502 / 504	Error del modelo o tiempo de espera agotado — puedes reintentar sin problema

Más herramientas

Por ahora solo está disponible /api/v1/upscale. Eliminar fondo, quitar marcas de agua, reducir ruido y mejorar son las próximas — avísanos cuál necesitas primero.