Developer API

Personalized images,
generated on demand.

Send a JSON payload. Get back a unique image URL. Drop it into any email, app, or workflow - instantly, at any scale.

Read the docs Get your API key

Free plan · 2,500 watermarked images/month · No credit card required

REQUEST · POST /v1/generate

{
  "design_id": "AbOHw7ix50q",
  "layers": [{
    "layer_id": "name",
    "text": "Lisa"
  }],
  "background": {
    "image_url": "Sydney.jpg"
  }
}

200 OK · 78 ms · image/jpeg

https://media.okzest.com/img?d=AbOHw7ix50q&fname=Lisa&bg=Sydney.jpg

How it works

From design to live image in three steps

No complex setup. No SDK required. Just a simple REST API you can call from any language or tool.

Design your template

Use the visual editor to create an image template. Add text, image, and shape layers for the merge tags you need.

Call the API

POST your recipient's data - name, company, photo URL, any custom field. One call per image, or batch thousands at once.

Use the URL anywhere

Get back a permanent, shareable image URL. Embed it in an email, ad, chat message, or certificate - wherever you need it.

API capabilities

Everything you need to build with

A clean, well-documented API designed to handle real production workloads.

Sub-100ms response

Images are generated and cached instantly. Even first-render times are fast enough for real-time use - no pre-warming required.

Multiple merge tags per image

Combine name, company, location, photo, and any custom field in a single image. Stack as many layers as your design needs.

Dynamic backgrounds

Pass a different background image URL per request. OKZest composites it into your template on the fly - no extra design work.

Fallback values

Set a default for any layer. If a merge tag is missing or empty, your image still looks perfect - no broken placeholders.

Bulk generation

Loop through your contact list and generate thousands of unique image URLs in a single script. No rate-limit surprises.

Team API keys

Create separate API keys per workspace or team member. Revoke access instantly without affecting your other integrations.

Quick start

A few lines to your first personalized image

cURL Node.js Python PHP

generate-image.sh

# Generate a personalized image for Lisa

curl -X POST https://api.okzest.com/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "design_id": "AbOHw7ix50q",
    "layers": [
      { "layer_id": "name", "text": "Lisa" },
      { "layer_id": "company", "text": "Acme Corp" }
    ],
    "background": {
      "image_url": "https://example.com/office.jpg"
    }
  }'

# Response → { "url": "https://media.okzest.com/…" }

Full API reference

Every endpoint, parameter, and response code documented. Try requests directly from the docs - no Postman needed.

API key in your dashboard

Find your key under Settings → API. Create team keys with limited scope, or rotate them any time.

Test with the free plan

Every account gets 2,500 watermarked images/month for free - no credit card needed. Good enough to build a full proof of concept.

Read the full documentation

docs.okzest.com/api/introduction

Works with your stack

Plug into any tool or workflow

Use directly via REST, or connect through the tools your team already uses.

REST API Zapier Make n8n Klaviyo Mailchimp HubSpot ActiveCampaign Brevo Any HTTP client

Get started

Your first API call
takes about 5 minutes.

Create a free account, grab your API key, and start generating personalized images before your next coffee break.

Create a free account Read the API docs

Personalized images,generated on demand.