自動化
AI エージェントに Markdown 画像化ツールを渡す
REST エンドポイント 1 つと Bearer トークン 1 つ。関数を呼べる、あるいは OpenAPI スキーマを取り込めるフレームワークなら、モデル自身に Markdown をレンダリングさせられます。
用途
こんな使われ方をしています
01
アシスタントが、読みにくい生の Markdown ではなくレンダリング済みの表や図で回答する。
02
リサーチ用エージェントが処理の最後に PDF を生成する。
03
コンテンツ用エージェントが人手の整形なしでソーシャルカードを生成・公開する。
セットアップ
AI agents との連携
- 01
「プロフィール → API tokens」でトークンを作成します。mti_ で始まり、一度しか表示されません。
- 02
ツール記述を読み込むフレームワーク向けに、このエンドポイントはツール名・パラメータ・エンドポイントを簡潔な JSON で返します。
GET https://markdowntoimage.com/api/v1/schema
- 03
OpenAPI 3.x を取り込む場合(多くのエージェント基盤がこちら)は、この URL を指定してください。
https://markdowntoimage.com/api/v1/openapi.json
- 04
内部は通常の REST 呼び出しなので、HTTP リクエストを送れるフレームワークならアダプタなしで利用できます。
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", "format": "png", "width": 800}'
テーマ、フォント、コードスタイル、PDF のページサイズなど全パラメータは API リファレンス.
トラブルシューティング
サポートQ1
どのフレームワークで使えますか?
HTTP エンドポイントを呼べるものならすべてです。主要モデル API の function calling、OpenAPI ツールインポート、コード中心のエージェントフレームワークなど。POST リクエストにフレームワーク固有の要素はないため、SDK も不要です。
Q2
形式やテーマはモデルに選ばせるべき?
選ばせられます。format は png・jpeg・webp・pdf を受け付け、theme と codeStyle は単なる文字列なので、ツール定義に含めればモデルが判断します。省略すれば妥当な既定値が適用されます。
Q3
エージェントが上限を使い切らないようにするには?
GET /api/v1/account/usage で残量を読み、それを条件にツールを制御してください。成功時のレスポンスの meta にも残量が含まれるため、追加リクエストなしで自己制限できます。
Q4
モデルが画像バイナリを扱う必要はありますか?
レスポンスで返るのはホスティング済みの URL です。自前のストレージに置きたい場合は、ワークフローの次のステップでダウンロードするか、mode を binary にしてバイト列を直接受け取り、任意の場所に書き出してください。