# titlelab: 3D block-style title and logo generator Web studio: https://titlelab.streethosting.com.br API base: https://api.titlelab.streethosting.com.br Not an AI model. A deterministic vector engine: the same parameters always produce the same image. Text goes in, an image (PNG, JPG or SVG) comes out. ## Access The web studio is open and runs in the browser. The render API is CLOSED: every /v1/render call needs an API key. Keys are requested with the form on the site ("Pedir chave de API") and issued by the StreetHosting team. Send the key as "x-api-key: sh_...", "Authorization: Bearer sh_..." or ?key=sh_... (only where headers are impossible, e.g. an tag). Without a key: 401 { "error": "api_key_required" }. ## Endpoints GET /health -> { "ok": true } GET /llms.txt -> this guide GET /v1/styles -> JSON with every style preset and the parameter ranges (open) GET /v1/render?text=...&style=... -> image (key required) POST /v1/render (JSON body, same names as the query) -> image (key required) POST /v1/key-request { "name", "contact", "usage", "site"? } -> { "ok": true } Forwards an API key request to the team. 3/min per IP. ## Text text required. Lines separated by "|" or a newline (max 4 lines, 64 visible characters in total). Letters are drawn uppercase. Supports A-Z, 0-9, common punctuation and Latin accents (á é í ó ú â ê ô ã õ ç ñ ü). Inside a line, {style} switches the style from that point on: text=MINECRAFT|{lava}TITLE {ice}GENERATOR style one style id, or a comma list with one per line (the last repeats). Default: stone. scale size of each line, comma list (0.3..2). Example: scale=1,0.7 ## Styles (30) stone, grass, gold, emerald, iron, lava, ice, blaze, chrome, diamond, redstone, nether, ender, amethyst, netherite, copper, obsidian, neon, candy, ocean, sunset, wood, tnt, slime, snow, rainbow, pixel, royal, matrix, galaxy ## Output format png (default) | jpg | svg width 64..3000 px, default 1200. Height follows the content. height optional. With it the canvas is exactly width x height and the title is centered. bg transparent (default) or a hex color. JPG has no transparency: without bg it uses the style's suggested dark backdrop. quality 1..100 for jpg, default 90 padding margin around the title, in stroke units ## Scene (whole image) pitch=-45..45 yaw=-45..45 perspective=0..1 light=0..360 arch=-1..1 wave=-1..1 lineGap=-2..4 padding=0..6 pitch/yaw are camera angles in degrees; perspective 0 is flat, 1 is strong. light is the direction the light comes from, clockwise from the top (315 = top left). arch bends the title, wave makes it undulate, lineGap is the space between lines. align=left|center|right, seed= changes the random texture layout. ## Style overrides (apply to every line; any preset value can be replaced) wide=0.5..2.4 tall=0.3..1.8 round=0..0.5 slant=-0.5..0.5 spacing=-0.1..1.5 depth=0..5 faceAngle=0..360 faceBands=0..12 bevel=0..0.3 bevelStrength=0..1 sideShade=0..1 sideBands=1..6 outlineWidth=0..0.8 outline2Width=0..0.8 textureStrength=0..1 textureScale=0.4..3 shineStrength=0..1 glowSize=0..3 glowStrength=0..1 shadow=0..1 shadowX=-2..2 shadowY=-2..2 shadowBlur=0..1.5 sparkles=0..24 face= front gradient stops (1 to 8) side=|auto side color(s); auto derives them from the face outline= outline2=|none glow=|none texture=none|noise|cracks|bricks|planks|stripes|scanlines|dots|stars|checker|ore|grid shine=none|streaks|gloss|sweep Units are "strokes": 1 = the thickness of a letter stroke. faceBands > 0 turns the gradient into hard steps (pixel art look). ## Per-line overrides (POST only) { "rows": [ { "text": "FARMING", "style": "grass", "depth": 2 }, { "text": "SEASON #1", "style": "gold", "scale": 0.7 } ], "lineGap": -0.3, "width": 1600, "format": "png" } ## Examples curl -H "x-api-key: sh_..." -o title.png \ "https://api.titlelab.streethosting.com.br/v1/render?text=FARMING|SEASON%20%231&style=grass,gold&scale=1,0.7&lineGap=-0.3" curl -H "x-api-key: sh_..." -o logo.jpg \ "https://api.titlelab.streethosting.com.br/v1/render?text=MY%20SERVER&style=diamond&format=jpg&width=1920&height=1080" ## Errors JSON with stable codes: { "error": "api_key_required" } 401, no key sent { "error": "invalid_api_key" } 401 { "error": "api_key_disabled" } 403 { "error": "api_key_not_allowed" } 403, key not enabled for titlelab { "error": "invalid_text" } 400, text missing or empty { "error": "unknown_style", "param": id } 400 { "error": "invalid_param", "param": name }400 { "error": "invalid_json" } 400 { "error": "text_too_long" } 413 { "error": "too_many_lines" } 413 { "error": "rate_limited" } 429, with retry-after { "error": "render_failed" } 500 { "error": "api_keys_unavailable" } 503 { "error": "key_requests_unavailable" } 503, key request form is offline Out-of-range numbers are clamped to the range, not rejected. ## Notes for agents - Responses with a key carry x-ratelimit-limit, x-ratelimit-remaining and x-ratelimit-reset. - Images are cached by parameters; identical requests are cheap. - The same key can be enabled for other StreetHosting APIs: https://api.keys.streethosting.com.br/llms.txt - Sibling tools: https://utils.streethosting.com.br/llms.txt