Eternal CDN API

Eternal CDN is a media delivery network. Upload images and videos once, then serve them fast and optimized from edge locations worldwide. On the fly image transforms (resize, crop, WebP and AVIF), automatic video transcoding to HLS, and edge caching are all built in, served over a global edge network with India points of presence.

Upload

POST /api/v1/upload

Upload a single file (image, video, or document).

curl -X POST https://eternalcdn.in/api/v1/upload \
  -H "X-API-Key: nxs_your_key_here" \
  -F "file=@photo.jpg" \
  -F "folder=/products"

Param	Type	Required	Description
file	File	Yes	The file to upload (multipart/form-data)
folder	String	No	Virtual folder path (default: /)
is_public	Boolean	No	Make file publicly accessible (default: true)

Response:

{
  "id": "58257a0e-a8c7-4b64-b09f-1c0e2c7a092e",
  "url": "https://eternalcdn.in/media/58257a0e-...",
  "thumbnail": "https://eternalcdn.in/media/58257a0e-...?w=300&h=300",
  "type": "image",
  "mime_type": "image/jpeg",
  "size": 245760,
  "width": 1920,
  "height": 1080,
  "original_name": "photo.jpg"
}

POST /api/v1/upload/bulk

Upload up to 20 files at once.

curl -X POST https://eternalcdn.in/api/v1/upload/bulk \
  -H "X-API-Key: nxs_your_key_here" \
  -F "files=@img1.jpg" \
  -F "files=@img2.jpg" \
  -F "folder=/gallery"

Serve Media

GET /media/:id

Serve a file. No authentication needed for public files. Supports on-the-fly image transforms via query params.

<!-- Original -->
<img src="https://eternalcdn.in/media/58257a0e-..." />

<!-- Resized 300x300 WebP -->
<img src="https://eternalcdn.in/media/58257a0e-...?w=300&h=300&format=webp" />

<!-- Width only, auto height, quality 60 -->
<img src="https://eternalcdn.in/media/58257a0e-...?w=500&q=60" />

<!-- AVIF format -->
<img src="https://eternalcdn.in/media/58257a0e-...?format=avif&q=70" />

Param	Type	Description
w	Number	Resize width (px)
h	Number	Resize height (px)
q	Number	Quality 1-100 (default: 80)
format	String	Output format: webp, avif, jpg, png (default: webp)
fit	String	Resize fit: cover, contain, fill, inside (default: cover)

File Management

GET /api/v1/files

List your files with pagination and filters.

curl https://eternalcdn.in/api/v1/files?type=image&folder=/products&page=1&limit=20 \
  -H "X-API-Key: nxs_your_key_here"

GET /api/v1/files/:id

Get file details.

DELETE /api/v1/files/:id

Delete a file and all its cached transforms.

curl -X DELETE https://eternalcdn.in/api/v1/files/58257a0e-... \
  -H "X-API-Key: nxs_your_key_here"

Usage Stats

GET /api/v1/usage

Get storage usage, file counts, and request stats for your API key.

{
  "api_key": "My App",
  "storage": { "used_mb": 1250, "limit_mb": 10240, "percent": 12 },
  "files": { "total": 342, "images": 310, "videos": 32 },
  "cache": { "size_mb": 85 },
  "requests": 15420
}

Integration Examples

Node.js / Express

const FormData = require('form-data');
const fs = require('fs');

async function uploadImage(filePath) {
  const form = new FormData();
  form.append('file', fs.createReadStream(filePath));
  form.append('folder', '/products');

  const res = await fetch('https://eternalcdn.in/api/v1/upload', {
    method: 'POST',
    headers: { 'X-API-Key': 'nxs_your_key_here' },
    body: form,
  });

  const data = await res.json();
  return data.url; // Use this URL in your app
}

React / Frontend

async function uploadFile(file) {
  const form = new FormData();
  form.append('file', file);

  const res = await fetch('https://eternalcdn.in/api/v1/upload', {
    method: 'POST',
    headers: { 'X-API-Key': 'nxs_your_key_here' },
    body: form,
  });

  const data = await res.json();
  return data.url;
}

// Usage in JSX
<img src={`${imageUrl}?w=400&format=webp`} />

HTML (Direct)

<!-- Original image -->
<img src="https://eternalcdn.in/media/FILE_ID" />

<!-- Optimized thumbnail -->
<img src="https://eternalcdn.in/media/FILE_ID?w=200&h=200&format=webp&q=75" />

<!-- Responsive with srcset -->
<img srcset="
  https://eternalcdn.in/media/FILE_ID?w=400&format=webp 400w,
  https://eternalcdn.in/media/FILE_ID?w=800&format=webp 800w,
  https://eternalcdn.in/media/FILE_ID?w=1200&format=webp 1200w
" sizes="(max-width: 600px) 400px, (max-width: 1000px) 800px, 1200px" />