API Reference

Authentication

All requests require an API key passed via the X-API-Key header.

curl -X GET https://glamzn.ai/api/glamzn/me \
  -H "X-API-Key: your_api_key"

Response Format

File conversion endpoints return a JSON object with a base64-encoded file field.

{
  "success": true,
  "filename": "document.docx",
  "mime_type": "application/...",
  "file": "UEsDBBQAAAAI..."
}

{
  "success": false,
  "error": "Monthly limit reached",
  "code": "LIMIT_REACHED",
  "usage": 10,
  "limit": 10
}

Error Codes

Returns the authenticated user profile and subscription info.

curl -X GET https://glamzn.ai/api/glamzn/me \
  -H "X-API-Key: your_api_key"

Convert a PDF file to Word (.docx) format.

curl -X POST https://glamzn.ai/api/glamzn/pdf/to-word \
  -H "X-API-Key: your_api_key" \
  -F "file=@document.pdf"

Convert a PDF file to Excel (.xlsx) format.

curl -X POST https://glamzn.ai/api/glamzn/pdf/to-excel \
  -H "X-API-Key: your_api_key" \
  -F "file=@document.pdf" -F "pages=all"

Convert PDF pages to images (PNG, JPG, WebP).

curl -X POST https://glamzn.ai/api/glamzn/pdf/to-image \
  -H "X-API-Key: your_api_key" \
  -F "file=@document.pdf" -F "format=png" -F "dpi=150"

Convert a PDF file to PowerPoint (.pptx) format.

curl -X POST https://glamzn.ai/api/glamzn/pdf/to-powerpoint \
  -H "X-API-Key: your_api_key" -F "file=@document.pdf"

Convert a Word document (.docx/.doc) to PDF.

curl -X POST https://glamzn.ai/api/glamzn/word/to-pdf \
  -H "X-API-Key: your_api_key" -F "file=@document.docx"

Convert an Excel spreadsheet (.xlsx/.xls) to PDF.

curl -X POST https://glamzn.ai/api/glamzn/excel/to-pdf \
  -H "X-API-Key: your_api_key" -F "file=@spreadsheet.xlsx"

Convert one or more images to a single PDF.

curl -X POST https://glamzn.ai/api/glamzn/image/to-pdf \
  -H "X-API-Key: your_api_key" \
  -F "files[]=@page1.png" -F "files[]=@page2.png"

Compress a PDF to reduce file size.

curl -X POST https://glamzn.ai/api/glamzn/pdf/compress \
  -H "X-API-Key: your_api_key" \
  -F "file=@document.pdf" -F "level=medium"

Merge multiple PDF files into one.

curl -X POST https://glamzn.ai/api/glamzn/pdf/merge \
  -H "X-API-Key: your_api_key" \
  -F "files[]=@doc1.pdf" -F "files[]=@doc2.pdf"

Split a PDF into multiple files.

curl -X POST https://glamzn.ai/api/glamzn/pdf/split \
  -H "X-API-Key: your_api_key" \
  -F "file=@document.pdf" -F "ranges=1-3,4-6"

Rotate pages of a PDF.

Add a text watermark to a PDF.

Password-protect a PDF.

Run OCR on a scanned PDF to make it searchable.

Add page numbers to a PDF.

Edit a PDF: add text, signatures, images, delete pages, rotate, or redact.

Response: 202 Accepted — async, poll /documents/{documentId}/status

Upload a PDF and automatically start AI analysis. Accepts files up to 32 MB.

{
  "success": true,
  "document_id": 123,
  "name": "contract.pdf",
  "size": 204800,
  "analysis_status": "pending",
  "status_url": "/api/glamzn/documents/123/status"
}

// PDF_LOCKED
{ "success": false, "error_code": "PDF_LOCKED" }

// PAGE_LIMIT_EXCEEDED
{
  "success": false,
  "error_code": "PAGE_LIMIT_EXCEEDED",
  "details": { "page_count": 250, "page_limit": 100 }
}

Response: 200 OK

Poll the analysis status. When analysis_status is completed, the full analysis object is included.

{
  "document_id": 123,
  "analysis_status": "processing",
  "progress_step": "Extracting text",
  "progress_step_detail": "Page 12 / 45",
  "total_pages": 45,
  "analysis": null
}

