한눈에 보기
Mage API는 https://api.mage.space/v1/{model}/generate 에서 이미지 모델 15개, 영상 모델 12개, 오디오 모델 1개를 실행합니다. 모든 모델이 같은 키, 같은 요청 흐름, 같은 필드 이름을 사용하며 생성할 때마다 Gems로 결제합니다.
15
이미지 모델
12
영상 모델
1
오디오 모델
1
모든 모델에 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 | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, 세 가지 품질 등급 | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| 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 | 135 Gems ($0.135) |
| Nano Banana 2 | 선명하고 읽기 쉬운 텍스트, 최대 4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | 얼굴과 손을 개선한 SDXL | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| 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) |
영상 모델
영상 생성 모델
| 모델 | 추천 용도 | model_id 값 | 기본 가격 |
|---|---|---|---|
| Berry | 참조에 충실한 영상 | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | 첫 프레임과 마지막 프레임 고정 | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Mage의 대표 영상 모델 시리즈 | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | 움직이는 Grok Imagine | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | 설정 없이 만드는 일상 영상 | kiwi | 270 Gems ($0.27) |
| Lemon | 모든 영상 기능을 더 합리적인 가격에 | lemon | 245 Gems ($0.245) |
| LTX Video | 반복 작업에 좋은 빠른 오픈 웨이트 영상 모델 | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | 움직이는 애니메이션, 오디오는 선택 | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | 스테레오 사운드를 지원하는 빠른 오픈 영상 모델 | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | 모든 클립에 사운드, 최대 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | 첫 프레임에서 살아나는 캐릭터 | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Lightning 변형이 있는 오픈 웨이트 영상 모델 | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
오디오 모델
오디오 생성 모델
| 모델 | 추천 용도 | model_id 값 | 기본 가격 |
|---|---|---|---|
| Seed Audio | 프롬프트 하나로 음성, 음악, 효과음까지 | seed-audio-1.0 | 19 Gems ($0.019) |
FAQ
자주 묻는 질문
Mage API 요금은 얼마인가요?
구독료나 월 요금은 없습니다. 생성할 때마다 해당 모델의 표시 가격만큼 Gems로 결제하며, 기본 팩 기준 1,000 Gems는 $1입니다. 각 모델 페이지에서 기본 설정 기준 가격을 확인할 수 있고, 응답에는 실제 청구 금액이 표시됩니다. 생성에 실패하면 환불되지만, Mage 콘텐츠 정책에 따라 차단된 경우는 환불되지 않습니다. 잔액이 부족한 요청은 결제 전에 거부됩니다.
API를 사용하려면 Mage 멤버십이 필요한가요?
아니요. API는 Gems만으로 사용할 수 있습니다. 멤버십 플랜과 앱 내 무제한 생성은 API 요청에 적용되지 않으므로, Gems가 있는 Mage 계정이라면 누구나 호출할 수 있습니다.
API로 만든 결과물을 상업적으로 사용할 수 있나요?
네. API와 MCP 서버를 통해 만든 콘텐츠를 포함해, Mage로 만든 콘텐츠는 상업적으로 사용할 수 있어요. 출처 표기는 감사하지만 필수는 아니에요.
요청 제한은 어떻게 되나요?
계정당 최대 20개의 생성을 동시에 대기 또는 실행할 수 있어요. 이를 넘겨 제출하면 429로 거부되며 비용은 청구되지 않아요. 사용 목적에 맞게 한도를 늘리려면 [email protected]로 문의해 주세요.
내 AI 에이전트도 Mage API를 사용할 수 있나요?
네. 에이전트는 키로 REST API를 호출하거나 Mage MCP 서버에 연결할 수 있어요. MCP 서버에는 Claude, ChatGPT, Claude Code, Grok, Cursor에서 모델 선택, 가격 확인, 생성, 결과 가져오기를 할 수 있는 16개의 기본 제공 도구가 있어요. 참고: MCP 서버.
Mage API용 SDK가 있나요?
네. npm의 공식 @mage-space/sdk 패키지와 PyPI의 mage-space는 오픈 소스이며 모든 모델에 타입이 지정되어 있어요. 요청 제출, 결과 대기, 안전한 재시도, 파일 업로드를 대신 처리해 줘요. ComfyUI 사용자는 comfyui-mage 노드 팩을 설치할 수 있어요. 참고: Mage SDK.
이미 다른 생성 API를 쓰고 있어요. 무엇을 바꿔야 하나요?
클라이언트가 https://api.mage.space/v1 을 가리키도록 설정하고, Mage 키를 Bearer 토큰으로 보낸 다음, 모델 페이지에 맞게 필드를 매핑하세요. prompt, aspect_ratio, resolution, duration, model_id는 모든 Mage 모델에서 동일하게 동작해요. 요청은 비동기라서 제출한 뒤 status_url을 폴링하면 돼요.
Mage로 지금 시작하세요
계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.