REST API • JSON Responses • Easy Integration

Powerful Image API

Integrate image hosting and conversion directly into your applications with our simple, powerful REST API. Fast, reliable, and developer-friendly.

View Documentation Quick Start

Your API Key

Sign in to get your API key and start integrating.

API Features

Everything you need to build amazing applications with images

Image Upload

Upload images via simple POST requests with support for multiple formats and automatic optimization.

Format Conversion

Convert images between JPG, PNG, and WEBP formats on-the-fly with quality control.

Fast CDN

Global content delivery network ensures your images are served quickly worldwide.

Getting Started

Start integrating nubloq API in just a few minutes

POST /api/v1/upload

Upload one or multiple images to nubloq. Returns direct URLs and metadata for each uploaded image.

Authentication
Headers 
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data
Request Example
cURL 
curl -X POST \
  'https://nubloq.co/api/v1/upload' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'images[]=@/path/to/image1.jpg' \
  -F 'images[]=@/path/to/image2.png'
Response Example
JSON 
{
  "success": true,
  "files": [
    {
      "id": "abc123def456",
      "original_name": "image1.jpg",
      "url": "https://nubloq.co/i/abc123def456.jpg",
      "size": 154293,
      "width": 1920,
      "height": 1080,
      "format": "JPEG"
    },
    {
      "id": "ghi789jkl012",
      "original_name": "image2.png", 
      "url": "https://nubloq.co/i/ghi789jkl012.png",
      "size": 254893,
      "width": 1200,
      "height": 800,
      "format": "PNG"
    }
  ]
}

API Documentation

Complete reference for all API endpoints and parameters

POST /api/v1/upload

Upload images to nubloq storage. Supports multiple files in one request.

Parameters
Parameter Type Required Description
images[] File[] Yes Array of image files to upload
format String No Convert to format: jpg, png, webp (default: original)
quality Number No Image quality 1-100 (default: 85)
POST /api/v1/convert

Convert existing images to different formats without re-uploading.

Parameters
Parameter Type Required Description
image_id String Yes ID of the image to convert
format String Yes Target format: jpg, png, webp
quality Number No Output quality 1-100 (default: 85)
GET /api/v1/images

List all images uploaded by the authenticated user with pagination.

Parameters
Parameter Type Required Description
page Number No Page number (default: 1)
limit Number No Items per page (default: 20, max: 100)
DELETE /api/v1/images/{id}

Delete a specific image by ID. This action cannot be undone.

Parameters
Parameter Type Required Description
id String Yes Image ID in URL path

Error Codes

Understand and handle API errors gracefully

HTTP Status Error Code Description
400 INVALID_REQUEST Malformed request or invalid parameters
401 UNAUTHORIZED Invalid or missing API key
403 FORBIDDEN API key valid but insufficient permissions
413 FILE_TOO_LARGE Uploaded file exceeds size limit
415 UNSUPPORTED_FORMAT Image format not supported
429 RATE_LIMITED Too many requests - rate limit exceeded
500 INTERNAL_ERROR Server error - please try again later