{
  "document_id": 123,
  "analysis_status": "completed",
  "total_pages": 45,
  "analysis": {
    "summary": "...",
    "key_points": [...]
  }
}

Response: 200 OK — requires analysis_status = completed

Returns the AI-generated summary and suggested questions. Questions can be passed directly to the chat endpoint.

{
  "document_id": 36,
  "summary": "Ce document est un contrat...",
  "suggested_questions": [
    "Quelles sont les obligations ?",
    "Quelle est la durée du contrat ?"
  ],
  "chat_url": "/api/glamzn/documents/36/chat"
}

{
  "success": false,
  "code": "ANALYSIS_NOT_READY",
  "analysis_status": "processing",
  "poll_url": "/api/glamzn/documents/36/status"
}

Response: 200 OK — synchronous, requires analysis_status = completed

Send a question to the AI about the analyzed PDF. Conversation history maintained per document — no session ID needed.

{
  "success": true,
  "answer": "According to section 3...",
  "document_id": 36
}

{
  "success": false,
  "code": "ANALYSIS_NOT_READY",
  "analysis_status": "processing"
}

Response: 200 OK — starts async generation, poll /documents/content/{contentId}/status

Generate a structured document (book, report, or flashcard set) from an analyzed PDF.

Response: 200 OK

Poll the generation status. When status is completed, includes download_url (book/report) or flashcard_data JSON.

{
  "content_id": 42,
  "status": "generating",
  "progress": 65,
  "current_step": "Writing section 3/5"
}

{
  "content_id": 42,
  "status": "completed",
  "progress": 100,
  "download_url": "/api/glamzn/documents/content/42/download"
}

Response: 200 OK

Get a temporary pre-signed S3 URL (valid 1 hour) to download a completed book or report. Not applicable for flashcards — use the /status endpoint instead.

{
  "success": true,
  "download_url": "https://s3.amazonaws.com/.../report_42.pdf?X-Amz-Expires=3600&...",
  "filename": "Executive_Summary.pdf",
  "expires_at": "2025-01-01T11:30:00Z"
}

Response: 202 Accepted — async, poll /documents/{documentId}/status

Re-trigger AI analysis without re-uploading. Resets analysis_status to pending and clears the previous summary.

{
  "success": true,
  "document_id": 36,
  "analysis_status": "pending",
  "poll_url": "/api/glamzn/documents/36/status",
  "message": "Re-analysis started."
}

Response: 200 OK

List all documents belonging to the authenticated user, ordered by most recent.

{
  "success": true,
  "count": 2,
  "documents": [{
    "id": 123,
    "name": "contract.pdf",
    "analysis_status": "completed",
    "created_at": "2025-01-01T10:00:00Z"
  }]
}

Response: 200 OK

Permanently delete a document and its file from storage. This action is irreversible.

{ "success": true, "message": "Document deleted successfully" }

Response: 200 OK — synchronous

Generate an image from a text prompt using FAL.ai.

Response: 200 OK — synchronous (may take several minutes)

Generate a short video from a text prompt.

Response: 202 Accepted — async, poll /studio/film-maker/status/{jobId}

Generate a cinematic film from a script or prompt.

{
  "success": true,
  "job_id": "vmax_abc123",
  "poll_url": "/api/glamzn/studio/film-maker/status/vmax_abc123",
  "status": "queued"
}

Response: 200 OK

{ "status": "processing", "progress": 45 }

{
  "status": "completed",
  "video_url": "https://s3.amazonaws.com/..."
}

Response: 202 Accepted — async, poll /studio/long-to-shorts/status/{jobId}

Convert a long video (YouTube URL or direct upload) into short-form clips.

Response: 200 OK

{
  "status": "processing", "progress": 60,
  "current_step": "Generating subtitles"
}

{
  "status": "completed", "shorts_count": 4,
  "shorts": [{ "id": 1, "video_url": "...", "duration": 58 }]
}

Response: 200 OK — synchronous

Generate a Twitter/X thread or LinkedIn post from a topic.

Response: 200 OK — synchronous (30–60s typical)

Generate a high-impact thumbnail using FAL.ai. Optionally insert up to 2 face images.

{
  "success": true,
  "url": "https://s3.amazonaws.com/.../thumbnail_42.png",
  "media_id": 87,
  "message": "Thumbnail generated successfully"
}