Build on PixelCore

1. Upload an image

Three steps: ask the API for a presigned URL, PUT bytes directly to R2, finalize the metadata.

# Step 1 - get a presigned URL
INIT=$(curl -X POST https://api.pixelcore.co.za/v1/upload/init \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileName": "cat.jpg",
    "contentType": "image/jpeg",
    "size": 248192,
    "isPublic": true,
    "tags": ["pets", "cute"]
  }')
CODE=$(echo "$INIT" | jq -r .code)
URL=$(echo "$INIT" | jq -r .uploadUrl)

# Step 2 - upload the bytes (browser does this automatically; here for scripts)
curl -X PUT "$URL" --data-binary @cat.jpg -H "Content-Type: image/jpeg"

# Step 3 - finalize
curl -X POST https://api.pixelcore.co.za/v1/upload/finalize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"code\":\"$CODE\"}"

# Share at https://pixelcore.co.za/p/$CODE

2. Save someone else's public upload to your library

One-shot clone - copies the bytes (or shares the Cloudflare Images / Stream asset) into a fresh row owned by you.

POST /v1/media/abc1234/clone
Authorization: Bearer YOUR_API_KEY

# Response: { "code": "xyz5678", "shareUrl": "https://pixelcore.co.za/p/xyz5678" }

3. Download from any URL via yt-dlp bridge

POST /v1/download/init
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "audioOnly": false,
  "isPublic": false
}

# Response: { "code": "abc1234", "status": "pending", "shareUrl": "..." }
# Poll /v1/download/jobs/abc1234 until status === 'done'