تجاوز إلى المحتوى الرئيسي

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.

Quick Start

One Endpoint. One Image.

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

cURL
curl --fail-with-body -sS -X POST "https://api.mirqam.net/v1/render" \
  -H "Authorization: Bearer ak_live_********" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tpl_eid_greeting",
    "data": { "name": "Ahmed" },
    "images": {},
    "options": { "format": "png" }
  }' \
  --output card.png
Python
import requests

response = requests.post(
    "https://api.mirqam.net/v1/render",
    headers={"Authorization": "Bearer ak_live_********"},
    json={
        "template_id": "tpl_eid_greeting",
        "data": {"name": "Ahmed"},
        "images": {},
        "options": {"format": "png"},
    },
)
response.raise_for_status()
with open("card.png", "wb") as output:
    output.write(response.content)
Node.js
import { writeFile } from "node:fs/promises";

const response = await fetch("https://api.mirqam.net/v1/render", {
  method: "POST",
  headers: {
    Authorization: "Bearer ak_live_********",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    template_id: "tpl_eid_greeting",
    data: { name: "Ahmed" },
    images: {},
    options: { format: "png" },
  }),
});
if (!response.ok) throw new Error("Render failed: " + response.status);
await writeFile("card.png", Buffer.from(await response.arrayBuffer()));

Why Mirqam?

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 / Playwrightbrowser-dependent rendering, diacritics shift between versions
  • Cloudinary text overlaysno OpenType shaping, broken ligatures
  • HTML screenshotsinconsistent across OS/browser, slow cold starts
  • Canvas / Sharpno GPOS/GSUB, manual positioning required

Features

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

One render endpoint. Send a template ID, data, images, and options; get back binary image bytes.

Batch Processing

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

Performance

Numbers That Matter

Response time per image
< 1s
Deterministic output
100%
Diacritics & OpenType support
Full

Pricing

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. Set the format under options.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?
Create an ak_ API key in the dashboard, then pass it in the Authorization header as a Bearer token.
Are there official SDKs available?
Yes. Mirqam ships an official Python SDK and templater CLI, and the REST documentation includes cURL, Python, and Node.js examples.

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 | مِرقم