mojiemoji

エンドポイント

• GET /emoji — クエリでテキストを指定（q または text が必須）
• GET /emoji/{text} — パスにテキストを埋め込み

出力仕様・制約

• 画像サイズ: 128 × 128 px（PNG / GIF 共通）
• ファイルサイズ上限: 128 KB を超えると HTTP 422 を返す（src/emoji/pipeline.rs）
• 最大文字数: 15 文字（5 列 × 3 行のグリッドレイアウト）
• フォントは Worker bundle に埋め込み済みなのでフェッチ遅延はない（Issue #215）

絵文字（Unicode emoji）対応

単一絵文字の PNG 組み込みと、入力解釈の注意です。

• Noto Color Emoji 由来の 152 codepoint を PNG glyph として Worker bundle に埋め込み済み（Issue #288）
• 入力テキストが対応絵文字 1 文字だけの場合は fontdue を bypass してカラー描画します
• VS-16（U+FE0F）が末尾に付いた入力（例: ❤️ = U+2764 + U+FE0F）は VS-16 をストリップして 1 文字判定するため対応します
• 混在入力（例: Hi😂） / ZWJ シーケンス（😮‍💨） / keycap（0️⃣） / flag（🇯🇵）は MVP 対象外で .notdef（豆腐）になります

例: /emoji/😂

多行テキスト

改行を含むテキストは、q クエリの値に %0A を含めるか、/emoji/{text} パスのテキストに URL エンコードした改行を含めて指定できます。line_height と align で行間と揃え方を制御できます。

例: /emoji?q=AA%0ABB&line_height=1.2

クエリ（任意）

• color — 文字色。プリセット名（例: vivid-red）、または 6桁/8桁の 16 進（例: FF5733）
• outline — 省略可。縁取りの色（color と同形式。加えて darker / lighter で文字色相対）
• outline_width — 省略可。縁取りの太さ 0…4 px（0 で無効。既定 0。PNG / GIF 共通。適用順はレイアウト → 反転 → 縁取り → グラデーション → 背景）
• background — キャンバス背景色（省略時は透明）。transparent / none、16進、color と同じ名前付きプリセット
• font — 下記のいずれか（省略時は gothic / M+ 1 Bold w700）
• animation — 下記のいずれか（省略時は PNG。指定時はループ GIF）
• speed — アニメーション速度プリセット（animation 指定時のみ。省略時は現行互換の 40ms/frame）
• gradient — 省略可。vertical でベースラスタに縦方向の明るさグラデーションをかける（PNG / GIF 共通）。背景を塗ったあとも、グラデーションは文字ピクセルにのみ適用されます
• flip — 省略可。ベースラスタの静的な左右／上下反転（gradient より先に適用。PNG / GIF 共通）。animation=patapata のフレーム毎の反転とは別
• padding — 省略可。プリセット名（none/minimal/default/round）または整数 px 値（0〜32）で文字周囲の余白を制御（PNG / GIF 共通、省略時は 0px）
• line_height — 省略可。複数行テキストの行間を制御する浮動小数 (0.3〜2.0、省略時は 0.68)。PNG / GIF 共通で、単一行テキストでは効果なし
• align — 省略可。複数行テキストの横方向配置 (left/center/right/justify、省略時は center)。justify は MVP では center 相当にフォールバック

speed（許容値）

• step — コマ送り（1 ループ 2.0 秒相当、frame delay 80ms）
• slow — ゆっくり（1 ループ 1.3 秒相当、frame delay 50ms）
• normal — ふつう（1 ループ 0.8 秒相当、frame delay 30ms）
• fast — はやい（1 ループ 0.3 秒相当、frame delay 10ms。60 FPS 上限適用）

省略時は現行互換の 40ms/frame（1 ループ約 960ms）。animation が指定されない場合は無視されます。

background（許容値）

• transparent / none — 透明（ASCII 大文字小文字無視）。クエリ省略時も同じ
• 16進・名前付きプリセット — color と同じ（例: vivid-blue、#FF0000）

outline（許容値）

• 色は color と同じ（16 進・プリセット）。darker / lighter は文字色に対し既存の明るさ/暗さ補正（強さ 0.3）を縁取り色に用いる
• outline_width は整数 0…4。0 または outline 未指定なら縁取りなし

color（許容値・エイリアス）

• Grayscale: gray-0（黒）、gray-1、gray-2、gray-3、gray-4（白）。grey-* は gray-* のエイリアス
• Vivid: vivid-red、vivid-orange、vivid-yellow、vivid-green、vivid-cyan、vivid-blue、vivid-pink
• Pastel: pastel-red、pastel-orange、pastel-yellow、pastel-green、pastel-cyan、pastel-blue、pastel-pink
• Dark: dark-red、dark-orange、dark-yellow、dark-green、dark-blue、dark-purple、dark-magenta
• Common（短縮名）: red（vivid-red と同値）、yellow（vivid-yellow と同値）、orange / green / cyan / blue / pink（それぞれ #FFA500 / #008000 / #00FFFF / #0000FF / #FFC0CB の独立色。vivid-* 系列とは色味が異なります）

名前は大文字小文字を区別しません。いずれのプリセットにも一致しない場合は 6桁/8桁の 16 進として解釈します。

gradient（許容値）

• vertical — 上寄りを明るく、下寄りを暗くする 3 ストップ（MVP）

