Sign In
Sign In
フォントの生成、グリフの取得、配信の管理を、すべてプログラムから。アプリと同じエンジンが、ベアラートークン1つで使えます。
すべてのリクエストで Authorization ヘッダーにベアラートークンを載せます。トークンは必ずサーバー側で保管してください。
サインインすると、有効な API キーを発行できます — 無料で、どのプランでも API アクセスが含まれています。
サインインしてキーを取得リクエスト数は API キーごとに制限されます。上限を超えると、次を返します： 429 Too Many Requests 、ヘッダー Retry-After. 上限はプランに応じて変わります：
| フォントを作成 · そのほか | |
| Starter | 60 · 600 / 分 |
| Pro | 200 · 2 000 / 分 |
| Agency | 600 · 6 000 / 分 |
もっと高いスループットが必要ですか？ プランをアップグレード.
テキストプロンプトや参照画像から、フォントファミリーをまるごと生成します。完了をポーリングで確認できるジョブが返ります。
| prompt必須 | 作りたいフォントを、自然な言葉で説明します。 Optional when reference_image_url is set. |
| reference_image_url | スタイルの参照画像（PNG/JPG/WEBP）— 直接アクセスできる公開 URL を指定します。画像自体は保存せず、リンクをそのままレンダーエンジンに渡します。Figma/Chrome プラグインのスクリーンショットからのフォント生成と同じ仕組みです。 |
| languages | ISO コードの配列 — デフォルトは ["en"]. Two-letter ISO codes, full list: GET /api/public/languages. |
| weights | 例： ["normal","bold","thin"]. |
| glyph_types | letters · digits · punct · special (default all). |
| model_tier | standard (Epicur ×1) · pro (Spinoza ×3) · ultra (Nietzsche ×5). |
フォントのステータスとダウンロード URL を取得します（TTF / WOFF2 / バリアブル）。
生成済みのフォントファイルを、指定した形式（ttf/otf/woff/woff2）でダウンロードします — Studio のダウンロードボタンで得られるものと同じファイルです。
サポートしているすべての ISO-2 言語コードを、文字体系ごとのグリフ数とテキストの方向とあわせて返します。有効な "languages" 配列を組み立てる際にお使いください。
直近100件のフォントジョブを返します — ステータス、モデル、ソース、各フォントのページへのリンク付きです。
生成は非同期です。generate に POST したあとは、次をポーリングしてください： GET /api/public/status?link=… ステータスが font_ready（または failed）になるまで、数秒おきに確認します。
| status | queued · processing · font_ready · failed |
| progress | { total, completed, failed } — 完了したグリフアトラスの数 |
| fonts | ttf/otf/woff/woff2 への直接 URL。次の場合に含まれます： status = font_ready. |
3〜5秒に1回のポーリングで十分です — フォントファミリー一式は、通常2分もかからず完成します。返されるフォントファイルの URL は固定で、以降は認証なしで取得できます。
エラーはすべて、統一された JSON 形式で返されます： { "success": false, "error": "…" }.
| 400 | 不正なリクエスト — 必須フィールドが不足しているか、値が不正です。詳しくは error を確認してください。 |
| 401 | 認証されていません — 不足しているか、不正な Authorization ヘッダー。 |
| 402 | 支払いが必要です — グリフの残量がありません。Plans ページでチャージしてください。 |
| 403 | アクセス禁止 — このリンクは別のアカウントのものです。 |
| 404 | 見つかりません — フォント ID が存在しないか、別のアカウントのものです。 |
| 429 | リクエストが多すぎます — レート制限に達しました。次の時間だけ待ってから、もう一度お試しください： Retry-After. |
| 500 | 内部エラー — こちら側で問題が発生しました。数秒おいて再試行すると、たいてい解決します。 |
{
"success": false,
"error": "Not enough glyphs. Top up: https://yofont.com/plans"
}
MCP（Model Context Protocol）を使うと、Claude Code、Cursor、Codex などの AI コーディングエージェントが、作業中に直接 YoFont を呼び出せます。会話の途中でフォントを生成し、ビルドの完了を待って、そのままプロジェクトにファイルを配置 — curl コマンドをコピー&ペーストする必要はありません。
MCP の各ツール呼び出しは、API タブに記載されているのと同じ REST エンドポイントに対する、薄く透過的なラッパーにすぎません — 認証もレート制限もバリデーションも同じです。MCP サーバーが行うことのうち、REST のドキュメントに載っていないものはありません。
下のプロンプトをコピーして、Claude Code、Cursor、Codex に貼り付けてください。YoFont の MCP サーバーの登録と確認は、エージェントが自分で行います — 設定ファイルを手で編集する必要はありません。
キーは、API タブの「認証」セクションから取得できます。
MCP クライアントの接続先に、次を指定します： https://yofont.com/api/public/mcp. Streamable HTTP トランスポート（JSON レスポンスモード）を使用します — 呼び出しごとに1つの JSON-RPC 2.0 リクエストを送るだけで、開いたままにするセッションやソケットはありません。
| トランスポート | Streamable HTTP（POST 経由の JSON-RPC 2.0）。メソッド：initialize、ping、tools/list、tools/call。 |
| 認証 | REST API と同じ API キーを使用します — 次のヘッダーとして、毎回のリクエストに含めてください： Authorization: Bearer yf_live_.... |
5つのツールがあり、API タブの REST エンドポイントとそれぞれ一対一で対応しています — MCP にしかない機能はなく、すべて通常の REST としても存在します。
プロンプトや参照画像から、まったく新しいフォントファミリーを生成します。ポーリング用のリンクとともに即座に応答を返します — 非同期のジョブであり、応答をブロックする呼び出しではありません。
| prompt | 自然な言葉によるスタイルの説明。reference_image_url を指定する場合は省略可能です。 |
| reference_image_url | 直接アクセスできる公開画像 URL — 呼び出し時に外部から取得できる状態であれば構いません。 |
| languages, weights, glyph_types, model_tier | REST エンドポイントと同じ形式・同じデフォルト値です — 詳しくは API タブの「フォントを作成」セクションをご覧ください。 |
フォントジョブのビルド進捗をポーリングします。準備が完了すると、ttf/otf/woff/woff2 への直接 URL を返します — これらは認証なしでそのまま取得できます。
| link必須 | generate_font が返すフォントへのリンクです。 |
フォントファイルのバイト列を MCP リソースとしてインラインで取得できるため、エージェントがそのままプロジェクト内のディスクに書き出せます。ファイルが極端に大きい場合は、通常の URL にフォールバックします。
| link必須 | generate_font が返すフォントへのリンクです。 |
| format | ttf · otf · woff · woff2 — default ttf. |
サポートしているすべての ISO-2 言語コードを、グリフ数とテキストの方向とあわせて一覧表示します — 有効な languages 配列を組み立てる際にお使いください。
直近100件のフォントジョブを一覧表示します — ステータス、モデル、ソース、各フォントのページへのリンク付きです。
MCP のツールは、背後にあるプロンプトの質でしか力を発揮できません。以下は、安定して良い結果につながる例です：
「子供向け教育アプリのために、親しみやすい丸みのあるサンセリフ系のフォントを、英語とスペイン語で、normal と bold のウェイトで生成して。ttf ファイルは ./public/fonts に保存して。」
雰囲気、言語、ウェイト、そして結果の保存先までを指定しているため、エージェントは一連の処理を自動で最後まで実行できます。
「これが以前のロゴのスクリーンショットです：https://example.com/logo.png — このスタイルに合うディスプレイ用のフォントを、ultra 品質で、英語のみで生成して。」
再現したい既存のスタイルがある場合、形容詞で説明するより参照画像の方が正確です — ヒーロー画像やディスプレイ用のフォントには、model_tier: ultra を使う価値があります。
「フォント 8WeheWlTl のステータスを確認して、準備ができたら教えて。それから woff2 の URL をちょうだい。」
シンプルなポーリングと報告の例です — 会話の前の方で始めたジョブの確認に向いています。
「YoFont はキリル文字とギリシャ文字のどの言語に対応していますか？ロシア語、ウクライナ語、ギリシャ語をカバーするフォントが必要です。」
エージェントに ISO コードを記憶から推測させるのではなく、list_languages を呼ばせましょう — コードの入力ミスによる generate_font の失敗を防げます。
「この参照画像から、ジオメトリック系のディスプレイフォントを生成して。完了を待ってから ttf をダウンロードして、Tailwind の設定にカスタム font-face として追加して。」
生成 → ポーリング → ダウンロードという3つのツールを、1つの指示でつなげています。エージェントに具体的な次の一歩まで渡す形です。
「自分のフォントを全部見せて。まだキュー待ちか、失敗しているものがあれば教えて。」
ダッシュボードを開かずに、プロジェクト全体のステータスを一気に確認したいときに便利です。
あなたの1回のリクエストが、パイプライン全体を動かします — ポーリングのループはエージェントが引き受け、あなたは結果を見るだけです。