画像生成

Purpose

テキストプロンプトを基にAI画像を生成します。オプションで参照画像をアップロードし、生成結果のスタイルや構図を参照できます。

Method and Path

POST /public/v1/generate/image

Authentication

認証ページを参照してください。Bearerトークンが必要です。

必須ヘッダー:

Authorization: Bearer {your_api_key}

Request Fields

フィールド名	タイプ	必須	説明
prompt	string	はい	画像生成のためのテキストプロンプト
ai_model	string	はい	使用するAIモデル。可能な値: GPT Image 1.5, GPT Image 2, GPT Image 2.5 High, GPT Image 2.5 XHigh, Grok Imagine, Grok Imagine Pro, Nano Banana, Nano Banana 2, Nano Banana Pro (deprecated: GPT Image 1.5, Grok Imagine, Grok Imagine Pro, Nano Banana, Nano Banana 2)
ref_images	file[]	いいえ	参照画像ファイル (multipart/form-data)。AIモデルにより最大アップロード数が異なります

Response

成功レスポンス (200 OK):

{
  "job_id": "uuid-string"
}

フィールド	タイプ	説明
job_id	string	作成されたジョブの一意識別子。Get Job Statusで結果を照会します

Error / Validation Rules

状況	HTTP状態	エラーメッセージ
Invalid image file	400	"Invalid image file"
Grok Imagineモデルでref_images 5個超過	400	"The Grok Imagine model supports up to 5 ref_images."
Grok Imagine Proモデルでref_images 1個超過	400	"The Grok Imagine Pro model supports up to 1 ref_images."
その他モデルでref_images 10個超過	400	"ref_images supports up to 10 images only"
認証失敗	401	無効なAPIキー

参照画像制限:

• GPT Image 1.5: 最大10個
• GPT Image 2 / 2.5 High / 2.5 XHigh: 最大10個
• Grok Imagine: 最大5個
• Grok Imagine Pro: 最大1個
• Nano Banana系: 最大10個

Async Job Behavior

このエンドポイントは非同期ジョブを作成します。リクエスト即座にjob_idを返し、実際の画像生成はバックグラウンドで進行します。

ポーリング方法:

1. レスポンスで受け取ったjob_idを保存します
2. GET /public/v1/job/{job_id}をポーリングして状態を確認します
3. 状態がSucceedになるとimage_urlsで結果を確認します

状態フロー: Pending → Succeed または Failed

Example Request

cURL (参照画像なし):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "prompt=a beautiful sunset over mountains" \
-F "ai_model=GPT Image 1.5"

cURL (参照画像含む):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "prompt=a cat in the style of the reference" \
-F "ai_model=Grok Imagine" \
-F "ref_images=@/path/to/ref1.jpg" \
-F "ref_images=@/path/to/ref2.jpg"