API 文档

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

快速开始

创建 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 请求（令牌管理除外）都需要在 Authorization 头中包含 Bearer 令牌。请在个人中心 > API 令牌页面获取令牌。

Authorization: Bearer mti_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

配额与限制

每月免费请求次数

带水印（无积分时）

超出后每次消耗积分

无水印（有积分时）

每个账户每月享有 50 次免费 API 请求。拥有积分余额的用户始终生成无水印图片（包括免费额度内）；无积分用户生成的图片带有水印。免费额度用完后，每次请求消耗 1 积分。

API 端点

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

Bearer Token

Parameters

markdownstringrequired

要转换为图片的 Markdown 内容

widthnumberdefault: 800

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

formatstringdefault: png

输出格式：png、jpeg 或 webp

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

获取当月 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 代理集成。

Bearer Token

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	服务器内部错误