コンテンツへスキップ
POST AI agent ready /v1/placeholder

プレースホルダー画像 API - 無料のカスタム サイズ

ワイヤーフレーム、プロトタイプ、開発用のプレースホルダー画像を作成します。 正確な寸法を指定し、テキストをオーバーレイし、背景色と前景色を選択して、SVG または PNG 出力を選択します。 フロントエンド開発中に最終アセットが利用できない場合に役立ちます。

Parameters

numberrequired

Image width in pixels.

numberrequired

Image height in pixels.

string

Text overlay centered on the image. Defaults to the dimensions (e.g. "600x400").

string

Background color as a hex code.

string

Text color as a hex code.

Code examples

curl -X POST https://api.botoi.com/v1/placeholder \
  -H "Content-Type: application/json" \
  -d '{"width":600,"height":400,"text":"Hero Banner","bg_color":"#f1f5f9","text_color":"#0f172a"}'

When to use this API

ワイヤーフレームプロトタイピング

プレースホルダー画像を Figma エクスポートまたは HTML プロトタイプにドロップすると、関係者は写真やイラストの準備ができる前にレイアウトと間隔を確認できます。

CMS コンテンツのステージング

各画像フィールドの正しいサイズのプレースホルダーをステージング CMS に設定します。 コンテンツ編集者は、最終的なアセットをアップロードする前に、各写真が占める正確なスペースを確認します。

自動テストフィクスチャ

画像アップロード フローの統合テストで、予測可能なプレースホルダー画像を生成します。 静的なフィクスチャ ファイルに依存せずに、寸法とファイル タイプをアサートします。

Frequently asked questions

最大画像サイズはどれくらいですか?
最大 4000x4000 ピクセルの画像をリクエストできます。 サイズが大きい場合は、SVG を生成し、それを独自のサーバーでラスタライズして、大きなペイロードを回避することを検討してください。
テキストオーバーレイにカスタムフォントを使用できますか?
API は、デフォルトのサンセリフ フォントでテキストをレンダリングします。 カスタム フォントのサポートは利用できません。 特定の書体が必要な場合は、SVG を取得し、マークアップ内の font-family 属性を更新します。
text パラメータを空のままにすると、どのようなテキストが表示されますか?
画像には、「600x400」などの寸法が表示されます。 これにより、開発時にサイジングを一目で確認することが容易になります。
SVG または PNG を選択する必要がありますか?
SVG はファイル サイズが小さく、ぼやけることなく任意の解像度に拡大縮小できます。 一部の電子メール クライアントなど、SVG を受け入れないシステムにアップロードするためにラスター ファイルが必要な場合は、PNG の方が適しています。
透明な背景を設定できますか?
透明度はサポートされていません。 同様の効果を得るには、ページの背景と一致する bg カラーを指定します。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs