AI 이미지 생성 API란?
ImgGen AI 이미지 생성 API는 텍스트 프롬프트를 이미지로 바꾸는 REST 엔드포인트입니다. 프롬프트, 원하는 샘플 수, 화면비, 사용할 모델이 담긴 JSON 본문을 보내면, 생성된 이미지가 base64로 인코딩된 배열로 반환됩니다. 파일 대신 JSON을 받는 유일한 엔드포인트입니다.
이것은 ImgGen AI 이미지 편집 API의 일곱 개 엔드포인트 중 하나이며, 모두 같은 API 키와 같은 기본 URL, 동일한 요청·응답 형식을 공유합니다. 코드가 아니라 브라우저에서도 이 기능이 필요하다면, 같은 AI 모델이 AI Image Generator 도구를 구동합니다.
요청 파라미터
https://app.imggen.ai/v1/generate-image 으로 POST 요청을 보내고, Authorization 헤더의 API 키로 인증하세요.
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
| prompt | string | 필수 | — | 생성할 이미지에 대한 텍스트 설명. |
| samples | number | 선택 | 1 | 생성할 이미지 수, 1부터 4까지. |
| aspect_ratio | string | 선택 | square | 출력 형태. square, portrait, landscape를 지정할 수 있습니다. |
| model | string | 선택 | imggen-base | 생성 모델. imggen-base, imggen-base-fast, imggen-xl을 지정할 수 있습니다. |
AI 이미지 생성 API는 어떻게 연동하나요?
ImgGen 계정에서 API 키를 만들고 환경 변수로 지정한 뒤 엔드포인트를 호출하세요. 같은 요청을 cURL, Node.js, Python으로 보여드립니다.
curl --request POST \
--url 'https://app.imggen.ai/v1/generate-image' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"prompt": "close up photo of a rabbit in a wildflower meadow",
"samples": 1,
"aspect_ratio": "square",
"model": "imggen-base"
}'import fs from 'node:fs';
const res = await fetch('https://app.imggen.ai/v1/generate-image', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.IMGGEN_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
prompt: 'close up photo of a rabbit in a wildflower meadow',
samples: 1,
aspect_ratio: 'square',
model: 'imggen-base',
}),
});
const data = await res.json();
data.images.forEach((img, i) =>
fs.writeFileSync(`image-${i}.png`, Buffer.from(img, 'base64')),
);import base64, os, requests
res = requests.post(
"https://app.imggen.ai/v1/generate-image",
headers={
"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}",
"Content-Type": "application/json",
},
json={
"prompt": "close up photo of a rabbit in a wildflower meadow",
"samples": 1,
"aspect_ratio": "square",
"model": "imggen-base",
},
)
for i, img in enumerate(res.json()["images"]):
with open(f"image-{i}.png", "wb") as out:
out.write(base64.b64decode(img))응답
성공한 호출은 JSON을 반환합니다. 결과는 base64로 인코딩되어 있으니 디스크나 오브젝트 스토리지에 쓰기 전에 디코딩하세요. 성공한 응답에는 호출 후 잔액을 담은 X-Credit-Remaining 헤더도 함께 옵니다.
{
"success": true,
"message": "Images generated successfully",
"images": ["iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="]
}알아두면 좋은 제한과 동작
이 엔드포인트는 파일 최대 25MB의 JPEG(JPG), PNG, WebP를 받고 60초 이내에 동기적으로 응답합니다. 폴링할 작업도, 설정할 웹훅도 없습니다.
images 배열을 반환합니다
단일 image 필드를 반환하는 편집 엔드포인트와 달리, 생성은 images를 반환합니다. 요청한 샘플마다 하나씩 담긴 배열입니다.
모델 3종
imggen-base가 기본 균형점이고, imggen-base-fast는 디테일을 내주고 속도를 얻으며, imggen-xl은 최고 품질을 노립니다. 계정 단위가 아니라 요청마다 고를 수 있습니다.
멀티파트가 아니라 JSON
JSON 본문을 받는 유일한 엔드포인트입니다. 멀티파트 폼 대신 Content-Type: application/json을 보내세요.
AI 이미지 생성 API는 어디에 쓰이나요?
여러 팀이 이 엔드포인트를 실제 서비스에 넣어 프로그래밍 방식으로 대규모 이미지를 처리하는 사례입니다.
기사·블로그 이미지
남들도 다 쓰는 스톡 라이브러리에서 가져오는 대신, 제목에서 기사마다 고유한 헤더 이미지를 생성하세요.
제품·캠페인 콘셉트 잡기
한 번의 호출로 하나의 시각 아이디어를 네 가지 변형으로 뽑아, 실제 제작을 의뢰하기 전에 팀이 방향을 정하도록 하세요.
앱 내 크리에이티브 기능
GPU 인프라를 구축하지 않고도 사용자가 제품 안에서 이미지를 생성하도록 하세요.
플레이스홀더와 목업 콘텐츠
데모, 프로토타입, 시드 데이터 환경을 필요할 때 생성한 그럴듯한 이미지로 채우세요.
AI 이미지 생성 API의 비용은 얼마인가요?
성공한 호출 한 번에 3크레딧부터가 들며, 따라서 이미지당 실질 비용은 이용 중인 플랜에 따라 정해집니다. 크레딧은 플랜에서 차감되고 모든 엔드포인트와 웹 편집기가 함께 쓰므로, 도구별로 별도 할당량을 살 필요가 없습니다. 실패한 호출은 자동으로 환불됩니다. 자세한 내용은 요금 페이지를 확인하세요.
| 플랜 | 가격 | 크레딧 | API |
|---|---|---|---|
| Free | $0 | 1회성 무료 크레딧 50 | API 접근 없음 |
| Starter | $9.99 / month | 월 400 크레딧 | API 접근 포함 |
| Pro | $29.99 / month | 월 1,400 크레딧 | API 접근 + 우선 지원 |
| Enterprise | Custom | 맞춤 사용량 | 전용 인프라 |
크레딧 비용과 제한 최종 확인일 2026-08-27.
관련 엔드포인트 및 도구
AI 이미지 생성 API를 쓰는 팀이 다음으로 자주 찾는 것들입니다.
AI 이미지 생성 API 자주 묻는 질문
- 글로 쓴 설명을 이미지로 바꾸는 HTTP 엔드포인트입니다. 프롬프트를 JSON으로 보내면 서비스가 생성된 이미지를 응답으로 돌려주며, 덕분에 제품이 자체 모델 인프라를 전혀 운영하지 않고도 텍스트 기반 이미지 생성을 제공할 수 있습니다.
- samples 파라미터로 1장에서 4장까지 지정합니다. 요청한 이미지는 모두 같은 응답의 단일 images 배열에 담겨 옵니다.
- 세 가지입니다. imggen-base는 기본값으로 품질과 속도의 균형을 맞추고, imggen-base-fast는 디테일을 줄이는 대신 더 빨리 결과를 주며, imggen-xl은 최고 품질을 노립니다. model 파라미터로 요청마다 선택합니다.
- aspect_ratio로 square, portrait, landscape를 지정합니다. 생략하면 기본값은 square입니다.
- 생성은 정액이 아니라 모델별로 과금됩니다. 모델마다 연산량이 크게 다르기 때문입니다. 기본 모델은 이미지당 3크레딧부터 시작하고 품질이 높은 모델일수록 올라갑니다. 남은 잔액은 성공한 호출마다 X-Credit-Remaining 헤더로 돌아오며, 각 모델의 현재 비용은 ImgGen 계정에서 확인할 수 있습니다.
- 여러분에게 있습니다. ImgGen은 API가 반환하는 어떤 것에도 소유권을 주장하지 않으며, 모든 플랜에 완전한 상업적 사용 권한이 워터마크 없이 포함됩니다. 다만 AI 생성 이미지의 저작권은 관할 지역마다 다르게 다뤄지므로, 소유권이 법적으로 중요한 용도라면 현지 기준을 확인하세요.
- 네. 무료 플랜을 포함한 모든 플랜에 완전한 상업적 사용 권한이 포함되며, 어떤 결과물에도 워터마크가 들어가지 않습니다. API가 반환한 것은 무엇이든 판매하거나 인쇄하거나 게시할 수 있습니다.
- 생성된 이미지는 응답으로 반환되고 보관되지 않습니다. ImgGen의 다른 모든 엔드포인트와 마찬가지로, 남는 것은 호출이 있었다는 사실과 비용을 기록한 사용 로그뿐입니다. 여러분의 콘텐츠는 모델 학습에 사용되지 않습니다.
시작하기
AI 이미지 생성 API 호출을 시작하세요
키 하나로 일곱 개 엔드포인트가 모두 열립니다. 워터마크 없음, 완전한 상업적 권리, 그리고 보내신 어떤 것도 응답이 반환된 뒤에는 저장되지 않습니다.
API 키 받기