Getting Started

Image API

The Image API generates a 1200×400 PNG image with centered bold white text on a dark background. It is designed for Discord bots that need a quick preview image — for example, embedding a server or ticket name in a transcript header.

The endpoint requires no authentication. Simply pass your text as a query parameter and embed the URL directly in any Discord embed's image field.

GET https://ulquiorracifer.xyz/api/image

Responses are cached for 24 hours via Cache-Control: public, max-age=86400, immutable. Identical text values will be served from CDN cache on repeat requests.

Reference

Parameters

A single query parameter controls the rendered text. All quote characters (curly and straight) are automatically stripped server-side before rendering.

Parameter	Type	Status	Description
text	string	Optional	The text to render on the image. Truncated to 120 characters. Font size scales automatically based on length. Defaults to `TranscriptAPI` if omitted.

Font Size Scaling

Text Length	Font Size
1 – 20 characters	80px
21 – 35 characters	66px
36 – 55 characters	52px
56 – 80 characters	40px
81 – 120 characters	32px

Example URL

GET https://ulquiorracifer.xyz/api/image?text=Ticket+%23001

Using in a Discord Embed

const imageUrl = `https://ulquiorracifer.xyz/api/image?text=${encodeURIComponent(ticketName)}`;

const embed = {
  title: "Transcript Ready",
  image: { url: imageUrl },
  color: 0x00eeff,
};

from urllib.parse import quote

image_url = f"https://ulquiorracifer.xyz/api/image?text={quote(ticket_name)}"

embed = {
    "title": "Transcript Ready",
    "image": {"url": image_url},
    "color": 0x00eeff,
}

Interactive

Live Example

Type any text below to see the generated image update in real time. This calls the live /api/image endpoint — exactly what Discord will display in your embed.

Text 13 / 120

URL https://ulquiorracifer.xyz/api/image?text=TranscriptAPI

Preview

1200 × 400 px · PNG · Dark background

Need help or have questions?

Reach out to Cenzo directly or join the community support server.

✉ Email Cenzo Discord Server