Mage API · 다음 아이디어를 위한 도구
API 하나로 펼치는 무한한 가능성
Mage의 강력한 기능을 내 서비스와 AI 어시스턴트에 연결하세요. API 키 하나 또는 MCP 연결 하나로 이미지, 영상, 오디오를 생성할 수 있습니다.
https://api.mage.space/v1한눈에 보기
Mage는 개발자를 위해 https://api.mage.space/v1 REST API와 https://mcp.mage.space/mcp 원격 MCP 서버를 제공합니다. 둘 다 Mage 독점 모델인 Mango 4와 Cherry 2 Pro를 포함한 동일한 37개 이미지, 동영상, 오디오 모델을 하나의 계정으로 실행하며, 모든 생성은 구독 없이 Gems로 결제됩니다.
- 37모델
- 3미디어 유형
- 16MCP 도구
- $0월 이용료
사용 방법
코드, AI 어시스턴트, ComfyUI에서 바로 호출하세요
Mage API
키를 사용해 내 코드에서 바로 생성을 요청하세요. 비동기 요청, 멱등성 재시도, 최대 100MB 업로드, 동시 생성 20건을 지원합니다.
TypeScript 및 Python SDK
요청, 결과 대기, 안전한 재시도, 파일 업로드를 몇 줄이면 끝내는 타입 기반 공식 클라이언트입니다.
Mage MCP 서버
로그인만으로 Claude, ChatGPT, Claude Code, Grok, Cursor를 연결하고 이미지, 영상, 오디오를 쉬운 말로 요청하세요.
ComfyUI용 Mage
Mango, Cherry, Seed Audio를 비롯한 모든 Mage 모델을 ComfyUI 노드로 사용하세요. GPU도, 모델 다운로드도 필요 없습니다.
미디어 유형별
생성 API
AI 이미지 생성 API
텍스트로 이미지 생성, 편집, 최대 4K의 일관된 캐릭터까지.
AI 영상 생성 API
텍스트·이미지로 영상 생성, 프레임, 레퍼런스, 사운드까지.
AI 오디오 생성 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-v4"
}' | 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-v4',
});
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-v4",
})
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
Claude에서 Mage 사용하기
웹, 데스크톱 앱, 모바일 앱, Cowork의 Claude에서 이미지, 영상, 오디오를 생성하세요.
ChatGPT에서 Mage 사용하기
개인 MCP 앱으로 ChatGPT에서 이미지, 영상, 오디오를 생성하세요.
Claude Code의 Mage
터미널과 에디터의 Claude Code에서 이미지, 영상, 오디오를 생성해 보세요.
Grok의 Mage
Grok에서 커스텀 커넥터로 이미지, 영상, 오디오를 생성해 보세요.
Cursor의 Mage
Cursor 에이전트 모드에서 이미지, 영상, 오디오를 생성해 보세요.
모델
추천 모델
Flux 2 API
긴 프롬프트와 다중 레퍼런스 편집
GPT Image 2 API
정밀한 프롬프트와 읽기 쉬운 텍스트
Guava API
사진처럼 보이는 포토리얼리즘
Mango API
Mage의 대표 이미지 모델 시리즈
Nano Banana 2 API
선명하고 읽기 쉬운 텍스트, 최대 4K
Cherry API
Mage의 대표 영상 모델 시리즈
Lemon API
모든 영상 기능을 더 부담 없는 가격에
Plum API
모든 클립에 사운드 포함, 최대 2K
Seed Audio API
프롬프트 하나로 음성, 음악, 효과음까지
프로덕션을 위해 설계
모든 Mage API 요청에 제공되는 기능
키 하나로 모든 모델
REST API 하나와 Gems 잔액 하나로 쓰는 37개 이미지, 동영상, 오디오 모델. URL 경로만 바꾸면 모델을 전환할 수 있어요.
생성할 때만 결제
구독도, 최소 사용 금액도 없습니다. Gems를 구매하면 요청마다 표시된 가격이 차감됩니다. 생성에 실패하면 환불되지만, Mage 콘텐츠 정책에 따라 차단된 경우는 제외입니다.
안전한 재시도
멱등성 키를 사용하면 재시도한 요청도 추가 결제 없이 원래 요청의 결과를 반환합니다.
일관된 캐릭터
캐릭터나 레퍼런스를 한 번 저장해 두면, 프롬프트에 @handle을 입력해 지원하는 모든 모델에서 사용할 수 있습니다.
대용량 입력
이미지, 영상, 오디오 입력을 URL이나 데이터 URL로 보내거나, 서명된 업로드로 최대 100 MB 파일을 업로드할 수 있습니다.
동시 생성 20개
계정마다 최대 20개의 생성을 동시에 실행할 수 있으며, 사용 목적에 맞게 한도를 늘릴 수도 있습니다. 거부된 요청에는 비용이 청구되지 않습니다.
FAQ
자주 묻는 질문
Mage API는 무엇인가요?
Mage MCP 서버는 무엇인가요?
MCP 서버를 사용하려면 API 키가 필요한가요?
Mage API 요금은 얼마인가요?
API를 사용하려면 Mage 멤버십이 필요한가요?
API로 만든 결과물을 상업적으로 사용할 수 있나요?
요청 제한은 어떻게 되나요?
내 AI 에이전트도 Mage API를 사용할 수 있나요?
Mage API용 SDK가 있나요?
이미 다른 생성 API를 쓰고 있어요. 무엇을 바꿔야 하나요?
Mage로 지금 시작하세요
계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.