Imagem API

O Gerador de Imagens permite criar imagens personalizadas, definindo formato, dimensões, tipo e cores. Ideal para placeholders, padrões ou gradientes.

Como Usar

Envie uma requisição POST informando os parâmetros desejados, como largura, altura, tipo de imagem e cor de fundo.

Atenção: O uso excessivo pode consumir rapidamente sua cota de requisições. Testar a API pelo docs consome seu limite de requisições.

Requisição

Parâmetros Header

X-API-KEY

string

requerido

Sua chave token

Parâmetros Bodyapplication/json

format

enum<string>

opcional

Valores permitidos:

pngjpg

width

integer

opcional

Largura da imagem em pixels (entre 50 e 5000).

height

integer

opcional

Altura da imagem em pixels (entre 50 e 5000).

type

enum<string>

opcional

Valores permitidos:

placeholderpatterngradient

text

string

opcional

Texto para a imagem (até 100 caracteres)., Obrigatório caso type seja placeholder

<= 100 Caracteres

background

string

opcional

Cor de fundo da imagem em hexadecimal (ex: #FFFFFF).

Padrão de combinação:

^#[0-9A-Fa-f]{6}$

textColor

string

opcional

Cor do texto na imagem em hexadecimal (ex: #000000).

Padrão de combinação:

^#[0-9A-Fa-f]{6}$

backgroundGradient

array [object {2}]

opcional

Lista de cores para o gradiente de fundo.

color

string

requerido

Cor do gradiente no formato RGB (ex: rgb(255, 255, 255)).

Padrão de combinação:

^rgb$\d{1,3}, \d{1,3}, \d{1,3}$$

percent

integer

requerido

Percentual de aplicação do gradiente (0 a 100).

>= 0<= 100

Exemplo

{
  "format": "png",
  "width": 0,
  "height": 0,
  "type": "placeholder",
  "text": "string",
  "background": "string",
  "textColor": "string",
  "backgroundGradient": [
    {
      "color": "string",
      "percent": 0
    }
  ]
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Respostas

🟢200200

application/json

Body

data

string

requerido

Exemplo

{
  "data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAfQAAAH0CAYAAADL1t+KAAAABmJLR0QA/wD/AP+gvaeTAAAToUlEQVR4nO3df6zVdR3H8c+9qAgIEzDDEBUZQcKERKUtKXKkSdEyl2ZZLVHpn0b0Y/3U2pxKPyRkuKWIY9NMjXKt2gwX3RnSD4YlLcUNIZG6CEFy+Q333m9/VHceDvdyQeTmi8dje2+e7/d7Pud7rnd7cr73nHsbSilVAQDe0Bp7+gQAgNdO0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOgAEEHQACCDoABBA0AEggKADQABBB4AAgg4AAQQdAAIIOseVlStXlqqqOp329vaydevWsm7duvLMM8+Upqam8q1vfau8+c1vrlvr7LPPLjt27Ki5/6ZNm8rAgQMPeR533XVX3WPfdNNNh7zf+vXruzz/7sz5559/RF+719OiRYtqzvHmm2/u6VOCN6TKmONlVq5cWR2JlpaW6gMf+EDdep///Ofrjp0/f36X5zBmzJhq//79Nfd58sknq4aGhkOe//r164/o/F/t/PPP7/H/DwfOokWLas7x5ptv7vFzMuaNNl6hQzf079+/LF68uLz97W+v2X7XXXeVlStX1mz7zGc+U8aPH9/pWnPnzi0nnHBCx+29e/eWGTNmlKqqju5JA8eVEw59COT685//XP74xz923D7xxBPLKaecUnr16lUuuuiiMmzYsI59vXv3LrfddluZOnVqx7a2trZy0003lT/84Q8dke7Vq1eZP39+mTRpUl2kr7zyyjJlypSabbNnzy7PPfdct873l7/8ZRk8eHDd9rFjx5a3ve1tHbe3bdtWlixZctA1tm3b1q3HAt54evwygTHHag685H7HHXd0euwJJ5xQPfTQQzXHt7a2VieddFLdsd/73vfqLm1/4hOfqDnm5JNPrl544YWaY5577rmqd+/er/l53XrrrTXrPvPMMz3+tT6cccndmNc+XqFDJ1pbW8sdd9xRrr322o5tvXr1KoMHDy7Nzc01x37zm98sV111VTnnnHM6tn3nO98pP/vZz0pLS0sppZQvfOEL5dxzz+3YX/33jXB79+59fZ9INwwdOrSMGjWqDBs2rOzbt6+sX7++rFixouzbt++w1unbt28ZP358OfPMM0ufPn3Kpk2byooVK8o///nPo3auAwcOLBMmTChDhgwpvXv3Lps2bSovv/xyef7551194LjX4/+qMOZYzeG8Qi+lVOedd17N8bt3764aGxsPeuwVV1xR9yr9zjvvrEop1dChQ6sdO3bU7Lv33nuP2vM60lfo73//+6slS5ZUbW1tdee+ffv2at68edXpp59+yHVGjBhR3XvvvVVLS0vdOm1tbdWSJUuqiRMndnr/7rxCHz58ePXYY4/VvaHwf/bv31899thj1fDhw3v8+8yYHpoePwFjjtkcTtAbGxur++67r+b4Bx54oMv1D7xEv2/fvmrMmDHVD3/4w5rtzc3N1amnnnrUntfhBr1Xr17VPffcc9AwHujvf/97deGFF3a61oc//OFq586dh1yntbW1+tznPnfQNQ4V9NGjR1ebN2/u1vlu3ry5GjlyZI9/rxlzrMcld45r73jHO8qXv/zluu2DBg0qU6ZMKRdccEHHts2bN5dbbrmly/VmzZpVLr/88jJo0KBSyn/eZLd48eIyatSomuNmzpxZXnnllaPwDI7M7NmzD/q5971795bevXvXbHvLW95SfvWrX5WLL764vPDCCzX73vWud5WHH364nHjiiTXb29vbS2traznppJM6tvXq1at8//vfL9u3by8LFy48rPO9++67y2mnndZxe82aNeWpp54q27dvL8OGDSvve9/7Os77tNNOKwsWLCiTJ08+rMeABD3+rwpjjtUc6efQV61aVY0bN65bjzF9+vQu1/r5z39+1J/X4bxCHz9+fN0l9mXLllUTJkyoSilV3759qxtvvLHuRwRNTU016zQ2NlarV6+ue3X80Y9+tOrdu3fV0NBQTZo0qVq1alXNMbt3767OPPPMmrW6eoU+ePDgqr29vWPf7373u7ofe4wbN67atWtXVVX/ucS/evXqasiQIT3+/WbMMZ4ePwFjjtkcadCbmpqqqVOndusxGhoaqqampoOus3379uqss8466s/rcIJ+4KX2VatWVX369Kk77mDvCbjkkks69l922WU1+/bt23fQS/ODBg2qXnrppZpj58yZU3NMV0F/61vfWrNvw4YN1aRJk+oe573vfW81ceLEql+/fj3+fWZMD02Pn4Axx2yONOj/s2DBgm79RrdRo0ZVe/bsqbv/zJkzX5fn1d2gNzY2Vtu2bas59pprrul03WXLltUc++1vf7tj34ERfvTRRztdZ9asWTXHrlmzpmZ/V0Hv169ftXv37rqv5bp166qFCxdW1113XbfeuGdM+vhNcRzXfvCDH5QRI0Z0zMiRI8uFF15Y3vnOd5YbbrihLF++vOb4G264oXzqU5865LrPP/983c+J//a3v5X58+cf1fM/XGeccUYZMGBAzbampqZOjz9w37hx4zr+e/To0TX7fvOb33R7nREjRpR+/fp1fbL/tXPnzrJo0aK67eecc065/vrrywMPPFCam5vL73//+/LVr361nH766d1aF9IIOse1V155paxdu7Zj1qxZU1auXFmWL19eFi5cWCZPnlx++9vf1tznG9/4RrfW3rp1a83tf/3rX6Wtre2onfuROOOMM2puV1VVNm/e3OnxL7/8cs3tV78xbciQITX7ulpn06ZNddtevdahfPGLXyy/+MUvOt3f2NhYJk6cWG6//faydu3a8ulPf7rba0MKQYcu7N+/v9x///0120aMGNHxLvY3mi1bttTcbmhoqHtX+6v17du35vaOHTs6Xevkk0/udJ0+ffrUbXv1Woeyc+fOMm3atHLFFVeUxYsXd3nffv36lYULF5ZJkyZ1e31IIOhwCK2trXXbDufV5f+T5ubmut8vP3bs2E6PP3DfunXratZ6tTFjxnR7nZaWlrorGN3x+OOPl4985CNl0KBB5ZJLLim33HJLaWpqqvuNdg0NDeXGG2887PXhjUzQ4RCuuuqqmtttbW1lw4YNPXQ2r82ePXvKs88+W7Ots8vTgwcPLh/84Adrtv3617/u+O8D/8rctddee9BX4qWUcv3119fcXrp0abf/ulxjY2MZPnx4ufzyy8vMmTPLlClTyv79+8tTTz1Vbr311vKe97ynvOlNbyqPPPJIzf1e/Wt44Xgg6BzXTj311HLuuefWzOjRo8uECRPK1KlTy49//OPyoQ99qOY+S5cuLbt27eqhM37tHnzwwZrbM2bMKJ/85Cdrtg0YMKD86Ec/qnkDXXNzc/npT3/acfuhhx4q7e3tHbfPPvvscv/999dcem9oaChf+tKXyrRp02rWv/vuu7t9vvPmzStr164tjz/+eJk7d26ZM2dO3eX9lpaWujcwdvUzfUjV42+1N+ZYzWv92Fp7e3t16aWXduuxDvwo2dNPP/26Pa/D+Rx6//79qxdffLHuuS1btqz67ne/W91zzz3Vxo0b6/Z//OMfr1trwYIFdce9+OKL1fz586s777zzoF/vn/zkJ3XrdPWxtbFjx1atra01+5988slq2rRp1ejRo6uLLrqomjVrVrVly5aaY6677roe/34z5hhPj5+AMcdsXmvQb7vttm4/1v9r0Esp1QUXXFBt3bq128/79ttvP+g6ffv2rfuseldWrFhR9e/fv26dQ/0u96985Svdfoyqqqonnnii0z+iY0zquOQO3fDSSy+V6dOnl69//es9fSpHxdNPP10uvvjimp+JH8yWLVvK9OnTy9e+9rWD7t+1a1eZMmVKmTNnTpd/Bratra3cd9995d3vfnfZvn37YZ/v7Nmzy4wZM7r151EffPDBcuWVV9b8OACOBw3lP2WH48JnP/vZMnTo0IPu27NnT9m9e3dpb2/vCEdLS0t59tlny1//+tfD/gz5ZZddVi699NKO2//4xz/KvHnzjvzkD+OxNm7cWObOndut+5533nnlYx/7WBk3blw566yzyu7du8uGDRvKE088UR5++OFu/43xQYMGlWuuuaZMnjy5DBs2rJxyyimlubm5LF++vDzyyCNl9erVnd736quvrvlDOEuWLClLly6tO27gwIHl6quvLpMmTSojR44sAwYMKDt37iwbN24sf/rTn8qjjz5a/vKXv3TrfCGNoANAAJfcASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAQQdAAIIOgAEEDQASCAoANAAEEHgACCDgABBB0AAgg6AAT4N6D70yrc9wesAAAAAElFTkSuQmCC"
}

🟠401401

🟠422422

Como Usar#

Requisição

Exemplos de Requisição

Respostas

Como Usar