mcpField
A
agnes-free-image

agnes-free-image

github.com/kangarookingクリエイティブ・メディア200131 回インストール21 週間前に更新
リポジトリ

agnes-free-image について

Agnes API 経由で agnes-image-2.1-flash を使い、画像を生成・変換するスキルです。プロンプト作成の指針と、リクエスト、dry-run、返された画像URLの保存に使う Python ヘルパーを備えています。

主な機能

  1. 01テキストからの画像生成
  2. 02公開URLを使った画像変換
  3. 03プロンプト構成の指針
  4. 04dry-runによるリクエスト検証
  5. 05返却画像のローカル保存

活用シーン

  1. 01文章のシーン描写から画像を作成
  2. 02構図を保ちながら参考画像を別のスタイルに変換
  3. 03API呼び出し前のリクエストパラメーター確認
  4. 04生成画像をローカルディレクトリに保存

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/kangarooking/agnes-free-model-skills --skill agnes-free-image

インストール後、Claude Code で/agnes-free-imageを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
api.md
scripts/
agnes_image.py

詳細

Agnes Free Image

agnes-image-2.1-flashで画像を生成または変換するには、このスキルを使用します。

認証情報のルール

API キーは環境変数から読み取ってください。プロンプト、スクリプト、スキルファイル、コミット、シェルの履歴にキーをハードコードしないでください。

推奨する変数：

export AGNES_API_KEY="..."

フォールバックとしてAGNES_TOKENも使用できます。

クイックスタート

テキストから画像を生成する：

python3 scripts/agnes_image.py generate \
  --prompt "A luminous floating city above a misty canyon at sunrise, cinematic realism" \
  --size 1024x768 \
  --output-dir ./outputs/agnes-free-image

公開画像 URL を使って画像から画像を生成する：

python3 scripts/agnes_image.py generate \
  --prompt "Transform the scene into a rain-soaked cyberpunk night while preserving the composition" \
  --image-url "https://example.com/input.png" \
  --size 1024x768 \
  --output-dir ./outputs/agnes-free-image

API を呼び出さずにリクエストの形式を検証する：

python3 scripts/agnes_image.py generate \
  --prompt "A detailed AI workflow dashboard poster, clean editorial style" \
  --size 1024x1024 \
  --dry-run

プロンプトのパターン

テキストから画像を生成する場合は、次の構成を使用します。

[Subject] + [Scene / Environment] + [Style] + [Lighting] + [Composition] + [Quality Requirements]

画像から画像を生成する場合は、変更する内容と変更せずに残す内容の両方を指定します。

ワークフロー

  1. リクエストがテキストから画像を生成するものか、画像から画像を生成するものかを判断します。
  2. 曖昧なビジュアルのリクエストを、被写体、環境、スタイル、照明、構図、詳細度を含む具体的なプロンプトにします。
  3. scripts/agnes_image.py generateを使用します。複雑なプロンプトや参照画像を使う場合は、最初に--dry-runを実行してください。
  4. レスポンスにダウンロード可能な URL が含まれている場合は、--output-dirを使って画像をローカルに保存します。
  5. 生のレスポンス形式や高度なパラメーターが必要な場合は、references/api.mdを参照してください。

メモ

  • エンドポイント：POST https://apihub.agnes-ai.com/v1/images/generations
  • モデル：agnes-image-2.1-flash
  • ヘルパーのデフォルトサイズは1024x768です。
  • 画像から画像を生成する場合、入力画像は URL からアクセスできる必要があり、extra_body.imageに指定されます。
  • ヘルパーは、extra_body.response_format: "url"を指定して URL 形式のレスポンスを要求します。

参考資料

リクエストのフィールド、レスポンスの処理、または元のドキュメントにあるプロンプト例が必要な場合は、references/api.mdを参照してください。

コメント

Markdown 対応