이미지 편집 API
텍스트 프롬프트를 사용하여 이미지를 편집하거나 스타일을 변경하고 여러 참조 이미지를 합성하세요. 6개 모델이 POST /v1/images/edits를 통해 참조 이미지를 지원합니다.
모델
아래의 모든 모델은 참조 이미지를 지원합니다. image_urls에 URL을 전달하세요. 각 모델이 지원하는 이미지 수는 표에서 확인할 수 있습니다.
| 모델 및 API 모델 ID | 옵션 | official-cheap 요금 (기본) |
|---|---|---|
GPT Image 2openai/gpt-image-2 | 크기: 1K, 2K, 4K최대 16개의 참조 이미지 | 1K 이미지당 $0.032official: $0.053 |
Nano Banana 2google/nano-banana-2 | 크기: 1K, 2K, 4K최대 14개의 참조 이미지 | 1K 이미지당 $0.034official: $0.067 |
Nano Banana 2.1google/nano-banana-2.1 | 크기: 1K, 2K, 4K최대 14개의 참조 이미지 | 1K 이미지당 $0.017official: $0.034 |
Nano Banana Progoogle/nano-banana-pro | 크기: 1K, 2K, 4K최대 14개의 참조 이미지 | 1K 이미지당 $0.067official: $0.134 |
Qwen Image 2.1 Proqwen/qwen-image-2.1-pro | 크기: 1K, 2K최대 3개의 참조 이미지 | 이미지당 $0.035official: $0.038 |
Qwen Image 2.1 Turboqwen/qwen-image-2.1-turbo | 크기: 1K, 2K최대 3개의 참조 이미지 | 이미지당 $0.014official: $0.015 |
빠른 시작
- API 키 생성
콘솔에서 키를 생성하고 MLMUX_API_KEY 환경 변수로 저장하세요.
API 키 생성 - 요청 전송
이 예제는 Nano Banana Pro (google/nano-banana-pro)을(를) https://api.mlmux.com/v1/images/edits(으)로 전송합니다. 모델 ID를 위 표에 있는 원하는 모델로 변경하세요.
- 결과 확인
응답의 data에 이미지 URL 목록이 반환됩니다. 폴링할 작업을 받으려면 "async": true를 추가하세요.
이미지 API 레퍼런스
curl https://api.mlmux.com/v1/images/edits \
-H "Authorization: Bearer $MLMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/nano-banana-pro",
"route_mode": "official-cheap",
"prompt": "Place the product on a sunlit marble counter and keep the label unchanged",
"image_urls": [
"https://your-cdn.example/product.jpg"
],
"resolution": "2K",
"aspect_ratio": "match_input_image",
"output_format": "png"
}'자주 묻는 질문
이미지 편집에는 어떤 모델을 사용해야 하나요?
Nano Banana Pro은(는) 복잡한 다중 참조 편집을 원활하게 처리합니다. Nano Banana 2 및 2.1은 일상적인 편집 작업에 더 경제적이며, GPT Image 2는 최대 16개의 참조 이미지를 지원합니다. 가장 저렴한 옵션은 Qwen Image 2.1 Turbo입니다.
이미지 편집 비용은 얼마인가요?
편집 비용은 동일한 크기의 이미지 생성과 동일하게 책정되며, 기본 라우트 기준 이미지당 약 $0.014(Qwen Image 2.1 Turbo)부터 시작합니다.
편집할 이미지는 어떻게 전송하나요?
image_urls에 공개 URL을 전달하거나 POST /v1/uploads로 파일을 업로드한 후 반환된 URL을 사용하세요. 응답에 편집된 이미지 URL 목록이 반환됩니다.
실패한 요청에도 요금이 부과되나요? 한도가 있나요?
실패한 요청에는 요금이 청구되지 않으며, 예약된 크레딧은 잔액으로 반환됩니다. 각 계정은 최대 60개의 작업을 동시에 실행할 수 있습니다. 추가 한도가 필요하시면 support@mlmux.com로 문의해 주세요.