基準フォントサイズから黄金比タイプスケールを生成
黄金比タイプスケールは、使い慣れた一つのフォントサイズを、古典的な比率phiに基づく完全な文字階層へ変換します。基準サイズと、その上下に必要な段階数を指定すると、デザイントークン、スタイルガイド、CSSに利用できる丸め済みの値が決定的な一覧として返されます。固定された見出しプリセットとは異なり、この生成器ではスケールの深さを指定でき、隣接する各値に完全な黄金比を適用します。既定のピクセル表記をそのまま使用することも、計算自体を変えずに別の単位を指定することもできます。
無料で実行
意味のある基準からスケールを組み立てます
最も大きな見出しを先に決めるのではなく、読書体験の中心になるサイズから始めてください。Webサイトでは通常、本文の文字サイズが基準です。プレゼンテーションでは一般的なスライド本文、印刷物ではポイントで指定した標準段落サイズが基準になる場合があります。生成器はこの数値を段階ゼロとして扱います。正の段階では約1.61803399のphiを掛け、負の段階では同じ比率で割ります。そのため、上下どちらの方向にも一貫した数列ができ、すべての値が基準と数学的に結び付きます。steps_upでは基準より大きい値の数を、steps_downでは基準より小さいキャプション、注記、補助ラベルなどの数を指定します。結果を実用的で確認しやすく保つため、どちらにも上限があります。たとえば基準を十六、上方向を三段階にすると、十六を概念上の正確な中心に保ちながら、より力強い表示用サイズを順番に作れます。単位欄は変換器ではなく表示ラベルです。十六ピクセルと十六ポイントは同じ数列を作りますが、用途は異なります。この区別により、物理単位と画面単位を文脈なしで変換できるように見せることを避けています。まず読者に適した読みやすいサイズを選び、その周囲の階層をスケールで検討してください。
生成値を読み取り、丸めて適用します
応答では、指定した最大の段階から最小の段階まで順番に値が並ぶため、文字階層として容易に確認できます。各行には符号付きの段階、数値サイズ、選択した単位付きの表記、そして基準より大きいか、基準そのものか、小さいかを示す役割が含まれます。段階ゼロは常に基準として示されます。formula欄には使用した正確な規則が残るため、デザイントークンの由来を文書化したり、後から生成テーマを見直したりする際に役立ちます。精度では各サイズの小数桁数を指定します。CSSや多くのデジタルデザインツールには小数三桁が適していますが、制約の強い画面や小数を意図的に避ける印刷仕様では整数が適する場合もあります。丸めは累乗計算の後にだけ行われるため、途中の段階で丸め誤差が蓄積しません。低い精度で近接する二つの小さい値が同じになった場合は、片方を手作業で変えて比率を崩すのではなく、精度を上げてください。出力は数学的に整合した出発点であり、すべてを使用する義務ではありません。小規模な製品では基準と二つの大きな値だけを使い、編集系サイトではほぼ全段階を使うこともできます。数値をfont_size_baseやfont_size_displayなどのトークンへ移し、段階番号をコメントに残せば、後任者も孤立した値の由来を推測せず、一貫して再生成できます。
古典的な比率と実用的なタイポグラフィを両立します
完全な黄金比は強い対比を生むため、表現力のある編集レイアウト、ブランドシステム、ポスター、ランディングページに適しています。一方、多くの連続レベルを高密度なアプリケーションに収める場合は、余白を使い過ぎることがあります。必要以上の階層が生じるときは段階数を減らし、実際の書体でサイズを確認してください。エックスハイト、ウェイト、幅、オプティカルサイズによって見た目の尺度は変わります。レスポンシブなレイアウトでは、ブレークポイントごとに異なる基準サイズを用いながら段階の割り当てを保てます。これにより、デスクトップ向けの表示サイズをスマートフォンへ押し付けず、画面間の統一感を維持できます。アクセシビリティでは、読みやすい本文、快適な行長、適切な行間、十分なコントラストが引き続き重要です。美しい比率でも、小さすぎる基準や不適切な書体は補えません。このツールが計算するのはフォントサイズだけであり、行間、字間、ウェイト、セマンティックHTMLは決定しません。これらは言語、媒体、書体、情報密度に応じて選ぶ必要があります。自動化する場合は、同じ入力を一回$0.002のAPIへ送信し、返されたスケールをデザイントークンと一緒に保存してください。計算にネットワーク、乱数、現在時刻を使わないため、同じリクエストからは常に同じ値が返ります。したがって、再現性と視覚的調和の両方が重要なビルドスクリプト、スナップショットテスト、文書生成、デザインシステム監査に利用できます。
活用例
デザインシステム用トークン
確立済みの本文サイズを中心に、再現可能なフォントサイズトークンの段階を作成します。
編集コンテンツの階層
長文レイアウト向けに、表示、見出し、本文、キャプション、注記の明確に異なるサイズを検討します。
テーマの自動生成
自動テーマ作成工程で、複数の基準サイズと単位に対応する決定的なスケールを生成します。
よくある質問
隣接する段階にはどの比率を使いますか?
すべての隣接段階に完全な黄金比φ = (1 + √5) / 2、約1.61803399を使用します。
出力に基準サイズは含まれますか?
はい。基準は段階ゼロとして、正の大きい段階と負の小さい段階の間に含まれます。
単位を変えると数値も変換されますか?
いいえ。単位は表示用ラベルです。ピクセル、rem、em、ポイントを交換可能な値としては扱いません。
何段階まで生成できますか?
上下それぞれゼロから十二段階まで指定でき、基準を含めて最大二十五件を生成できます。
APIリクエストの料金はいくらですか?
成功したAPIリクエスト一回につき$0.002です。対話的な検討にはブラウザー版もご利用いただけます。
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/str/golden-type-scale \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"base_size":16}'const res = await fetch("https://api.kit.forhosting.com/str/golden-type-scale", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"base_size": 16
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/str/golden-type-scale",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"base_size": 16
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/str/golden-type-scale", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"base_size":16}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"base_size":16}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/str/golden-type-scale", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"base_size": 16
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "str.golden_type_scale",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |