Quickstart Guide

Picsha AI allows you to instantly upload, intelligently process, and deliver media around the globe using our edge network.

1. Get an API Key

To interact with the Delivery or Upload APIs programmatically, you'll need an API key.

1. Navigate to the API Keys tab in your dashboard.
2. Click Generate New Key.
3. Store this key securely. You will use it to authorize HTTP requests. (Note: Use your Publishable Key pk_live_... for frontend applications, and your Secret Key sk_live_... for backend operations).

2. Uploading an Image

For standard backend uploads, you can seamlessly push binary data to our tus resumable upload endpoints, or directly request a Signed S3 Upload URL using your Secret Key.

If you are using React, the easiest way is to use our SDK with your Publishable Key:

import { PicshaUploadWidget } from '@picsha-ai/react';

export default function MyUpload() {
  return (
    <PicshaUploadWidget 
      getToken={async () => "pk_live_your_publishable_key"}
      onUploadSuccess={(asset) => console.log('Upload finished:', asset.id)} 
    />
  )
}

3. Delivering the Image

Once uploaded, Picsha instantly encodes and distributes your media via CloudFront.

<img src="https://cdn.picsha.ai/render/550e8400-e29b-41d4-a716-446655440000?fit=cover&h=500&w=500" />

Any image parameters (h, w, fit) are automatically computed on the fly by our high-performance Sharp (libvips) image processors!

[!WARNING] By default, your assets are publicly deliverable. For production applications, we highly recommend enabling Strict Transformations in your organization settings. This requires cryptographic signatures (?sig=...) on your URLs, preventing malicious users from enumerating query strings or executing unauthorized generative AI edits on your assets.