Hermes Agent から HAI の画像生成を使えるプラグインを公開しました

Hermes Agent の画像生成バックエンドとして HAI を使えるプラグイン hai-hermes-agent-imagegen を公開しました。昨日提供を開始した画像生成 API /v1/images/generations と krea-2-medium-turbo を、Hermes の image_generate ツールから呼び出せます。プラグインは MIT ライセンスで、GitHub で公開しています。

チャットで「朝の水面に浮かぶ赤い紙船を水彩風で描いて」と頼むと、HAI で生成した PNG がそのまま添付で返ってきます。1K 画像 1 枚あたりの料金は約 ¥3（税込表示）で、API を直接呼ぶ場合と同じです。

できること

テキストから画像を生成する（text-to-image）
参照画像 1 枚をもとに画像を生成する（image-to-image）
横長・正方形・縦長の 3 種類のアスペクト比を選ぶ
生成した PNG を $HERMES_HOME/cache/images/ に保存し、チャットに添付する

仕組み

image_generate は Hermes に内蔵されているツールです。画像を実際に生成する部分はプロバイダーとして差し替えられるようになっていて、このプラグインは hai という名前のプロバイダーを追加します。

image_generate（Hermes 内蔵ツール）
        │
        └─ image_gen.provider の設定でプロバイダーを選ぶ
               ├─ （内蔵）各社のプロバイダー
               └─ （このプラグイン）hai  ← HAI / krea-2-medium-turbo

プラグインが使うのは Hermes の公開 API（agent.image_gen_provider）と Python 標準ライブラリ、Hermes に同梱されている openai パッケージだけです。Hermes の内部モジュールには依存していないので、Hermes をバージョンアップしても動き続ける作りにしています。

セットアップ

1. API キーを用意する

コンソールで API キーを発行し、環境変数 HAI_API_KEY に設定します。画像生成には有料の API キーが必要で、無料トライアルのキーは使えません。

export HAI_API_KEY=hai_xxxxxxxxxxxx

毎回設定し直さずに済ませたい場合は、Hermes の .env（~/.hermes/.env、またはアクティブなプロファイルの .env）に HAI_API_KEY=hai_... を追記してください。プラグインが .env を書き換えることはありません。

2. プラグインをインストールする

hermes plugins install HCloud-Ltd/hai-hermes-agent-imagegen

途中で有効化するか聞かれるので y と答えます（--enable を付けると確認なしで有効化します）。後から有効化する場合は hermes plugins enable hai-imagegen を実行してください。

3. プロバイダーを切り替える

hermes config set image_gen.provider hai
hermes config set image_gen.model krea-2-medium-turbo

config.yaml に直接書く場合は次のとおりです。

image_gen:
  provider: hai
  model: krea-2-medium-turbo

プロバイダーの切り替えはセッションごとに反映されます。CLI は再起動し、ゲートウェイやデスクトップアプリでは /reset で新しいセッションを始めてください。

使い方

設定が済んだら、エージェントに画像を頼むだけです。image_generate ツールが image_gen.provider: hai を見て、リクエストを HAI に送ります。

アスペクト比は Hermes の aspect_ratio の 3 つの値に対応しています。

aspect_ratio	生成サイズ	比
`landscape`（既定）	1536×1024	3:2
`square`	1024×1024	1:1
`portrait`	1024×1536	2:3

image_generate の image_url に画像（ローカルのパス・URL・data URL）を渡すと、その画像を参照して生成する image-to-image になります。参照画像は 1 枚までです。

注意点

Hermes から選べるアスペクト比は 3 種類です。 krea-2-medium-turbo 自体は 16:9 や 9:16 など 7 種類に対応していますが、Hermes 標準の 3 値に収まらない比はこのプラグインからは指定できません。これらが必要な場合は API を直接呼んでください
1 回の生成で作れるのは 1 枚です。複数枚が必要な場合は、その枚数だけ生成を頼んでください
定額プラン（HAI Go）の対象外で、クレジットから消費します
課金は生成した画像のトークン数に応じます。プロンプトのテキストには課金されず、生成に失敗したリクエストも課金されません

うまく動かないときの対処は README のトラブルシューティングにまとめています。画像生成 API そのものについては画像生成 API の告知とドキュメント、単価は料金ページに掲載しています。