BigImg API

자신의 코드에서 BigImg의 도구를 호출하세요. 대시보드에서 키를 발급받으세요 — 사용량은 해당 계정이 원래 가진 무료 월간 이미지, 크레딧, 플랜을 소비합니다. 별도의 API 전용 무료 티어는 없습니다.

인증

모든 요청에 키를 Bearer 토큰으로 담아 보내세요:

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은 임시 링크입니다(약 1시간 후 만료) — 계속 보관하려면 다운로드하거나 다시 호스팅하세요. via는 어떤 할당량을 사용했는지 알려줍니다: free_pool, credit, unlimited, share_bonus 중 하나입니다.

오류

상태 코드	의미
401	키가 없거나, 유효하지 않거나, 취소됨
400	잘못된 요청 (imageUrl 누락, scale 값 오류, 플랜 한도를 초과한 파일 크기)
403	유료 플랜이 필요한 기능 (무료 티어를 초과하는 배율/파일 크기)
429	할당량 소진 — 크레딧을 구매하거나 Unlimited를 구독하세요
502 / 504	상위 모델 오류 또는 타임아웃 — 재시도해도 안전합니다

더 많은 도구

현재는 /api/v1/upscale만 제공됩니다. 배경 제거, 워터마크 제거, 노이즈 제거, 보정 기능이 다음 차례입니다 — 어떤 것이 가장 먼저 필요한지 알려주세요.