Skip to main content
POST
Upload Image
This is the upload path used by the InkyPump interface. It is not an open partner-storage API.

Form data

file
required
Valid image file, up to 5 MiB under the current allowlist.
string
required
Fresh Cloudflare Turnstile token. Tokens are single-use and expire.
string
required
Wallet context used for rate control.
boolean
First-party social-creator flow flag.

Response

The response also reports the selected storage path in X-InkyPump-Image-Storage.

Partner recommendation

Store the image in your own durable public HTTPS object storage, then pass that URL in CreateLaunchParams.imageUrl. Make it immutable or content-addressed, set a long cache lifetime, and keep it publicly readable. Contact InkyPump if you need first-party upload support for a partner origin. Do not reuse InkyPump’s Turnstile site flow or spoof its origin.

Limits and errors

The current route applies progressive IP limits and a wallet limit of three uploads per minute. It can return 400, 403, 429, or 500. A timeout-or-duplicate Turnstile result tells the client to request a new proof.