AnyPlaceholder.com の使い方

AnyPlaceholder.com は、デザイナーや開発者がカスタムプレースホルダー画像やダミーテキストを即座に生成できるサービスです。ブラウザで操作できる UI と、簡易な REST API の 2 通りの利用方法があります。

1. Web UI を使う

画像ジェネレーターまたはテキストジェネレーターを開きます。
パラメータをお好みに調整します。
生成された URL をコピーするか、結果をダウンロード/コピーします。

2. HTTP API を使う

/placeholder エンドポイントに下記クエリパラメータを付けて GET リクエストを送ります。

パラメータ	必須	説明	例
width	必須	画像幅 (px)	300
height	必須	画像高さ (px)	200
bg	任意	背景色 (16 進数, # なし)。4 桁 / 8 桁の場合末尾はアルファ値 (0–f, 00–ff)	09f または 0099ff または 09f8
color	任意	文字色 (16 進数, # なし)。4 桁 / 8 桁の場合末尾はアルファ値 (0–f, 00–ff)	fff または fffc
text	任意	表示テキスト。デフォルトは "{width}x{height}"	Hello
fontSize	任意	フォントサイズ (px)	24
radius	任意	角丸 (px)	8
format	任意	出力形式: svg (既定) / png / jpg / webp	png
retina	任意	`1` を指定すると @2x 画像を生成	1

例

https://anyplaceholder.com/placeholder?width=400&height=300&bg=333&color=fff&text=Demo&format=png

3. テキストプレースホルダー API

/text エンドポイントに下記クエリパラメータを付けて GET リクエストを送ります。

パラメータ	必須	説明	例
paragraphs	任意	段落数 (1-50, 既定 3)	5
sentences	任意	段落あたりの文数 (1-15, 既定 5)	3
format	任意	出力形式: text (既定) / html / json	json
lang	任意	言語: en (既定) / ja	ja

例

https://anyplaceholder.com/text?paragraphs=3&sentences=5
https://anyplaceholder.com/text?paragraphs=2&format=html&lang=ja
https://anyplaceholder.com/text?paragraphs=1&sentences=3&format=json

4. アバター API

/api/avatar エンドポイントに GET リクエストを送ると、入力した文字からアバター画像を生成します。

パラメータ	必須	説明	例
text	任意	そのまま表示する文字。最大12文字 (既定 "AP")	JD
size	任意	画像サイズ (px) (16-1000, 既定 128)	128
shape	任意	形状: circle (既定) / square	circle
bg	任意	背景色 (16 進数, # なし)。既定では文字から自動で色を決定	4f46e5
color	任意	文字色 (16 進数, # なし, 既定 fff)	fff
format	任意	出力形式: svg (既定) / png	png

例

https://anyplaceholder.com/api/avatar?text=JD&size=128&shape=circle&format=png

5. ダミーデータ API

/api/data エンドポイントに GET リクエストを送ると、JSON または CSV 形式のダミーデータを生成します。

パラメータ	必須	説明	例
type	任意	データ種別: users (既定) / posts / todos / products	users
count	任意	レコード数 (1-100, 既定 10)	10
lang	任意	言語: en (既定) / ja	ja
format	任意	出力形式: json (既定) / csv	json
seed	任意	決定論的な出力のためのシード値 (既定 1)	1

例

https://anyplaceholder.com/api/data?type=users&count=10&lang=ja&format=json

6. チャート API

/api/chart エンドポイントに GET リクエストを送ると、棒・折れ線・円グラフの画像を生成します。

パラメータ	必須	説明	例
type	任意	グラフ種別: bar (既定) / line / pie	bar
points	任意	データ点の数 (2-20, 既定 6)	8
width	任意	画像幅 (px) (100-2000, 既定 600)	600
height	任意	画像高さ (px) (100-2000, 既定 400)	400
seed	任意	決定論的な出力のためのシード値 (既定 1)	1
title	任意	グラフのタイトル (任意)	Sales
format	任意	出力形式: svg (既定) / png。PNG はサイズ制限のため最大 1000px に制限されます	svg

例

https://anyplaceholder.com/api/chart?type=bar&points=8&title=Sales&format=svg

7. PDF API

/api/pdf エンドポイントに GET リクエストを送ると、複数ページのダミー PDF を生成します。

パラメータ	必須	説明	例
pages	任意	ページ数 (1-20, 既定 1)	3
title	任意	文書タイトル (既定 "Dummy PDF")。ASCII / ラテン文字のみ対応 — 組み込みの Helvetica フォントは日本語を埋め込めません	Sample

注意: title は ASCII / ラテン文字のみ対応しています。組み込みの Helvetica フォントは日本語 (およびその他の非ラテン文字) を埋め込むことができません。

例

https://anyplaceholder.com/api/pdf?pages=3&title=Sample

8. 地図 API

/api/map エンドポイントに GET リクエストを送ると、架空の都市を描いた地図画像を返します。10種類のビジュアルスタイルで事前生成された地図を、要求された寸法にリサイズして配信します。

パラメータ	必須	説明	例
width	任意	画像幅 (px) (100-2000, 既定 600)	800
height	任意	画像高さ (px) (100-2000, 既定 400)	600
seed	任意	決定論的なシード値。スタイルごとに 50 都市から1つを選びます (既定 1)	42
scheme	任意	ビジュアルスタイル。省略時はシードから自動選択。Default / Apple / AppleDark / Assassin / Google / GoogleNoZoom / Paper / SubtleGrey / UltraLight / Wy	Apple
format	任意	出力形式: jpg (既定・最小) / webp / png	jpg

この地図は装飾用です。各都市は架空のもので、実在の場所を表すものではありません。

例

https://anyplaceholder.com/api/map?width=800&height=600&seed=42&scheme=Apple

地図画像は ProbableTrain's MapGenerator（LGPL-3.0 / GPL-3.0）で事前生成しています。

9. 全エンドポイント共通の注意事項

上記すべての API に共通する点は次のとおりです。

すべてのエンドポイントは決定論的です。同じ URL は常に同じ出力を返し、レスポンスは 24 時間キャッシュされます。
レスポンスには CORS ヘッダー (Access-Control-Allow-Origin: *) が含まれるため、ブラウザから直接呼び出せます。
生成される各レスポンスは 40 KB 以内に収まります。

10. ライセンス / 帰属表示

生成された画像は商用利用を含め無料でご利用いただけます。帰属表示は不要ですが、リンクでの紹介を歓迎します。

11. お問い合わせ

サポートが必要な場合は X (旧 Twitter) の @_Kit_Ok_ までご連絡いただくか、下記の Buy Me a Coffee からご支援ください。