Documentación de la API

Convierte Markdown en imágenes atractivas de forma programática. Comienza con 50 solicitudes gratuitas al mes.

Inicio rápido

Crear un token de API

Inicia sesión y crea un token desde tu página de tokens de API

Realiza tu primera llamada a la 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."}'

Autenticación

Todas las solicitudes de API (excepto la gestión de tokens) requieren un token Bearer en el encabezado Authorization. Obtén tu token en la página Perfil > Tokens de API.

Authorization: Bearer mti_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Límites y cuota

Solicitudes gratuitas al mes

Con marca de agua (sin créditos)

Crédito por solicitud adicional

Sin marca de agua (con créditos)

Cada cuenta recibe 50 solicitudes de API gratuitas al mes. Los usuarios con saldo de créditos siempre obtienen imágenes sin marca de agua, incluso dentro de la cuota gratuita. Los usuarios sin créditos obtienen imágenes con marca de agua. Una vez agotada la cuota gratuita, cada solicitud cuesta 1 crédito.

Endpoints de la API

Convierte contenido Markdown en una imagen. Devuelve una URL de imagen o datos binarios según el parámetro mode.

Bearer Token

Parameters

markdownstringrequired

El contenido Markdown a convertir en imagen

widthnumberdefault: 800

Ancho de la imagen en píxeles (200-2560)

formatstringdefault: png

Formato de salida: png, jpeg o webp

qualitynumberdefault: 2.0

Factor de escala del dispositivo para el renderizado (1.0-3.0)

themestring

Tema visual para la imagen renderizada

lightdarknordgithubmonokaisolarized

codeStylestring

Estilo de resaltado de sintaxis para bloques de código

defaultgithubvsxcodeatom-one-lightgooglecode

fontFamilystring

Familia tipográfica para el contenido renderizado

sansintermodernarticledocsroboto

modestringdefault: url

Modo de respuesta: 'url' devuelve una URL de imagen temporal (válida por 24 horas), 'binary' devuelve los datos binarios. Para almacenamiento permanente, descargue la imagen a tiempo

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
    }
  }
}

Obtener las estadísticas de uso mensual de la API, incluyendo la cuota gratuita restante y el saldo de créditos.

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"
  }
}

Obtener el esquema de la API en un formato compatible con las definiciones de herramientas de MCP (Model Context Protocol). Útil para la integración de agentes de IA.

Bearer Token

Response

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

Códigos de error

Código de error	HTTP Status	Descripción
UNAUTHORIZED	401	Token de API inválido o ausente
INVALID_REQUEST	400	Parámetros de solicitud inválidos
MARKDOWN_REQUIRED	400	El contenido Markdown es obligatorio
QUOTA_EXCEEDED	429	Cuota mensual gratuita excedida y créditos insuficientes
GENERATION_FAILED	500	Error en la generación de la imagen
INTERNAL_ERROR	500	Error interno del servidor