AI 模型值
說明 Aether API 可用的 AI 模型與各模型特性。
AiModelType 列舉
可用於影像生成請求的 AI 模型清單。
| 模型值 | 說明 |
|---|---|
GPT Image 1.5 | OpenAI GPT Image 1.5 模型 |
Grok Imagine | xAI Grok Imagine 模型 |
Grok Imagine Pro | xAI Grok Imagine Pro 模型 |
Nano Banana | Nano Banana 模型 |
Nano Banana 2 | Nano Banana 2 模型 |
Nano Banana Pro | Nano Banana Pro 模型 |
參考影像限制
各模型對於 ref_images 參數允許的最大影像數量不同。
| 模型 | 最大參考影像數 |
|---|---|
GPT Image 1.5 | 10 張 |
Grok Imagine | 5 張 |
Grok Imagine Pro | 1 張 |
Nano Banana | 10 張 |
Nano Banana 2 | 10 張 |
Nano Banana Pro | 10 張 |
請求範例
基本生成
curl -X POST "https://api.aetherforgeai.com/public/v1/generate" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A beautiful sunset over mountains",
"ai_model": "GPT Image 1.5"
}'
包含參考影像 (Grok Imagine Pro)
curl -X POST "https://api.aetherforgeai.com/public/v1/generate" \
-H "Authorization: Bearer your_api_key_here" \
-F "prompt=A cat in the style of the reference image" \
-F "ai_model=Grok Imagine Pro" \
-F "[email protected]"
包含參考影像 (GPT Image 1.5 - 最多 10 張)
curl -X POST "https://api.aetherforgeai.com/public/v1/generate" \
-H "Authorization: Bearer your_api_key_here" \
-F "prompt=A landscape combining these styles" \
-F "ai_model=GPT Image 1.5" \
-F "[email protected]" \
-F "[email protected]" \
-F "[email protected]"
錯誤回應
400 Bad Request - 參考影像超過限制
當超過模型的最大參考影像數時回傳。
Grok Imagine Pro 範例:
{
"detail": "The Grok Imagine Pro model supports up to 1 ref_images."
}
一般限制範例:
{
"detail": "ref_images supports up to 10 images only"
}
模型選擇指南
| 使用情境 | 建議模型 |
|---|---|
| 高品質一般影像生成 | GPT Image 1.5 |
| 需要風格參考時 | Grok Imagine (最多 5 張) |
| 單一參考影像獲得高品質結果 | Grok Imagine Pro |
| 需要多個參考影像時 | Nano Banana 系列 (最多 10 張) |
相關文件
- POST /public/v1/generate/image - 影像生成端點
- 非同步作業生命週期 - 作業處理流程