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リクエスト（トークン管理を除く）には、AuthorizationヘッダーにBearerトークンが必要です。プロフィール > APIトークンページからトークンを取得してください。

Authorization: Bearer mti_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

レート制限とクォータ

月間無料リクエスト数

透かし付き（クレジットなし）

追加リクエストごとのクレジット

透かしなし（クレジットあり）

各アカウントには月50回の無料APIリクエストが付与されます。クレジット残高のあるユーザーは、無料枠内でも常に透かしなしの画像を取得できます。クレジットのないユーザーの画像には透かしが含まれます。無料枠を使い切った後は、各リクエストに1クレジットがかかります。

APIエンドポイント

MarkdownコンテンツをPNG画像に変換します。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（Model Context Protocol）ツール定義と互換性のある形式で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	内部サーバーエラー