키 하나로 모든 모델
이미지, 영상, 오디오 모델 28개를 REST API 하나와 Gems 잔액 하나로 사용하세요. URL 경로만 바꾸면 모델이 전환됩니다.
한눈에 보기
Mage는 개발자를 위해 https://api.mage.space/v1 REST API와 https://mcp.mage.space/mcp 원격 MCP 서버를 제공합니다. 둘 다 Mage 독점 모델인 Mango 3와 Cherry 2 Pro를 포함한 28개의 이미지, 영상, 오디오 모델을 하나의 계정으로 사용하며, 구독 없이 생성할 때마다 Gems로 결제합니다.
28
모델
3
미디어 유형
16
MCP 도구
$0
월 이용료
사용 방법
코드, AI 어시스턴트, ComfyUI에서 바로 호출하세요
REST API
Mage API
키를 사용해 내 코드에서 바로 생성을 요청하세요. 비동기 요청, 멱등성 재시도, 최대 100MB 업로드, 동시 생성 20건을 지원합니다.
SDK
TypeScript 및 Python SDK
요청, 결과 대기, 안전한 재시도, 파일 업로드를 몇 줄이면 끝내는 타입 기반 공식 클라이언트입니다.
MCP 서버
Mage MCP 서버
로그인만으로 Claude, ChatGPT, Claude Code, Grok, Cursor를 연결하고 이미지, 영상, 오디오를 쉬운 말로 요청하세요.
ComfyUI
ComfyUI용 Mage
Mango, Cherry, Seed Audio를 비롯한 모든 Mage 모델을 ComfyUI 노드로 사용하세요. GPU도, 모델 다운로드도 필요 없습니다.
미디어 유형별
생성 API
빠른 시작
첫 번째 생성
API → API Keys에서 키를 만들고 MAGE_API_KEY로 내보낸 다음, 아래 예시 중 하나를 실행하세요.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/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": "mango-v3"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v3',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3",
})
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일간 보관됩니다.
MCP
AI 어시스턴트에서 만나는 Mage
모델
추천 모델
이미지 · 40 Gems부터
Flux 2 API
긴 프롬프트와 다중 레퍼런스 편집
이미지 · 9 Gems부터
GPT Image 2 API
정밀한 프롬프트와 읽기 쉬운 텍스트
이미지 · 37 Gems부터
Guava API
사진처럼 보이는 포토리얼리즘
이미지 · 135 Gems부터
Mango API
Mage의 대표 이미지 모델 시리즈
이미지 · 68 Gems부터
Nano Banana 2 API
선명하고 읽기 쉬운 텍스트, 최대 4K
영상 · 618 Gems부터
Cherry API
Mage의 대표 영상 모델 시리즈
영상 · 245 Gems부터
Lemon API
모든 영상 기능을 더 부담 없는 가격에
영상 · 338 Gems부터
Plum API
모든 클립에 사운드 포함, 최대 2K
오디오 · 19 Gems부터
Seed Audio API
프롬프트 하나로 음성, 음악, 효과음까지
프로덕션을 위해 설계
모든 Mage API 요청에 제공되는 기능
생성할 때만 결제
구독도, 최소 사용 금액도 없습니다. Gems를 구매하면 요청마다 표시된 가격이 차감됩니다. 생성에 실패하면 환불되지만, Mage 콘텐츠 정책에 따라 차단된 경우는 제외입니다.
안전한 재시도
멱등성 키를 사용하면 재시도한 요청도 추가 결제 없이 원래 요청의 결과를 반환합니다.
일관된 캐릭터
캐릭터나 레퍼런스를 한 번 저장해 두면, 프롬프트에 @handle을 입력해 지원하는 모든 모델에서 사용할 수 있습니다.
대용량 입력
이미지, 영상, 오디오 입력을 URL이나 데이터 URL로 보내거나, 서명된 업로드로 최대 100 MB 파일을 업로드할 수 있습니다.
동시 생성 20개
계정마다 최대 20개의 생성을 동시에 실행할 수 있으며, 사용 목적에 맞게 한도를 늘릴 수도 있습니다. 거부된 요청에는 비용이 청구되지 않습니다.
FAQ
자주 묻는 질문
Mage API는 무엇인가요?
Mage API는 내 코드에서 모델 28개로 이미지, 영상, 오디오를 생성할 수 있는 REST API(https://api.mage.space/v1)입니다. 요청은 비동기로 처리되며, 생성할 때마다 Gems로 결제합니다.
Mage MCP 서버는 무엇인가요?
https://mcp.mage.space/mcp의 원격 Model Context Protocol 서버로, AI 어시스턴트가 내 Mage 계정으로 이미지, 영상, 오디오를 생성할 수 있게 해 줍니다. 어시스턴트는 도구 16개로 모델 선택, 가격 확인, 생성, 결과 대기를 하고 저장된 캐릭터, 레퍼런스, 기록도 사용할 수 있습니다.
MCP 서버를 사용하려면 API 키가 필요한가요?
아니요. Claude, ChatGPT, Grok, Cursor, Claude Code는 OAuth로 Mage에 로그인하면 바로 연결됩니다. API 키는 CI 같은 헤드리스 환경에서만 선택적으로 사용하면 됩니다.
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 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.