API reference

API 文档

通过编程方式将 Markdown 转换为精美图片。每月提供 50 次带水印的免费 API 请求。

快速开始

创建 API 令牌

发送第一个 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."}'

身份认证

所有 API 请求（令牌管理和 Schema 接口除外）都需要在 Authorization 头中包含 Bearer 令牌。/api/v1/schema 端点为公开接口，无需认证。请在个人中心 > API 令牌页面获取令牌。

Authorization: Bearer mti_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

配额与限制

每月免费请求次数

API 免费额度带水印

超出后每次消耗积分

1 积分去水印

API 免费额度始终带水印，除非本次请求使用积分。浏览器导出的登录赠送次数单独计算：登录账户共有 5 次无水印浏览器导出，之后如果没有积分或未选择去水印，浏览器导出会带水印。API 每月有 50 次带水印免费请求；之后每次无水印 API 渲染消耗 1 积分。没有免费额度且没有积分的请求会被拒绝（HTTP 429）。

API 端点

将 Markdown 内容转换为图片。根据 mode 参数返回图片 URL 或二进制数据。

Bearer Token

Parameters

markdownstringrequired

要转换为图片的 Markdown 内容

widthnumberdefault: 800

图片宽度（像素），范围 200-2560

formatstringdefault: png

输出格式：png、jpeg、webp 或 pdf。设为 pdf 时返回带页眉页脚的 A4 格式 PDF 文档

qualitynumberdefault: 2.0

设备缩放因子（1.0-3.0）

themestring

渲染图片的视觉主题

lightdarknordgithubmonokaisolarized

codeStylestring

代码块的语法高亮样式

defaultgithubvsxcodeatom-one-lightgooglecode

fontFamilystring

渲染内容的字体

sansintermodernarticledocsroboto

modestringdefault: url

响应模式：'url' 返回临时图片 URL（保留 24 小时），'binary' 返回原始图片数据。如需永久保存，请及时下载图片

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

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

获取当月 API 使用统计，包括免费额度剩余和积分余额。

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

获取兼容 MCP（模型上下文协议）工具定义格式的 API 架构。适用于 AI 代理集成。

Public

Response

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

错误码

错误码	HTTP Status	描述
UNAUTHORIZED	401	无效或缺失的 API 令牌
INVALID_REQUEST	400	无效的请求参数
MARKDOWN_REQUIRED	400	Markdown 内容为必填项
QUOTA_EXCEEDED	429	每月免费额度已用完且积分不足
GENERATION_FAILED	500	图片生成失败
INTERNAL_ERROR	500	服务器内部错误

常见集成模式

n8n HTTP Request

可在 n8n 的 HTTP Request 节点中使用如下配置：

Method: POST
URL: https://markdowntoimage.com/api/v1/images/generate
Headers:
  Authorization: Bearer mti_your_token
  Content-Type: application/json

Body (JSON):
{
  "markdown": "{{ $json.content }}",
  "format": "png",
  "theme": "github-dark"
}

Dify 自定义工具

可在 Dify 中添加为自定义工具：

Tool Schema:
{
  "name": "markdown_to_image",
  "description": "Convert markdown to PNG/PDF image",
  "parameters": [
    {
      "name": "markdown",
      "description": "Markdown content to convert",
      "type": "string"
    },
    {
      "name": "format",
      "description": "Output format: png, jpeg, pdf",
      "type": "string"
    }
  ],
  "endpoint": "https://markdowntoimage.com/api/v1/images/generate"
}

需要自定义模板支持？

我们可以协助你完成自定义模板、高并发集成或企业级接入。

申请集成支持

响应时间：1-2 个工作日