Mage API · 이미지 생성
모든 모델을 한 번에, AI 이미지 생성 API
Mage의 대표 모델 Mango 4를 포함한 18개 모델의 텍스트-이미지 변환, 이미지 편집, 일관된 캐릭터를 키 하나와 잔액 하나로 이용하세요.
POST https://api.mage.space/v1/{model}/generate한눈에 보기
Mage 이미지 생성 API는 Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2, Krea 2를 포함해 텍스트-이미지 및 이미지 편집 모델 18개를 실행하는 https://api.mage.space/v1 의 REST API입니다. /{model}/generate 로 프롬프트를 POST하고, 요청 상태를 폴링한 뒤 이미지를 다운로드하면 됩니다. 이미지마다 Gems로 결제되며 구독은 필요 없습니다.
- 18이미지 모델
- $0.009이미지당 최저 기본 가격
- 20동시 생성 수
- $0월 이용료
모델
Mage API의 모든 이미지 모델
가격은 생성 1회당 Gems 기준이에요. 표준 팩에서는 1,000 Gems가 $1이고, 더 큰 팩에는 보너스 Gems가 붙어요. 가격은 모델, 해상도, 길이에 따라 달라지며, 여기에는 기본 설정 가격이 표시돼요. 정확한 청구액은 응답의 billing.gems_charged에서 확인할 수 있어요. 생성에 실패하면 환불되지만, Mage의 콘텐츠 정책에 따라 차단된 경우에는 환불되지 않아요.
| 모델 | 추천 용도 | model_id 값 | 기본 가격 |
|---|---|---|---|
| Anima | 애니메이션 전용으로 설계 | anima-v1 | 20 Gems ($0.02) |
| Chroma | Flux 기반 오픈 웨이트 모델 | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | 긴 프롬프트와 다중 레퍼런스 편집 | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | 정밀한 프롬프트와 읽기 쉬운 텍스트 | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | 두 가지 등급의 Grok Imagine | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | 사진으로 착각할 만큼 사실적인 포토리얼리즘 | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | 빠르고 다재다능하며 네거티브 프롬프트 지원 | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | 몇 초 만에 만드는 멋진 미감 | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Mage의 대표 이미지 모델 패밀리 | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | 네이티브 16메가픽셀 이미지, 오픈 웨이트 | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | 긴 프롬프트와 이중 언어 텍스트, 오픈 웨이트 | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | 선명하고 읽기 쉬운 텍스트, 최대 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | 얼굴과 손을 개선한 SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, 엄격한 필터 적용 | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | 합리적인 가격의 클래식 | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | 말을 가장 잘 알아듣는 Stable Diffusion | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | 포토리얼에 맞춰 튜닝한 SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Mage에서 가장 빠른 이미지 모델 | z-image-turbo | 10 Gems ($0.01) |
빠른 시작
Anima v1로 이미지 생성하기
MAGE_API_KEY를 설정하고 요청을 제출한 뒤 완료될 때까지 폴링하세요. URL의 anima를 위의 다른 모델로 바꾸면 돼요.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
print(request["result"]["url"])작동 방식
API 키부터 완성된 결과물까지, 세 번의 호출로
모든 모델이 하나의 인증 방식, 하나의 비동기 요청 흐름, 동일한 필드 이름을 공유합니다.
API 키 만들기
Mage에 로그인한 뒤 API → API Keys에서 키를 만드세요. 키는 mage_sk_로 시작하며 한 번만 표시됩니다. 계정당 활성 키를 최대 10개까지 보유할 수 있습니다.
생성 요청하기
Authorization: Bearer 헤더와 함께 https://api.mage.space/v1/{model}/generate로 JSON 본문을 POST하세요. 응답은 request_id, status, status_url과 함께 즉시 반환됩니다. Idempotency-Key 헤더를 보내면 재시도해도 중복 결제되지 않습니다.
상태 확인 및 다운로드
status가 completed, failed, cancelled 중 하나가 될 때까지 status_url을 폴링하세요. 완료된 요청에는 이미지, 영상 또는 오디오 파일의 result.url이 담기며, 파일은 30일간 보관됩니다.
프로덕션을 위해 설계
모든 Mage API 요청에 제공되는 기능
키 하나로 모든 모델
REST API 하나와 Gems 잔액 하나로 쓰는 37개 이미지, 동영상, 오디오 모델. URL 경로만 바꾸면 모델을 전환할 수 있어요.
생성할 때만 결제
구독도, 최소 사용 금액도 없습니다. Gems를 구매하면 요청마다 표시된 가격이 차감됩니다. 생성에 실패하면 환불되지만, Mage 콘텐츠 정책에 따라 차단된 경우는 제외입니다.
안전한 재시도
멱등성 키를 사용하면 재시도한 요청도 추가 결제 없이 원래 요청의 결과를 반환합니다.
일관된 캐릭터
캐릭터나 레퍼런스를 한 번 저장해 두면, 프롬프트에 @handle을 입력해 지원하는 모든 모델에서 사용할 수 있습니다.
대용량 입력
이미지, 영상, 오디오 입력을 URL이나 데이터 URL로 보내거나, 서명된 업로드로 최대 100 MB 파일을 업로드할 수 있습니다.
동시 생성 20개
계정마다 최대 20개의 생성을 동시에 실행할 수 있으며, 사용 목적에 맞게 한도를 늘릴 수도 있습니다. 거부된 요청에는 비용이 청구되지 않습니다.
활용 사례
개발자들이 이미지 API로 만드는 것
제품 및 마케팅 이미지
제품 컷, 광고 시안, 소셜 게시물을 필요할 때 바로 만들어 보세요. GPT Image 2.6 또는 Nano Banana 2로 읽기 쉬운 텍스트도 넣을 수 있어요.
일관된 캐릭터
캐릭터를 한 번 저장해 두면 @handle 멘션을 지원하는 Mango 4, Guava 2 Pro 등의 모델로 여러 장에 걸쳐 같은 얼굴을 유지할 수 있어요.
이미지 편집 파이프라인
원본 이미지와 지시문을 보내면 요청한 부분만 정확히 바꾸고 나머지는 그대로 유지합니다.
앱과 게임
GPU를 직접 운영하지 않고도 제품 안에서 아바타, 스티커, 카드, 장면을 생성하세요.
실사 인물 사진
Guava 2 Pro는 실제 같은 피부, 직물, 빛으로 인물, 패션, 라이프스타일 사진을 렌더링합니다.
대량 초안을 빠르게
Z-Image Turbo와 Krea 2는 대량의 썸네일과 1차 작업을 낮은 가격으로 처리합니다.
FAQ
자주 묻는 질문
가장 좋은 AI 이미지 생성 API는 무엇인가요?
이미지 API가 이미지 편집과 참조 이미지를 지원하나요?
이미지 API는 어떤 해상도를 지원하나요?
Mage API 요금은 얼마인가요?
API를 사용하려면 Mage 멤버십이 필요한가요?
API로 만든 결과물을 상업적으로 사용할 수 있나요?
요청 제한은 어떻게 되나요?
내 AI 에이전트도 Mage API를 사용할 수 있나요?
Mage API용 SDK가 있나요?
이미 다른 생성 API를 쓰고 있어요. 무엇을 바꿔야 하나요?
Mage로 지금 시작하세요
계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.