Referencia de la API

Crea un token, envía Markdown y recibe una imagen o PDF. Esta referencia cubre solicitudes, respuestas, cuotas e integraciones.

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 cuotas

Solicitudes gratuitas al mes: 50La cuota gratuita de API incluye marca de agua
Crédito por solicitud adicional: 11 crédito quita la marca de agua

La API y las exportaciones del navegador siguen reglas independientes. La API incluye 50 solicitudes mensuales con marca de agua; 1 crédito API permite una renderización sin marca de agua. Sin cuota gratuita ni créditos disponibles, se devuelve HTTP 429. Las cuentas con sesión iniciada reciben 5 exportaciones de navegador sin marca de agua en total. Después se usa una suscripción, un pase de 1 USD o créditos antiguos compatibles. Los nuevos créditos API no eliminan marcas de agua del navegador.

Endpoints

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

Requiere token Bearer

Parámetros

markdownstringObligatorio: El contenido Markdown a convertir en imagen
widthnumberPredeterminado: 800: Ancho de la imagen en píxeles (200-2560)
formatstringPredeterminado: png: Formato de salida: png, jpeg, webp o pdf. Con pdf se devuelve un documento PDF en formato A4 con encabezado/pie de pagina
qualitynumberPredeterminado: 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
modestringPredeterminado: 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": "github-dark"
  }'

Respuesta

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

Requiere token Bearer

cURL

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

Respuesta

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

Endpoint público

Respuesta

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

Códigos de error

Código de error	Estado HTTP	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

Integraciones de flujos

Solicitud HTTP de n8n

Usa POST, añade la cabecera del token Bearer y este cuerpo JSON. La guía explica cómo procesar la respuesta.

JSON

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

Herramienta personalizada de Dify

Importa esta URL OpenAPI en Tools → Custom y configura la autenticación Bearer con tu token.

OpenAPI

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

Otras integraciones

01n8nGenerar imágenes desde Markdown en n8n 02DifyUna herramienta de Markdown a imagen para Dify 03MakeConvertir Markdown en imágenes en Make 04ZapierConvertir Markdown en imágenes con Zapier 05AI agentsUna herramienta de Markdown a imagen para tu agente de IA

¿Necesitas ayuda con plantillas?

Consulta con nuestro equipo sobre plantillas, mayor volumen o integración HTTP.

Consultar una integración

Solemos responder en 1–2 días laborables.