Authentication

Every request to the ImgNodus API (except guest upload) must include your API key. Your key authenticates you and ties usage to your account's plan.

API Key Header

Include your key in the X-API-Key or Authorization: Bearer header:

X-API-Key: IR_KEY_xxxxxxxxxxxxxxxxxx

# OR using Bearer
Authorization: Bearer IR_KEY_xxxxxxxxxxxxxxxxxxCopy

⚠️ Never expose your API key in client-side code. Use environment variables in your backend or server functions. Our React SDK handles this securely.

Where to Find Your Key

Log in to your Dashboard → Developer → API Keys. You can rotate or revoke keys at any time.

Example: cURL

curl -X GET https://imgnodus-api-411853553644.us-central1.run.app/v1/images \
  -H "X-API-Key: IR_KEY_xxxxxxxxxx"Copy

Example: JavaScript

const res = await fetch('https://imgnodus-api-411853553644.us-central1.run.app/v1/images', {
  headers: { 'X-API-Key': process.env.IMGNODUS_API_KEY }
});
const data = await res.json();Copy