Ir para o conteúdo

Referência para desenvolvedores

Referência da API

Crie um token, envie Markdown e receba uma imagem ou PDF. Esta referência abrange requisições, respostas, cotas e integrações.

Início rápido

1

Criar um token de API

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

2

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 cotas

Solicitacoes gratuitas por mes
50A cota gratuita da API inclui marca d'agua
Credito por solicitacao adicional
11 credito remove a marca d'agua

A API e as exportações do navegador têm regras separadas. A API inclui 50 pedidos mensais com marca de água; 1 crédito da API permite uma renderização sem marca de água. Sem quota gratuita ou créditos disponíveis, é devolvido HTTP 429. As contas com sessão iniciada recebem 5 exportações de navegador sem marca de água no total. Depois, utilizam uma subscrição, um passe de 1 USD ou créditos antigos elegíveis. Os novos créditos da API não removem marcas de água do navegador.

Endpoints

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

Token Bearer obrigatório

Parâmetros

markdownstringObrigatório
O conteudo Markdown a ser convertido em imagem
widthnumberPadrão: 800
Largura da imagem em pixels (200-2560)
formatstringPadrão: png
Formato de saida: png, jpeg, webp ou pdf. Com pdf, retorna um documento PDF em formato A4 com cabecalho/rodape
qualitynumberPadrão: 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
modestringPadrão: 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": "github-dark"
  }'

Resposta

{
  "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.

Token Bearer obrigatório

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

Resposta

{
  "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.

Endpoint público

Resposta

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

Códigos de erro

Codigo de erroStatus HTTPDescricao
UNAUTHORIZED401Token de API invalido ou ausente
INVALID_REQUEST400Parametros de solicitacao invalidos
MARKDOWN_REQUIRED400O conteudo Markdown e obrigatorio
QUOTA_EXCEEDED429Cota mensal gratuita excedida e creditos insuficientes
GENERATION_FAILED500Falha na geracao da imagem
INTERNAL_ERROR500Erro interno do servidor

Integrações de fluxos

HTTP Request do n8n

Use POST, adicione o cabeçalho do token Bearer e este corpo JSON. O guia explica como tratar a resposta.

JSON
{
  "markdown": "={{ $json.content }}",
  "format": "png",
  "mode": "url"
}

Ferramenta personalizada do Dify

Importe esta URL OpenAPI em Tools → Custom e configure a autenticação Bearer com seu token.

OpenAPI
https://markdowntoimage.com/api/v1/openapi.json

Outras integrações

Precisa de ajuda com modelos?

Converse com nossa equipe sobre modelos, maior volume ou integração HTTP.

Conversar sobre integração

Normalmente respondemos em 1–2 dias úteis.

Markdown To Image | Effortlessly Convert Markdown to PDF, JPEG, PNG, and WebP with markdowntoimage.com