BigImg API

自分のコードからBigImgのツールを呼び出せます。ダッシュボードでキーを発行——利用量はそのアカウントが元々持つ無料月間枚数・クレジット・プランを消費します。API専用の別枠の無料利用はありません。

認証

すべてのリクエストにキーをベアラートークンとして付与してください:

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 のみです。背景除去・透かし除去・ノイズ除去・補正は今後対応予定——どれを最初に必要としているか教えてください。