Documentacao da API

Converta Markdown em belas imagens de forma programatica. Comece com 50 solicitacoes gratuitas por mes.

Inicio rapido

Criar um token de API

Faca login e crie um token na sua pagina de tokens de API

Faca sua primeira chamada de API

curl -X POST https://markdowntoimage.com/api/v1/images/generate \
  -H "Authorization: Bearer mti_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"markdown": "# Hello World\n\nThis is a test."}'

Autenticacao

Todas as solicitacoes de API (exceto gerenciamento de tokens) exigem um token Bearer no cabecalho Authorization. Obtenha seu token na pagina Perfil > Tokens de API.

Authorization: Bearer mti_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Limites e cota

Solicitacoes gratuitas por mes

Com marca d'agua (sem creditos)

Credito por solicitacao adicional

Sem marca d'agua (com creditos)

Cada conta recebe 50 solicitacoes de API gratuitas por mes. Usuarios com saldo de creditos sempre recebem imagens sem marca d'agua, inclusive dentro da cota gratuita. Usuarios sem creditos recebem imagens com marca d'agua. Apos o esgotamento da cota gratuita, cada solicitacao custa 1 credito.

Endpoints da API

Converte conteudo Markdown em uma imagem. Retorna uma URL de imagem ou dados binarios dependendo do parametro mode.

Bearer Token

Parameters

markdownstringrequired

O conteudo Markdown a ser convertido em imagem

widthnumberdefault: 800

Largura da imagem em pixels (200-2560)

formatstringdefault: png

Formato de saida: png, jpeg ou webp

qualitynumberdefault: 2.0

Fator de escala do dispositivo para renderizacao (1.0-3.0)

themestring

Tema visual para a imagem renderizada

lightdarknordgithubmonokaisolarized

codeStylestring

Estilo de destaque de sintaxe para blocos de codigo

defaultgithubvsxcodeatom-one-lightgooglecode

fontFamilystring

Familia de fontes para o conteudo renderizado

sansintermodernarticledocsroboto

modestringdefault: url

Modo de resposta: 'url' retorna uma URL de imagem temporária (válida por 24 horas), 'binary' retorna os dados binários. Para armazenamento permanente, baixe a imagem a tempo

curl -X POST https://markdowntoimage.com/api/v1/images/generate \
  -H "Authorization: Bearer mti_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# Hello\n\n- Item 1\n- Item 2",
    "width": 800,
    "format": "png",
    "theme": "minimal-dark"
  }'

Response

{
  "success": true,
  "data": {
    "imageUrl": "https://markdowntoimage.com/api-temp/uuid.png",
    "imageId": "550e8400-e29b-41d4-a716-446655440000",
    "format": "png",
    "width": 800
  },
  "meta": {
    "quota": {
      "freeRemaining": 48,
      "creditBalance": 200,
      "usedFreeQuota": true
    }
  }
}

Obter estatisticas de uso mensal da API, incluindo cota gratuita restante e saldo de creditos.

Bearer Token

curl https://markdowntoimage.com/api/v1/account/usage \
  -H "Authorization: Bearer mti_your_token"

Response

{
  "success": true,
  "data": {
    "monthlyQuota": 50,
    "monthlyUsed": 12,
    "monthlyRemaining": 38,
    "yearMonth": "2026-02",
    "creditBalance": 200,
    "resetDate": "2026-03-01"
  }
}

Obter o esquema da API em um formato compativel com as definicoes de ferramentas do MCP (Model Context Protocol). Util para integracao de agentes de IA.

Bearer Token

Response

{
  "success": true,
  "data": {
    "name": "markdown-to-image",
    "version": "v1",
    "tools": [...]
  }
}

Codigos de erro

Codigo de erro	HTTP Status	Descricao
UNAUTHORIZED	401	Token de API invalido ou ausente
INVALID_REQUEST	400	Parametros de solicitacao invalidos
MARKDOWN_REQUIRED	400	O conteudo Markdown e obrigatorio
QUOTA_EXCEEDED	429	Cota mensal gratuita excedida e creditos insuficientes
GENERATION_FAILED	500	Falha na geracao da imagem
INTERNAL_ERROR	500	Erro interno do servidor