Build with the
PromptLens API

Base URL

https://promptlens.polsia.app/api/v1

All API endpoints are prefixed with /api/v1. All requests and responses use JSON unless you're uploading files (multipart/form-data).

Authentication

The PromptLens API uses Bearer token authentication. Include your API key in the Authorization header of every request.

Authorization: Bearer pl_your_api_key_here

Getting your API key

API keys are available on the Business tier ($99/mo). Once subscribed:

1. Log in to your PromptLens account
2. Go to Settings → API Keys
3. Click "Generate New Key"
4. Copy your key — it will only be shown once

Key format

All API keys follow the format pl_ followed by a 32-character random string (e.g., pl_4f8a9c2b7e1d3...). Keys are hashed server-side — only your prefix is stored in plaintext.

Quick Start

Analyze your first image in under 60 seconds. You only need your API key and an image file.

curl https://promptlens.polsia.app/api/v1/analyze \
  -H "Authorization: Bearer pl_your_api_key" \
  -F "image=@/path/to/photo.jpg" \
  -F "model=midjourney"

import requests

url = "https://promptlens.polsia.app/api/v1/analyze"
headers = {"Authorization": "Bearer pl_your_api_key"}

with open("photo.jpg", "rb") as f:
    response = requests.post(
        url,
        headers=headers,
        files={"image": f},
        data={"model": "midjourney"}
    )

result = response.json()
print(result["prompts"]["basic"])

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

const form = new FormData();
form.append('image', fs.createReadStream('photo.jpg'));
form.append('model', 'midjourney');

const res = await fetch('https://promptlens.polsia.app/api/v1/analyze', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer pl_your_api_key',
    ...form.getHeaders()
  },
  body: form
});

const data = await res.json();
console.log(data.prompts.basic);

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://promptlens.polsia.app/api/v1/analyze',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer pl_your_api_key'
    ],
    CURLOPT_POSTFIELDS => [
        'image' => new CURLFile('/path/to/photo.jpg'),
        'model' => 'midjourney'
    ]
]);

$response = curl_exec($curl);
$data = json_decode($response, true);
echo $data['prompts']['basic'];

{
  "success": true,
  "share_id": "abc123",
  "model": "midjourney",
  "prompts": {
    "basic": "a flat lay of a minimalist white ceramic mug on a marble surface, soft natural light, clean composition, product photography",
    "premium": "studio product photography, minimalist white ceramic mug, marble surface, soft diffused window light, shallow depth of field, high resolution, commercial quality --ar 4:3 --style raw --q 2",
    "detailed": "professional product photography, pristine white ceramic mug, white marble surface with subtle grey veining, studio lighting setup with soft box from camera left creating gentle shadow, no harsh reflections, f/8 aperture, macro lens, ultra sharp focus on mug handle --ar 4:3 --style raw --q 2 --v 6"
  },
  "analysis": {
    "primary_subject": "ceramic mug",
    "style": "product photography",
    "lighting": "soft natural window light",
    "mood": "clean, minimalist",
    "colors": ["white", "grey", "cream"]
  },
  "performance_score": 88,
  "image_width": 1200,
  "image_height": 900
}

API Reference

POST /analyze

Analyzes an image and returns AI-optimized prompts for the specified target model. This is the primary endpoint for the PromptLens API.

GET /models

Returns all supported AI models with their identifiers, descriptions, and parameter syntax.

curl https://promptlens.polsia.app/api/v1/models

{
  "models": [
    { "id": "midjourney",       "name": "Midjourney",         "params": "--ar --style --q --v" },
    { "id": "dalle",            "name": "DALL-E 3",           "params": "natural language" },
    { "id": "stable-diffusion", "name": "Stable Diffusion",  "params": "--cfg --steps --sampler" },
    { "id": "flux",             "name": "Flux",               "params": "aspect_ratio guidance" },
    { "id": "grok",             "name": "Grok Aurora",        "params": "natural language" },
    { "id": "ideogram",         "name": "Ideogram",           "params": "--style --magic" },
    { "id": "recraft",          "name": "Recraft V3",         "params": "style controls" }
  ]
}

GET /usage

Returns your current API usage statistics for the billing period, including remaining quota and per-day breakdown.

curl https://promptlens.polsia.app/api/v1/usage \
  -H "Authorization: Bearer pl_your_api_key"

{
  "tier": "business",
  "period": {
    "start": "2026-03-01",
    "end": "2026-03-31"
  },
  "usage": {
    "requests_this_period": 1247,
    "limit": 10000,
    "remaining": 8753,
    "percent_used": 12.47
  }
}

Rate Limits

PromptLens enforces rate limits at both the request level and the monthly quota level.

Rate limit headers are included in every response:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 8753
X-RateLimit-Reset: 1743465600

Error Codes

The API uses standard HTTP status codes. All error responses include a JSON body with an error string and human-readable message.

{
  "error": "invalid_model",
  "message": "Model must be one of: midjourney, dalle, stable-diffusion, flux, ..."
}

SDKs & Tools

OpenAPI Spec

Our full OpenAPI 3.0 specification is available at /openapi.json. Import it into Postman, Insomnia, or any OpenAPI-compatible tool to get auto-generated API clients.

# Download the spec
curl https://promptlens.polsia.app/openapi.json -o promptlens-api.json

# Or import the URL directly in Postman:
https://promptlens.polsia.app/openapi.json

Postman Collection

Prefer a pre-built collection? Download our Postman-compatible spec and import it under Import → OpenAPI. All endpoints, example values, and auth headers are pre-configured.

Zapier Integration

Connect PromptLens to 5,000+ apps without writing code. Trigger prompt generation from new Shopify products, Google Sheets rows, Airtable records, and more. Business tier required for API-based Zaps.

API Pricing

API access is included in the Business tier. There are no per-call charges — your subscription covers 10,000 requests per month.