API Reference

Luvia Pix API Documentation

Comprehensive endpoints reference, request payloads, authentication headers, and code examples.

Authentication

All API requests to https://api.luvia.page require a secret API Key passed via HTTP Authorization header:

Authorization: Bearer pix_live_YOUR_API_KEY

You can generate secret API keys in your Developer Dashboard.

POST /v1/convert

Convert a single image URL into a target format or compile into a PDF document.

Request Body (JSON)

{
  "url": "https://example.com/photo.heic",
  "to": "png",
  "quality": 90,
  "width": 1920,
  "height": 1080
}

Response (200 OK)

{
  "success": true,
  "url": "https://api.luvia.page/output/a1b2c3d4.png",
  "format": "png",
  "size_bytes": 452810,
  "duration_ms": 142
}
POST /v1/batch

Convert multiple image URLs into a combined PDF or ZIP archive.

Request Body (JSON)

{
  "urls": [
    "https://example.com/page1.jpg",
    "https://example.com/page2.heic"
  ],
  "to": "pdf",
  "title": "Document_Scan.pdf"
}
GET /v1/quota

Check your current monthly API request usage and remaining quota.

Response (200 OK)

{
  "tier": "STARTER",
  "limit": 10000,
  "used": 412,
  "remaining": 9588,
  "reset_at": 1782345600
}