Mage API · SDK
Mage API 공식 SDK
TypeScript와 Python용 타입 클라이언트, 그리고 ComfyUI용 Mage 노드. 모든 이미지, 영상, 오디오 모델을 몇 줄의 코드로 쓸 수 있어요.
한눈에 보기
Mage는 API용 오픈 소스 SDK를 공개합니다. TypeScript와 JavaScript용 npm의 @mage-space/sdk, Python용 PyPI의 mage-space, ComfyUI용 comfyui-mage 노드 팩이 있어요. 모두 REST API를 감싸며, 37개 모델 전체에 대한 타입 설정, 자동 폴링, 멱등성 재시도, 업로드를 지원해요.
- 3SDK 및 연동
- 37타입 지원 모델
- MIT오픈소스
- $0설치하기
나에게 맞는 것 고르기
SDK 및 연동
npm install @mage-space/sdkTypeScript SDK
모든 Mage 모델의 타입 설정으로 Node.js에서 이미지, 영상, 오디오를 생성하세요. 호출 한 번으로 요청하고, 기다리고, 결과를 받아요.
pip install mage-spacePython SDK
동기 및 asyncio 클라이언트와 모든 Mage 모델의 타입 설정으로 Python에서 이미지, 영상, 오디오를 생성하세요.
comfy node install comfyui-mageComfyUI용 Mage
Mango, Cherry, Seed Audio를 비롯한 모든 Mage 모델을 ComfyUI 노드로 사용하세요. GPU도, 모델 다운로드도 필요 없습니다.
빠른 시작
SDK로 첫 생성 해 보기
패키지를 설치하고 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"])기본 제공
모든 SDK가 대신 처리해 주는 것
호출 한 번으로 완성된 미디어까지
run은 생성을 요청하고, API가 권장하는 백오프로 폴링한 뒤, result.url이 포함된 완료된 요청을 반환해요.
두 번 결제되지 않는 재시도
모든 요청에는 멱등성 키가 포함돼요. 네트워크 오류와 서버 오류는 백오프를 적용해 재시도하며, 재시도된 요청은 다시 청구되지 않아요.
호출 한 번으로 업로드
데이터 URL로 보내기에 너무 큰 파일은 서명된 업로드를 거치며, 티켓 발급, PUT, 크기 확인을 대신 처리해 줘요.
알기 쉬운 오류
API 거부 응답에는 HTTP 상태, 오류 코드, 요청 ID가 포함돼요. 실패하거나 취소된 생성과 시간 초과에는 각각 별도의 오류 유형이 있어요.
패키지
어디서 받을 수 있나요
| SDK | 패키지 | 설치 | 소스 |
|---|---|---|---|
| TypeScript SDK | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| Python SDK | mage-space | pip install mage-space | GitHub |
| ComfyUI용 Mage | comfyui-mage | comfy node install comfyui-mage | GitHub |
FAQ
자주 묻는 질문
Mage SDK는 무료인가요? 오픈소스인가요?
새로운 Mage 모델도 이전 버전 SDK에서 작동하나요?
SDK는 재시도한 요청에 대해 이중 결제를 어떻게 막나요?
SDK는 안정적인가요?
Mage API 요금은 얼마인가요?
API를 사용하려면 Mage 멤버십이 필요한가요?
API로 만든 결과물을 상업적으로 사용할 수 있나요?
Mage로 지금 시작하세요
계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.