flip（許容値）

• none（省略時）— 反転なし
• h / horizontal — 水平反転（ASCII 大文字小文字無視）
• v / vertical — 垂直反転
• hv / both — 両軸反転

padding（許容値）

• none — 0 px（余白なし、省略時の既定）
• minimal — 4 px（他絵文字との視覚的分離に有効）
• default — 8 px（標準的な内側余白）
• round — 16 px（角丸背景付きで使う前提の余白）
• 整数 0〜32 — 直接 px 指定（上限 32 = CANVAS の 1/4）

プリセット名と整数 px の両表記はキャッシュ上同一キーに正規化されます（例: padding=minimal と padding=4 は同じキャッシュエントリ）。

line_height（許容値）

• 浮動小数 0.3〜2.0 — 値が大きいほど行間が広がる
• 既定値 0.68（複数行テキストで glyph どうしが適度に密になる値）

単一行テキストでは視覚的な差は出ません。キャッシュキーは小数点以下 2 桁で丸められ、省略時と既定値指定時は同一キーになります。

align（許容値）

• left — 左揃え
• center (既定値) — 中央揃え
• right — 右揃え
• justify — 両端揃え (MVP では center にフォールバック)

centre は center のエイリアスです。単一行テキストでは視覚的な差は出ません。

font（許容値・エイリアス）

• megamoji 互換 preset: gothic（既定）、gothic-bold、maru、maru-bold、mincho、dela、akzk、zero、kurobara、hachimaru、chikara、tamanegi、pixel、toge、rampart
• optional: noto / noto-sans-jp — kana-only Noto Sans JP subset; kanji glyphs borrow embedded M+（gothic と同一の M+ 1 Bold subset）.
• legacy alias: mplus1p-black、mplus1p、mplus1p_black、mplus、gothic-bold など → gothic（同一フェイス、Megamoji 互換の別名）

animation（許容値）

• tate_scroll — 縦スクロールのループ GIF
• yoko_scroll — 横方向への通過（シームレス繰り返し）ループ GIF
• ekken — 謁見のループ GIF
• tate_ekken — 謁見バーティカル（上下半分）のループ GIF
• bane — スケールが正弦で変化するループ GIF
• gatagata — 手ブレ風に横揺れするループ GIF
• bure — グリッチ状のゆがみループ GIF
• chuuou_zoom — 中央へのズーム（一方向）のループ GIF
• kirari — ホイル状ハイライトが掠めるループ GIF
• kira — 色相をキラキラ周回させるループ GIF
• tenmetsu — ストロボ点滅のループ GIF
• shuchusen — 集中線オーバーレイのループ GIF
• kaiten — ルーレット状に回転するループ GIF
• neruneru — 円運動（ねるねる）のループ GIF
• patapata — 水平反転のループ GIF
• yurayura — 振り子のように揺れるループ GIF
• mabataki — 点滅するループ GIF
• bakusan — 放射状パーティクルのループ GIF
• norinori — せん断変形のループ GIF
• mochimochi — もちもちと弾むループ GIF
• mozaiku — モザイクのループ GIF
• poyoon — ぽよーんと跳ねるループ GIF
• yatta — 反転＋回転＋振動のループ GIF
• tatemoya — 縦方向ブラーのループ GIF
• nami — 波状に歪むループ GIF
• yokomoya — 横方向ブラーのループ GIF
• zairu — ザイルのループ GIF
• lighter_zairu — 軌跡を文字色より薄く描き中央に静止主文字を重ねるループ GIF (zairu の可読性向上版)
• darker_zairu — 軌跡を文字色より濃く描き中央に静止主文字を重ねるループ GIF (zairu の可読性向上版)
• zanzo — 残像（ズームブラー）のループ GIF
• chirichiri — 各ピクセルのアルファをランダムに揺らすチラつきノイズのループ GIF
• disco — ディスコボール風のループ GIF
• psycho — 走査線状に色帯が変化するサイケデリック風のループ GIF
• kage_kaiten — 影が円運動するループ GIF
• kage_bokashi — 影のぼかしと明るさが呼吸するループ GIF
• kage_neon — 色相が周回するネオン風の影のループ GIF

URL 例とプレビュー

左がパス文字列、右がその URL を src にした画像です。日本語や改行は q クエリの値をパーセントエンコードするか、パスをエンコードしてください。

422 は「128KB 以下の PNG/GIF に収められなかった」ときに返ります（src/emoji/pipeline.rs）。ループ GIF はフレーム数が多く、長い日本語のまま animation を付けると超えやすいです。下の GIF 例は短文で、各 animation をフォント・テキスト・色のバリエーション付きで示しています。GET /emoji だけ（q / text なし）は 400 です。

テキストのみ

color / background / font / animation / gradient / outline

各 animation の例では、フォント・テキスト・色の組み合わせを変えて示しています（一部はデフォルトフォントのまま）。

Claude Code plugin

本サービスを Claude Code から呼び出す公式プラグイン jozobeer/mojiemoji-plugin を Claude Code marketplace で配布しています。GitHub markdown 向けの日本語スタンプ装飾を skill / agent / hook 経由で自動化できます。

インストール（Claude Code 内で実行）:

/plugin marketplace add jozobeer/mojiemoji-plugin
/plugin install mojiemoji-github@mojiemoji-plugin