titlelab.streethosting
titlelab

Documentação

O titlelab transforma texto em título 3D de blocos. O estúdio do site é aberto e roda no seu navegador. A API faz a mesma coisa por requisição e precisa de chave.

Estúdio

Cada linha de texto tem seu próprio estilo e tamanho. Clique numa linha para selecionar, escolha o estilo na galeria e mexa nos ajustes: eles valem só para aquela linha. Câmera, luz, arco e onda valem para a imagem inteira.

Dois estilos na mesma linha

Escreva o nome do estilo entre chaves e o texto dali em diante muda de estilo:

MINECRAFT
{lava}TITLE {ice}GENERATOR

Formatos

PNG e WebP saem com fundo transparente. JPG sempre tem fundo. SVG é vetor: abre em qualquer editor e aumenta sem perder qualidade. Sem altura definida a imagem acompanha o tamanho do título; com altura, o título fica centralizado no quadro.

API

Base: https://api.titlelab.streethosting.com.br. O render só responde com chave. O catálogo de estilos e este guia são abertos.

Chave de API

A API ainda não é pública. Peça uma chave pelo formulário e a gente responde pelo contato que você deixar. Envie a chave no cabeçalho x-api-key (ou Authorization: Bearer). Em lugares onde não dá para mandar cabeçalho, como uma tag de imagem, use ?key=.

Render

GET com os parâmetros na URL, ou POST com JSON e os mesmos nomes. A resposta é a imagem.

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"

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"

Ajustes por linha

No POST, mande rows para dar estilo, tamanho e ajustes diferentes para cada linha:

curl -X POST https://api.titlelab.streethosting.com.br/v1/render \
  -H "x-api-key: sh_..." -H "content-type: application/json" -o title.png \
  -d '{
    "rows": [
      { "text": "FARMING", "style": "grass", "depth": 2 },
      { "text": "SEASON #1", "style": "gold", "scale": 0.7 }
    ],
    "lineGap": -0.3, "width": 1600
  }'

Texto

textObrigatório. Linhas separadas por | ou quebra de linha. Até 4 linhas e 64 caracteres.
styleUm estilo, ou uma lista separada por vírgula com um por linha. Padrão: stone.
scaleTamanho de cada linha, de 0.3 a 2. Ex.: 1,0.7

Saída

formatpng (padrão), jpg ou svg
widthLargura em px, de 64 a 3000. Padrão: 1200.
heightOpcional. Com ela o quadro fica exatamente width x height.
bgtransparent (padrão) ou uma cor hex.
qualityQualidade do JPG, de 1 a 100. Padrão: 90.
alignleft, center ou right
seedNúmero inteiro. Muda a disposição das texturas e cintilações.

Cena (vale para a imagem inteira)

pitchCâmera: inclinação (-45 … 45)
yawCâmera: giro (-45 … 45)
perspectivePerspectiva (0 … 1)
lightDireção da luz (0 … 360)
archArco (-1 … 1)
waveOnda (-1 … 1)
lineGapEspaço entre linhas (-2 … 4)
paddingMargem (0 … 6)

Estilo (troca qualquer valor do preset)

faceCores do gradiente da frente, de 1 a 8, separadas por vírgula.
sideCores da lateral, ou auto para seguir a frente.
outlineCor do contorno.
outline2Cor do segundo contorno, ou none.
glowCor do brilho externo, ou none.
texturenone, noise, cracks, bricks, planks, stripes, scanlines, dots, stars, checker, ore, grid
shinenone, streaks, gloss, sweep
wideLargura da letra (0.5 … 2.4)
tallAltura da letra (0.3 … 1.8)
roundCantos arredondados (0 … 0.5)
slantInclinação (-0.5 … 0.5)
spacingEspaço entre letras (-0.1 … 1.5)
depthProfundidade (0 … 5)
faceAngleÂngulo do gradiente (0 … 360)
faceBandsDegraus do gradiente (0 … 12)
bevelBisel (0 … 0.3)
bevelStrengthForça do bisel (0 … 1)
sideShadeSombra na lateral (0 … 1)
sideBandsFaixas da lateral (1 … 6)
outlineWidthEspessura do contorno (0 … 0.8)
outline2WidthEspessura do segundo contorno (0 … 0.8)
textureStrengthForça da textura (0 … 1)
textureScaleTamanho da textura (0.4 … 3)
shineStrengthForça do reflexo (0 … 1)
glowSizeTamanho do brilho (0 … 3)
glowStrengthForça do brilho (0 … 1)
shadowSombra (0 … 1)
shadowXSombra: deslocamento X (-2 … 2)
shadowYSombra: deslocamento Y (-2 … 2)
shadowBlurSombra: desfoque (0 … 1.5)
sparklesCintilações (0 … 24)
As medidas são em traços: 1 é a espessura de uma perna da letra. Número fora da faixa é ajustado para o limite mais próximo.

Estilos

São 30. O id é o que vai no parâmetro style.

stonegrassgoldemeraldironlavaiceblazechromediamondredstonenetherenderamethystnetheritecopperobsidianneoncandyoceansunsetwoodtntslimesnowrainbowpixelroyalmatrixgalaxy

Erros

Sempre JSON com um código fixo: api_key_required (401), invalid_api_key (401), api_key_not_allowed (403), invalid_text, unknown_style e invalid_param (400), text_too_long e too_many_lines (413), rate_limited (429), render_failed (500).

Para agentes

O guia em texto puro para modelos e scripts fica em https://api.titlelab.streethosting.com.br/llms.txt

Outras ferramentas

Do mesmo time, também gratuitas: utils.streethosting.com.br

Pedir chave de API

Conta rapidinho quem é você e como pretende usar. O pedido chega no nosso Discord e a gente responde pelo contato que você deixar.