File Upload API 2026: S3-Compatible SDK & Direct Cloudinary Alternative | ICBucket

// app/api/upload/route.ts
import { BucketClient } from "icpay-bucket"

const client = new BucketClient({
  apiKey: process.env.ICBUCKET_API_KEY, // Scoped API Key from icpay.app
})

export async function POST(req: Request) {
  const formData = await req.formData()
  const file = formData.get("file") as File

  if (!file) {
    return Response.json({ error: "No file provided" }, { status: 400 })
  }

  const bytes = new Uint8Array(await file.arrayBuffer())

  // Upload to on-chain ICBucket
  const result = await client.uploadFile({
    bucketId: "production-uploads",
    path: `/documents/${Date.now()}-${file.name}`,
    data: bytes,
    contentType: file.type || "application/octet-stream",
  })

  if ("err" in result) {
    return Response.json({ error: result.err }, { status: 500 })
  }

  // Instant public CDN delivery URL:
  const publicUrl = client.publicUrl("production-uploads", result.ok.path)

  return Response.json({
    success: true,
    path: result.ok.path,
    url: publicUrl, // https://cdn.icpay.app/production-uploads/documents/...
  })
}

import os
from icpay_bucket import BucketClient

client = BucketClient(api_key=os.environ["ICBUCKET_API_KEY"])

# Uploading a document
with open("contract.pdf", "rb") as f:
    data = f.read()

result = client.upload_file(
    bucket_id="legal-docs",
    path="/contracts/2026/nda.pdf",
    data=data,
    content_type="application/pdf",
)

if "ok" in result:
    print("Uploaded successfully:", result["ok"])
    print("Public CDN URL:", client.public_url("legal-docs", "/contracts/2026/nda.pdf"))
else:
    print("Upload failed:", result["err"])