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

アバター API - 無料のアイデンティコン ジェネレーター

任意の文字列入力から決定的で視覚的に異なるアバターを作成します。 ユーザーの電子メール、ユーザー名、または ID を渡すと、API は対称 ID パターンを返します。 同じシードからは常に同じ画像が生成されるため、ファイルを保存せずに一貫したデフォルトのアバターとして使用できます。

Parameters

stringrequired

Input string used to generate the avatar pattern. Typically an email address or username.

number

Width and height of the output image in pixels.

string

Background color as a CSS color value. Defaults to #f0f0f0 if omitted.

Code examples

curl -X POST https://api.botoi.com/v1/avatar \
  -H "Content-Type: application/json" \
  -d '{"seed":"john@example.com","size":256,"bg_color":"#f0f0f0"}'

When to use this API

デフォルトのプロフィール写真

サインアップ時に電子メールを API に渡して、すべての新規ユーザーに固有のアバターを割り当てます。 ユーザーには一般的な灰色のシルエットではなくカラフルなアイデンティコンが表示されるため、コメント スレッドとメンバー リストが視覚的に区別できます。

Git コミット作成者のアイコン

カスタム Git ダッシュボードでコミット メッセージの横に ID アイコンのアバターを表示します。 作成者の電子メールをハッシュして、GitHub と GitLab がプロフィール写真のないユーザーに対して使用するパターンと一致する一貫したアイコンを生成します。

匿名のフォーラム参加者

セッション ID または匿名ハンドルからアバターを生成すると、アカウントがなくても、ディスカッション スレッドの各参加者が認識可能な視覚的アイデンティティを持つことができます。

Frequently asked questions

同じシードからは常に同じアバターが生成されますか?
はい。 生成アルゴリズムは決定的です。 今日「john@example.com」を渡すと、来月にはまったく同じパターンが返されます。 これを利用すると、画像をキャッシュせずに一貫した表示を行うことができます。
これは Gravatar とどう違うのですか?
Gravatar では、ユーザーは写真を Gravatar.com にアップロードする必要があります。 この API は、ユーザーのアクションを必要とせずに、任意の文字列から幾何学模様を生成します。 スタンドアロンのデフォルト アバターまたは Gravatar フォールバックとして機能します。
色をカスタマイズできますか?
視覚的な一意性を確保するために、色はシード文字列から派生します。 API はカスタム パレットを受け入れません。 ブランド固有の色が必要な場合は、SVG を取得して塗りつぶしの値を置き換えます。
リクエストできる最大のサイズはどれくらいですか?
最大 512x512 ピクセルをリクエストできます。 SVG 出力の場合、サイズ パラメーターに関係なく、画像は任意の表示サイズに合わせて拡大縮小されます。
シード値は保存または記録されますか?
いいえ。シードはメモリ内でハッシュされてパターンが生成され、破棄されます。 API は、入力を保存、記録したり、第三者に送信したりすることはありません。

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