이미지 생성 API
OpenAI, Google, ByteDance의 14개 모델을 사용하여 텍스트 프롬프트를 이미지로 변환하세요. 모든 모델에 단일 API 키와 동일한 요청 형식이 적용되며, 크레딧으로 이미지당 요금이 청구됩니다.
모델
아래의 모든 모델은 POST /v1/images/generations에서 텍스트 프롬프트를 입력받습니다. 요금은 기본 라우트 기준 이미지 1장당 예상 비용입니다.
| 모델 및 API 모델 ID | 옵션 | official-cheap 요금 (기본) |
|---|---|---|
GPT Image 2openai/gpt-image-2 | 크기: 1K, 2K, 4K | 1K 이미지당 $0.032official: $0.053 |
GPT Image 2.5 Flareopenai/gpt-image-2.5-flare | 크기: 1K, 2K | 1K 이미지당 $0.008official: $0.013 |
GPT Image 2.5 Sunburstopenai/gpt-image-2.5-sunburst | 크기: 1K, 2K | 1K 이미지당 $0.008official: $0.013 |
Nano Bananagoogle/nano-banana | 단일 표준 크기 | 이미지당 $0.019official: $0.039 |
Nano Banana 2google/nano-banana-2 | 크기: 1K, 2K, 4K | 1K 이미지당 $0.034official: $0.067 |
Nano Banana 2 Litegoogle/nano-banana-2-lite | 단일 표준 크기 | 이미지당 $0.017official: $0.034 |
Nano Banana 2.1google/nano-banana-2.1 | 크기: 1K, 2K, 4K | 1K 이미지당 $0.017official: $0.034 |
Nano Banana Progoogle/nano-banana-pro | 크기: 1K, 2K, 4K | 1K 이미지당 $0.067official: $0.134 |
Seedream 4.0bytedance/seedream-4.0 | 크기: 1K, 2K, 4K | 이미지당 $0.027official: $0.03 |
Seedream 4.5bytedance/seedream-4.5 | 크기: 2K, 4K | 이미지당 $0.036official: $0.04 |
Seedream 5.0bytedance/seedream-5.0 | 크기: 2K, 4K | 이미지당 $0.032official: $0.035 |
Seedream 5 Probytedance/seedream-5.0-pro | 크기: 2K, 4K | 이미지당 $0.081official: $0.09 |
Qwen Image 2.1 Proqwen/qwen-image-2.1-pro | 크기: 1K, 2K | 이미지당 $0.035official: $0.038 |
Qwen Image 2.1 Turboqwen/qwen-image-2.1-turbo | 크기: 1K, 2K | 이미지당 $0.014official: $0.015 |
빠른 시작
- API 키 생성
콘솔에서 키를 생성하고 MLMUX_API_KEY 환경 변수로 저장하세요.
API 키 생성 - 요청 전송
이 예제는 Nano Banana 2 (google/nano-banana-2)을(를) https://api.mlmux.com/v1/images/generations(으)로 전송합니다. 모델 ID를 위 표에 있는 원하는 모델로 변경하세요.
- 결과 확인
응답의 data에 이미지 URL 목록이 반환됩니다. 폴링할 작업을 받으려면 "async": true를 추가하세요.
이미지 API 레퍼런스
curl https://api.mlmux.com/v1/images/generations \
-H "Authorization: Bearer $MLMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/nano-banana-2",
"route_mode": "official-cheap",
"prompt": "A red fox in fresh snow at sunrise, cinematic light",
"resolution": "1K",
"aspect_ratio": "1:1",
"output_format": "jpg",
"n": 1
}'자주 묻는 질문
이미지 생성에는 어떤 모델을 사용해야 하나요?
범용 이미지 작업에는 Nano Banana 2(으)로 시작해 보세요. GPT Image와 Qwen Image는 이미지 내 텍스트 표현에 뛰어나고, Nano Banana Pro는 정교하고 전문적인 작업에, Seedream은 고해상도 이미지를 고정 가격으로 제공하는 데 강점이 있습니다. GPT Image 2.5 Flare은(는) 가장 비용 효율적인 선택지입니다.
이미지 생성 API 비용은 얼마인가요?
기본 official-cheap 라우트 기준 이미지당 약 $0.008(GPT Image 2.5 Flare)부터 시작합니다. GPT Image와 Nano Banana는 이미지가 사용하는 토큰에 따라 과금되므로 크기가 클수록 비용이 더 들며, Seedream 및 Qwen Image는 이미지당 고정 가격이 적용됩니다.
동일한 요청 내에서 이미지를 바로 받을 수 있나요?
네, 응답에 이미지 URL 목록이 포함됩니다. 시간이 오래 걸리는 작업이나 일괄 작업의 경우 "async": true를 추가하여 작업을 생성하고 폴링하거나, 완료 시 웹훅을 수신할 수 있습니다.
실패한 요청에도 요금이 부과되나요? 한도가 있나요?
실패한 요청에는 요금이 청구되지 않으며, 예약된 크레딧은 잔액으로 반환됩니다. 각 계정은 최대 60개의 작업을 동시에 실행할 수 있습니다. 추가 한도가 필요하시면 support@mlmux.com로 문의해 주세요.