メインコンテンツまでスキップ

画像生成

Elftia の画像生成機能では、テキストの説明（プロンプト）から AI を使って画像を生成できます。複数のプロバイダー、バッチ生成、カスタムパラメーター、レート制限時の自動リトライをサポートしています。

ユースケース​

  • テキストの説明からコンセプトデザイン、イラスト、アートワークを生成する
  • チャット中に参考画像やイラストをすばやく生成する
  • 複数の画像をバッチ生成し、最適な結果を選ぶ
  • 同じプロンプトを異なるスタイルやパラメーターで複数回試す

対応プロバイダー​

プロバイダーモデル例説明
GeminiGemini VisionGoogle のマルチモーダル画像生成
OpenAIDALL-E 3、DALL-E 2、gpt-image-1OpenAI の画像生成 API
Vertex AIImagenGoogle Cloud の画像生成サービス
カスタムプロバイダーカスタムOpenAI 形式と互換性のあるサードパーティサービス

プロバイダーの設定​

手順​

  1. 設定 > メディアプロバイダー > 画像を開く
  2. リストからプロバイダーを選択する（例: OpenAI）
  3. プロバイダーの API Key を入力する
  4. （任意）API エンドポイントのアドレスを変更する（カスタムプロバイダーやプロキシでは必要）
  5. デフォルトモデルを選択する
  6. 保存をクリックする

プロバイダー設定表​

設定説明必須
API Keyプロバイダーの API キーはい
API エンドポイントカスタム API アドレス（既定では公式アドレス）いいえ
デフォルトモデル生成時に既定で使用されるモデルいいえ
有効このプロバイダーを有効にするかどうかはい

画像の生成​

手順​

  1. チャット UI またはメディア生成インターフェースで、画像生成機能を選択する
  2. 使用するプロバイダーとモデルを選択する
  3. プロンプト入力欄に画像の説明を入力する
  4. 生成パラメーターを設定する（下のパラメーター表を参照）
  5. 生成ボタンをクリックする
  6. 生成が完了するまで待ち、結果をプレビューする

生成パラメーター​

パラメーター説明オプション / 範囲
プロンプト生成したい内容を説明する任意のテキスト
サイズ生成画像の解像度モデルによって異なる。例: 1024x1024、1792x1024
枚数一度に生成する画像数1〜10（プロバイダーの制限によって異なる）
スタイル画像スタイルvivid、natural など
品質画像品質standard、hd など

:::tip プロンプトのヒント 良いプロンプトには、次の要素を含めると効果的です。

  • 主題: 画像の主な内容を説明する
  • スタイル: 希望するアートスタイル（写実的、水彩、アニメなど）
  • 詳細: 照明、構図、色調、その他の詳細
  • ネガティブプロンプト: 表示させたくない要素（一部のプロバイダーでサポート） :::

バッチ生成​

Elftia は同時実行制御付きのバッチ画像生成をサポートしているため、複数の画像を生成しても API に過剰な同時リクエストを送らずに済みます。

動作​

  • 枚数が 1 より多い場合、システムは同時実行数の制限に従ってリクエストを自動的にバッチ処理する
  • 既定の同時実行数は 3 で、グローバル設定から調整できる
  • 各画像は独立して生成されるため、一部が失敗しても他の画像には影響しない

自動リトライ​

API のレート制限（HTTP 429 エラー）やその他の一時的なエラーが発生した場合、システムは自動的にリトライします。

動作説明
リトライ回数既定では 2 回。グローバル設定から調整できる
リトライ間隔指数バックオフ: 1 回目のリトライは 1 秒後、2 回目は 2 秒後で、その後は毎回倍増
レート制限の処理429 エラーが検出されると、ランダムジッター付きのより長いバックオフ時間が適用される

結果の管理​

生成された画像は次のように扱われます。

  1. チャットメッセージ内に直接表示される
  2. ローカルファイルシステムに自動保存される
  3. 後で簡単に取得できるよう、生成履歴に記録される

アクションオプション​

  • 保存 — 指定したディレクトリに画像を保存する
  • コピー — 画像をクリップボードにコピーする
  • お気に入り — 画像をコレクションに追加する
  • 再生成 — 同じパラメーターで再度生成する

カスタムプロバイダーの追加​

使用している画像生成 API が OpenAI 形式と互換性がある場合、カスタムプロバイダーとして追加できます。

  1. 設定 > メディアプロバイダー > 画像を開く
  2. カスタムプロバイダーを追加をクリックする
  3. 次の情報を入力する。
フィールド説明
名前プロバイダーの表示名
API エンドポイントAPI ベースアドレス
API Key認証キー
モデルリスト利用可能なモデル ID の一覧
  1. 保存後、画像生成時にそのプロバイダーを選択できるようになる

よくある質問​

質問解決策
生成リクエストが 401 を返すAPI キーが無効または期限切れです。確認して更新してください
生成リクエストが 429 を返すAPI のレート制限に達しています。システムが自動的にリトライします。後でもう一度試すこともできます
一部のサイズオプションが利用できないモデルによってサポートするサイズが異なります。選択したモデルの対応サイズ一覧を確認してください
カスタムプロバイダーが動作しないAPI エンドポイントの形式が正しく、API が OpenAI 画像生成形式と互換性があることを確認してください
バッチ生成で一部の画像が失敗したAPI クォータが十分かどうか確認してください。単一の失敗は他の画像に影響しません

関連リンク​