AI 모델 값
Aether API에서 사용 가능한 AI 모델과 각 모델의 특성을 설명합니다.
AiModelType 열거형
이미지 생성 요청에 사용할 수 있는 AI 모델 목록입니다.
| 모델 값 | 설명 |
|---|---|
GPT Image 1.5 | OpenAI GPT Image 1.5 모델 (deprecated) |
GPT Image 2 | OpenAI GPT Image 2 모델 |
GPT Image 2.5 High | OpenAI GPT Image 2.5 High 모델 |
GPT Image 2.5 XHigh | OpenAI GPT Image 2.5 XHigh 모델 |
Grok Imagine | xAI Grok Imagine 모델 (deprecated) |
Grok Imagine Pro | xAI Grok Imagine Pro 모델 (deprecated) |
Nano Banana | Nano Banana 모델 (deprecated) |
Nano Banana 2 | Nano Banana 2 모델 (deprecated) |
Nano Banana Pro | Nano Banana Pro 모델 |
참조 이미지 제한
각 모델별로 ref_images 매개변수에 허용되는 최대 이미지 수가 다릅니다.
| 모델 | 최대 참조 이미지 수 |
|---|---|
GPT Image 1.5 | 10개 |
GPT Image 2 | 10개 |
GPT Image 2.5 High | 10개 |
GPT Image 2.5 XHigh | 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 2.5 High / GPT Image 2.5 XHigh |
| 스타일 참조가 필요한 경우 | Grok Imagine (최대 5개) |
| 단일 참조 이미지로 고품질 결과 | Grok Imagine Pro |
| 다중 참조 이미지가 필요한 경우 | Nano Banana 계열 (최대 10개) |
관련 문서
- POST /public/v1/generate/image - 이미지 생성 엔드포인트
- 비동기 작업 라이프사이클 - 작업 처리 흐름