API の使い方

このサイトの絵柄は、プログラムから JSON で読めます。読み取りだけで、登録は要りません。

使う URL は 2 つ

GET https://manga.akiba.tokyo.jp/v1/tree

公開中のすべての枝（1〜3段目）。各枝の id・parent（親の id。1段目は null）・level・title・summary・thumbnail_url。

GET https://manga.akiba.tokyo.jp/v1/styles/{id}

1 つの枝の絵柄。プロンプト、見本の絵、1 つ下の段の一覧（children）が入っています。

どちらも ?lang=en を付けると、名前と説明が英語になります（既定は日本語）。プロンプトは常に日本語と英語の両方が入っています。

絵柄の選び方

1段目の一覧は、/v1/tree のうち parent が null の枝です。
/v1/styles/{1段目の id} の children から 2段目を選び、/v1/styles/{2段目の id} を読みます。
その children から 3段目を選びます。どの段で止めてもかまいません（下の段はおまかせになります）。

画像生成での使い方

prompt.en（または prompt.ja）を絵柄の指定として使い、その後ろに描きたい人物・場面を書き足します。prompt には題材は入っていません。
avoid は、絵に入れてはいけない物（文字・フキダシ・効果音の描き文字・コマ枠・署名・透かし・色）です。
samples[reference].url の見本の絵を、絵柄の参考画像として渡せます。
従来方式の3段目の prompt は「2段目の言葉＋『仕上げの絵柄（上と違う所はこちらに従う）: 』＋ 3段目の言葉」です。食い違う所（ベタの量・頭身など）は 3段目の言葉に従ってください。

Genko Studio から使う

枝のページを ?client=genko 付きで開くと「この絵柄を使う」が出て、genko://use-style?id={id} を開きます。普通のブラウザでは、かわりにその枝の API の URL をコピーできます。

そのほか

HTTPS で、誰でも読めます。CORS は GET だけ許可しています。
限定公開にしているときは Authorization: Bearer <トークン> が要ります（無いと 401）。
無い id や公開していない枝は 404（{"error": "not found"}）。GET 以外は 405 です。
従来の見本は768×1024のJPEGです。説明用2枚組は元の縦横比を保ち長辺1024以下、白黒枝はL・彩色枝はRGB。縮小画像は384×512で、2枚組は余白を付けて全体を残します。
見本の絵か言葉が変わると version が上がり、updated_at が変わります。

/v1/tree の nodes[] の欄

id: 枝の id（英小文字・数字・ハイフン）。
parent: 親の枝の id。1段目は null。
level: 段（1〜3）。
title: 表示名。
summary: 一言の説明。
thumbnail_url: その枝の見本の縮小画像（384×512）。見本が無ければ null。
path: 1段目からこの枝までの表示名の並び（最後がこの枝）。例: ["ギャグ漫画", "シュール", "ゆるい手描きの落書き風"]。同じ表示名の枝がほかの分類にもあるので、名前だけで絵柄を決めない。

/v1/styles/{id} の欄

id: 枝の id。
path: 上の段（1段目から親まで）の id と表示名の並び。上の段から順。1段目は空の配列。
level: 段（1〜3）。
title: 表示名。
summary: 一言の説明。
expression: "mono" は白黒、"color" はカラー。既存の枝は mono のまま。
model: id は "chatgpt-image"。version は見本を作った画像生成のモデル名（見本が無ければ null）。
prompt: ja・en・tags。共通の言葉＋その枝までの言葉（1段目は 1段目だけ、2段目から下は 2段目から）。題材は入っていない。
avoid: 絵に入れてはいけない物。
samples: 見本の絵。従来はupper_bodyの1枚。更新した枝はrepresentative（代表）とapplication（別の場面）の2枚。各要素はsubject・url・prompt（日英の実際の生成文）。
reference: 絵柄の基準として一番よい見本が samples の何番目か（0 から）。見本が無ければ null。参照画像の枚数ではない。
license: generated は常に true、artist_names は常に false、terms は利用条件。
version: 見本の絵か言葉が変わると上がる番号。
updated_at: 最後に変わった日時（UTC）。
children: 公開中の 1 つ下の段（id・title・summary・thumbnail_url）。3段目は空。
comparisons: 比較の絵（2026-10-18 追加）。見本を作ったプロンプト（samples[0].prompt.en）を変えずに別の画像生成モデルで描いた絵。model（id・version・name）、url、prompt_from、settings（seed・steps・cfg_scale・sampler・size・negative_prompt）、created_at。絵柄の指定ではない（参考画像には samples[reference] を使う）。無い枝は空の配列。足しても version は変わらない。