画像生成
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, Grok Imagine, Grok Imagine Pro, Nano Banana, Nano Banana 2, Nano Banana Pro |
| 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個
- Grok Imagine: 最大5個
- Grok Imagine Pro: 最大1個
- Nano Banana系: 最大10個
Async Job Behavior
このエンドポイントは非同期ジョブを作成します。リクエスト即座にjob_idを返し、実際の画像生成はバックグラウンドで進行します。
ポーリング方法:
- レスポンスで受け取った
job_idを保存します GET /public/v1/job/{job_id}をポーリングして状態を確認します- 状態が
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"