画像生成AIを無料で利用する — Agnes AIの始め方
はじめに
最近、画像生成AIが注目されていますが、有料サービスが多く、個人利用にはハードルが高いと感じている方も多いのではないでしょうか。
そこで紹介するのが Agnes AI です。Agnes AIは、テキスト・画像・ビデオなどのマルチモーダルモデルを提供するAIプラットフォームで、無料プランでも画像生成が利用できます。
この記事では、Agnes AIの特徴と、無料で画像生成AIを利用する方法を初心者にもわかるように解説します。
Agnes AIとは何か
Agnes AIは、フルモーダリティ(全モダリティ)の基盤モデルに特化したAIカンパニーです。自社でテキスト・画像・ビデオ・推論などのモデルを学習し、開発者にOpenAI互換のAPIゲートウェイを提供しています。
主な特徴
- OpenAI互換API: OpenAIのAPIを使ったことがある方なら、そのまま使いやすい
- マルチモーダル対応: テキスト・画像・ビデオ・エージェントワークフローに対応
- 無料プランあり: アカウント作成だけで無料利用が可能
- 高品質モデル: PinchBenchで高精度を誇るモデルを提供
無料で利用できる理由
Agnes AIには「Free / デフォルト」という無料プランがあり、以下の利用が可能です:
| プラン | テキストモデル | 画像モデル | ビデオモデル |
|---|---|---|---|
| Free / デフォルト | 20 RPM(リクエスト/分) | 解像度別RPM制限あり | 1 RPM |
画像モデルの無料プラン制限は解像度によって異なります:
- 1K解像度: 20 RPM
- 2K解像度: 10 RPM
- 3K解像度: 1 RPM
- 4K解像度: 1 RPM
つまり、1分間に最大20枚の画像を生成できる計算になります。
利用可能な画像生成モデル
Agnes AIでは、主に2つの画像生成モデルが利用可能です:
| モデル名 | 特徴 | おすすめ用途 |
|---|---|---|
agnes-image-2.0-flash |
高速生成 | ポスター、商品画像、画像変換 |
agnes-image-2.1-flash |
高密度ビジュアル生成 | 詳細な構図、マーケティング素材、キャラクター画像 |
どちらもテキストから画像を生成する「Text-to-Image」と、画像を変換する「Image-to-Image」に対応しています。
インストール方法(初心者向け)
ここからが本題です。Agnes AIを無料で利用するための手順を、素人でも再現できるレベルで解説します。
前提条件
- PC(Windows/Mac/Linux)
- インターネット接続
- メールアドレス(アカウント作成用)
ステップ1:アカウント作成とAPIキーの取得
-
Agnes AIの公式サイトにアクセス
- インタernationalサイト: https://agnes-ai.com/
- 中国サイト: https://agnes-ai.cn/
-
「API Platform」でアカウントを作成
-
ダッシュボードからAPIキーを生成
- APIキーは「Bearerトークン」として使います
- APIキーは秘密情報です。公開リポジトリなどに絶対にコミットしないでください
ステップ2:Python環境の準備
Pythonがインストールされていない場合、まずインストールします。
Windowsの場合
-
Python公式サイトからインストーラーをダウンロード
-
インストール時に「Add Python to PATH」にチェックを入れる
-
コマンドプロンプトで確認:
python --version
Mac/Linuxの場合
ターミナルで以下のコマンドを実行:
# Mac(Homebrewが入っている場合)
brew install python3
# Ubuntu/Debian
sudo apt update
sudo apt install python3 python3-pip -y
ステップ3:プロジェクトフォルダの作成
画像生成用のプロジェクトフォルダを作成します。
mkdir agnes-image-demo
cd agnes-image-demo
ステップ4:仮想環境の作成(推奨)
システムのPython環境を汚さないよう、仮想環境を作成します。
# 仮想環境を作成
python3 -m venv venv
# 仮想環境を有効化
# Windows
venv\Scripts\activate
# Mac/Linux
source venv/bin/activate
有効化すると、プロンプトの先頭に (venv) が表示されます。
ステップ5:必要なパッケージのインストール
Agnes AIのAPIと通信するために、openai パッケージをインストールします。
pip install openai requests
ステップ6:APIキーの設定
APIキーを環境変数に設定します。
# Windows(コマンドプロンプト)
set AGNES_API_KEY=あなたのAPIキー
# Windows(PowerShell)
$env:AGNES_API_KEY="あなたのAPIキー"
# Mac/Linux
export AGNES_API_KEY="あなたのAPIキー"
セキュリティ上の注意: APIキーをソースコードに直接書かないでください。環境変数として設定することで、コードから鍵が漏れるのを防ぎます。
画像生成の使い方
方法1:curlコマンドで試す(一番簡単)
ターミナルで以下のコマンドを実行すると、画像が生成されます。
curl https://apihub.agnes-ai.com/v1/images/generations \
-H "Authorization: Bearer $AGNES_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "agnes-image-2.1-flash",
"prompt": "夕焼けの空の下、海辺を歩く猫。暖かい金色の光、写実的なスタイル",
"size": "1024x768"
}'
レスポンスには画像のURLが返されます。ブラウザで開くと画像が表示されます。
方法2:Pythonスクリプトで実行
プロジェクトフォルダに generate_image.py を作成します。
import os
import requests
import json
def generate_image(prompt, size="1024x768"):
"""画像を生成する関数"""
api_key = os.environ.get("AGNES_API_KEY")
if not api_key:
print("エラー: AGNES_API_KEY が設定されていません")
return None
url = "https://apihub.agnes-ai.com/v1/images/generations"
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
data = {
"model": "agnes-image-2.1-flash",
"prompt": prompt,
"size": size
}
response = requests.post(url, headers=headers, json=data)
if response.status_code == 200:
result = response.json()
if "data" in result and len(result["data"]) > 0:
return result["data"][0].get("url")
print(f"エラー: {response.status_code}")
print(response.text)
return None
# 使用例
if __name__ == "__main__":
prompt = "幻想的な浮遊都市、霧深い渓谷の上空、夜明け、シネマティックリアリズム"
image_url = generate_image(prompt)
if image_url:
print(f"生成された画像のURL: {image_url}")
スクリプトを実行:
python generate_image.py
方法3:OpenAI互換クライアントを使う
既にOpenAIのAPIを使っている場合は、クライアントの設定を変更するだけで利用できます。
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("AGNES_API_KEY"),
base_url="https://apihub.agnes-ai.com/v1"
)
response = client.images.generate(
model="agnes-image-2.1-flash",
prompt="サイバーパンクな東京の夜景、ネオンライト、雨上がりの道路",
size="1024x768"
)
print(response.data[0].url)
プロンプトの書き方のコツ
良いプロンプトを書くことで、より満足のいく画像が生成されます。
基本構造
[主題] + [詳細] + [スタイル] + [雰囲気]
例
| プロンプト | 生成される画像 |
|---|---|
| 「桜並木の通学路、春、水彩画風」 | 桜の花が舞う通学路 |
| 「テックなオフィス、フューチャリスティック、クリーン」 | 未来的なオフィス空間 |
| 「和風庭園、紅葉、日本画風」 | 紅葉が美しい庭園 |
よくあるエラーと対処法
| エラーコード | 原因 | 対処法 |
|---|---|---|
| 400 | リクエスト内容の誤り | パラメータの型や必須項目を確認 |
| 401 | 認証エラー | APIキーの値と形式を確認 |
| 429 | レート制限に達した | 少し時間を置いてから再試行 |
| 500 | サーバーエラー | リクエストを簡素化して再試行 |
制限事項と注意点
- レート制限: 無料プランは1分間あたりのリクエスト数が制限されています
- 商業利用: 利用規約を確認してください
- APIキーの管理: 公開しないこと。環境変数で管理すること
- モデルの変更: 利用可能モデルや制限は変更される可能性があります
まとめ
Agnes AIを使えば、無料で高品質な画像生成AIが利用可能です。
- OpenAI互換APIなので、既存のツールとの連携が容易
- 無料プランでも1分間に最大20枚の画像生成が可能
- セットアップは比較的簡単
まずは公式サイトでアカウントを作成し、この記事の手順に従って試してみてください。個人的な利用から始まり、必要に応じて有料プランに移行することもできます。