One endpoint, infinite images.

Create a token in your dashboard under API tokens. Send it on every request. The same token works for the REST API and the MCP server, and identifies which account is billed.

curl https://render.pixeldrive.pro/v1/render \
  -H "Authorization: Bearer pdrv_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

A missing, revoked, or expired token returns 401.

Render one image synchronously. Results are cached by a content hash of the template + payload, so identical requests return instantly and cost nothing.

Request body

Payload value types

Each element id maps to one value object, depending on the element:

Example

curl -X POST https://render.pixeldrive.pro/v1/render \
  -H "Authorization: Bearer pdrv_..." \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "ee3a339f-2826-406c-a6e4-04b9a7b4d373",
    "payload": {
      "headline":  { "text": "500K followers" },
      "avatar":    { "src":  "https://example.com/pic.jpg" }
    },
    "pixelRatio": 1
  }'

Response

{
  "url": "https://render.pixeldrive.pro/img/t/<templateId>/<hash>.png",
  "fromCache": false,            // false | "redis" | "db"
  "fieldsHash": "a1b2c3d4e5f6g7h8",
  "renderMs": 620,
  "uploadBytes": 254714,
  "creditsRemaining": 9999
}

Queue up to 1,000 renders against one template and get a batch id back immediately. Poll /v1/batches/:id or stream /stream for results. This is the right tool for generating hundreds of images — it never blocks a connection.

Request body

curl -X POST https://render.pixeldrive.pro/v1/render/batch \
  -H "Authorization: Bearer pdrv_..." \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "ee3a339f-...",
    "payloads": [
      { "name": { "text": "Alice" } },
      { "name": { "text": "Bob" } }
    ],
    "userId": "660e8400-..."
  }'

// 202 Accepted
{ "batchId": "770e8400-...", "count": 2, "jobIds": ["…","…"] }

Counts plus a per-job results array.

{
  "batchId": "770e8400-...",
  "total": 2, "queued": 0, "running": 1, "completed": 1, "failed": 0,
  "results": [
    { "id": "…", "status": "completed",
      "result": { "imageUrl": "https://render.pixeldrive.pro/img/…", "contentType": "image/png", "fromCache": false },
      "failedReason": null },
    { "id": "…", "status": "running", "result": null, "failedReason": null }
  ]
}

Server-Sent Events. Emits a progress event whenever counts change, then a done event with the full results. Closes automatically when finished (max 30 min).

event: progress
data: {"total":2,"completed":1,"failed":0,"running":1,"queued":0}

event: done
data: {"results":[ … ]}

Status of one job from a batch (ids come from the batch response's jobIds).

{
  "id": "job-uuid",
  "status": "completed",         // waiting | active | completed | failed | delayed
  "progress": 100,
  "result": { "imageUrl": "https://render.pixeldrive.pro/img/…", "contentType": "image/png" },
  "failedReason": null,
  "attemptsMade": 1
}

Public, content-addressed, cached for a year (immutable). These are the URLs returned by every render. Drop them straight into an <img>, an email, or a CDN.

GET https://render.pixeldrive.pro/img/t/ee3a339f-.../a1b2c3d4e5f6g7h8.png
→ 200, Content-Type: image/png, Cache-Control: public, max-age=31536000, immutable

Issue a short-lived signed URL for an image (for private/expiring links).

curl -X POST https://render.pixeldrive.pro/v1/sign \
  -H "Authorization: Bearer pdrv_..." \
  -d '{ "url": "https://render.pixeldrive.pro/img/t/…/….png", "expiresIn": 7200 }'

{ "url": "https://…signed…", "key": "t/…/….png", "expiresIn": 7200 }

A Model Context Protocol endpoint so AI assistants can generate images directly. Authenticate with the same Bearer API token. Two tools:

Both take { templateId, payload } with the same payload shape as the REST API. Point your MCP client at https://pixeldrive.pro/mcp with header Authorization: Bearer pdrv_….

Status codes

Manage tokens in API tokens · upgrade for more credits on Billing · see plans on Pricing.