手牌画像API

GET/api/mahjong/tehai

麻雀の手牌を SVG 画像として返します。URL を <img> に入れるだけで表示できます。PNG が必要なときはジェネレーターのダウンロードを使うと、ブラウザの中で PNG にできます。

ブラウザで試す

手牌を作ると、その場で画像と埋め込みのコードが出ます。

手牌

萬子

筒子

索子

字牌

配色大きさ向聴数待ち

![麻雀手牌](https://janten.net/api/mahjong/tehai?tiles=123m456p789s11z&shanten=true)

Powered by [雀天](https://janten.net/)

GET /api/mahjong/tehai?tiles=123m456p789s11z&shanten=true

利用条件

無料・商用可。画像を載せるときは、雀天へのリンクを近くに置いてください（必須）。障害や悪用への対応で、予告なく止めることがあります。

HTML（そのまま貼れます）

<a href="https://janten.net/" target="_blank" rel="noopener">
  <img src="https://janten.net/api/mahjong/tehai?tiles=123m456p789s11z&tsumo=7z" alt="麻雀手牌 - 雀天">
</a>
<p><small>Powered by <a href="https://janten.net/" target="_blank" rel="noopener">雀天</a></small></p>

Markdown

![麻雀手牌](https://janten.net/api/mahjong/tehai?tiles=123m456p789s11z&tsumo=7z)

Powered by [雀天](https://janten.net/)

パラメータ

記事に貼られた URL を壊さないよう、読めない文字や知らない値は読み飛ばして描きます（計算の API は誤りを返します）。<img> から呼ばれて描けないときは、理由を書いた画像を返します。

名前	型	説明	例
`tiles`	牌	手牌（tiles と melds のどちらかは必須）。牌の書き方: 数字のあとに m（萬子）・p（筒子）・s（索子）・z（字牌。1 東 2 南 3 西 4 北 5 白 6 發 7 中）。0 は赤五（0m・0p・0s）。123m456p のようにまとめても、1m2m3m と 1 枚ずつでもよい	`123m456p789s11z`
`tsumo`	牌 1 枚	ツモ牌。手牌の右に少し離して描く	`7z`
`melds`	副露	副露（鳴いた面子）。種類:牌をカンマで区切る。種類は pon（ポン）・chi（チー）・kan（大明槓）・kakan（加槓）・ankan（暗槓）。例: pon:555z,chi:345s。kan と kakan は横向きの牌で描き分ける	`pon:555z,chi:345s`
`dora`	牌	ドラ表示牌。ドラに当たる牌を黄色で強調する	`2m`
`discards`	牌	捨て牌。手牌の下に描く	`1z2z3p8s`
`shanten`	true / false	true で向聴数を描く。手牌・ツモ・副露 × 3 で 13〜14 枚、同じ牌は副露を含めて 4 枚までのときだけ省略時 `false`	`true`
`waits`	true / false	true で待ち牌を描く。手牌と副露 × 3 がちょうど 13 枚で、同じ牌が 4 枚までのときだけ省略時 `false`	`true`
`theme`	選択	配色`greendarkwhiteclassic`省略時 `green`
`size`	選択	大きさ。ogp は 1200×630（SNS のカード用）`smallmediumlargeogp`省略時 `medium`
`nosort`	true / false	true で手牌を並べ替えずに描く省略時 `false`
`nobg`	true / false	true で背景を透明にする省略時 `false`

牌の書き方

数字のあとに色の文字。123m のようにまとめても、1m2m3m と 1 枚ずつでも同じです。計算の API とも共通です。

種類	文字	範囲	例
萬子	`m`	1〜9	123m = 一二三萬
筒子	`p`	1〜9	456p = 四五六筒
索子	`s`	1〜9	789s = 七八九索
字牌	`z`	1〜7	1z 東・2z 南・3z 西・4z 北・5z 白・6z 發・7z 中
赤五	`0`	0m・0p・0s	0m = 赤五萬（字牌に赤は無いので 0z は読み飛ばす）

サンプル

牌 1 枚の画像

GET /api/mahjong/tile — 牌 1 枚を WebP で返す。34 種・3 サイズ。1 年キャッシュ

名前	型	説明	例
`key`必須	牌 1 枚	牌（1m〜9m・1p〜9p・1s〜9s・1z〜7z。赤五は無い）	`5p`
`size`	選択	幅 36・60・100px`smallmediumlarge`省略時 `small`

点棒の画像

GET /api/mahjong/stick — 点棒（100・1,000・5,000・10,000 点）を PNG で返す。幅を指定できる

名前	型	説明	例
`denom`必須	選択	点棒の種類`1001000500010000`	`1000`
`w`	整数20〜1000	幅（px）。省略すると元の大きさ	`200`