For Developers

Generate Thousands of Personalized
Arabic Images via API

A single POST request returns a pixel-perfect image with accurate Arabic diacritics, RTL layout, and OpenType shaping. No headless browsers. No flaky screenshots.

One Endpoint. One Image.

Send a POST to /v1/render with your template ID and variables. Get back a ready-to-use image.

cURL

curl -X POST https://api.mirqam.net/v1/render \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_eid_greeting",
    "variables": { "name": "Ahmed" },
    "format": "png"
  }' --output card.png

Python

import requests

resp = requests.post(
    "https://api.mirqam.net/v1/render",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "template_id": "tpl_eid_greeting",
        "variables": {"name": "Ahmed"},
        "format": "png",
    },
)
with open("card.png", "wb") as f:
    f.write(resp.content)

Node.js

const resp = await fetch("https://api.mirqam.net/v1/render", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template_id: "tpl_eid_greeting",
    variables: { name: "Ahmed" },
    format: "png",
  }),
});
const buffer = Buffer.from(await resp.arrayBuffer());
fs.writeFileSync("card.png", buffer);

The Alternatives Break on Arabic

Puppeteer screenshots, Cloudinary overlays, and HTML-to-image tools all struggle with Arabic text. Diacritics get misplaced, RTL breaks, and OpenType features are ignored. Mirqam solves this at the rendering layer.

Common Failures

  • Puppeteer / Playwright — browser-dependent rendering, diacritics shift between versions
  • Cloudinary text overlays — no OpenType shaping, broken ligatures
  • HTML screenshots — inconsistent across OS/browser, slow cold starts
  • Canvas / Sharp — no GPOS/GSUB, manual positioning required

Built for Arabic. Built for Scale.

Arabic-First Rendering

Built for Arabic from day one. Full RTL, diacritics (tashkeel), and OpenType GPOS/GSUB support.

Deterministic Output

Same input always produces the exact same image. No browser variance, no flaky screenshots.

Fast Generation

Images rendered in under 1 second. No headless browsers, no cold starts.

Custom Fonts

Upload your own TTF/OTF fonts. Full control over typography and brand identity.

Simple REST API

Single POST endpoint. Send template ID + variables, get back an image. That's it.

Batch Processing

Generate hundreds of images programmatically. Perfect for certificates, greeting cards, and campaigns.

Numbers That Matter

< 1s

Response time per image

100%

Deterministic output

Full

Diacritics & OpenType support

Simple, Pay-Per-Image Pricing

0.2 SAR

per image via API

  • 100 free credits on sign-up
  • No monthly subscription
  • Pay only for what you generate
  • Volume discounts available

Frequently Asked Questions

What are the API rate limits?

The default rate limit is 60 requests per minute. Contact us if you need higher throughput for batch processing.

What image formats are supported?

The API returns PNG and JPG images. You can specify the format in the request body. PNG is the default.

How does Mirqam handle Arabic diacritics (tashkeel)?

Mirqam uses an Arabic-first rendering engine with full OpenType support. Diacritics are positioned correctly using GPOS/GSUB tables — no browser rendering involved.

How does authentication work?

You authenticate with an API key passed in the Authorization header as a Bearer token. Generate your key from the dashboard after signing up.

Are there official SDKs available?

We provide REST API documentation with examples in cURL, Python, and Node.js. Community SDKs are welcome — the API is a single POST endpoint.

Ready to Generate Arabic Images at Scale?

Sign up for 100 free credits. No credit card required. Start rendering in minutes.

Arabic Image Generation API — Personalized Images at Scale | Mirqam | مِرقم