모든 모델을 한 번에, AI 이미지 생성 API

한눈에 보기

Mage 이미지 생성 API는 https://api.mage.space/v1 에서 제공하는 REST API로, Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2, Krea 2 등 15개의 텍스트-이미지 및 이미지 편집 모델을 실행해요. /{model}/generate에 프롬프트를 POST하고, 요청 상태를 폴링한 뒤 이미지를 내려받으면 돼요. 이미지마다 Gems로 결제하며 구독은 필요 없어요.

• 15

  이미지 모델

• $0.009

  이미지당 최저 기본 가격

• 20

  동시 생성 수

• $0

  월 이용료

모델

Mage API의 모든 이미지 모델

가격은 생성 1회당 Gems 기준이에요. 표준 팩에서는 1,000 Gems가 $1이고, 더 큰 팩에는 보너스 Gems가 붙어요. 가격은 모델, 해상도, 길이에 따라 달라지며, 여기에는 기본 설정 가격이 표시돼요. 정확한 청구액은 응답의 billing.gems_charged에서 확인할 수 있어요. 생성에 실패하면 환불되지만, Mage의 콘텐츠 정책에 따라 차단된 경우에는 환불되지 않아요.

빠른 시작

Anima v1로 이미지 생성하기

MAGE_API_KEY를 설정하고 요청을 제출한 뒤 완료될 때까지 폴링하세요. URL의 anima를 위의 다른 모델로 바꾸면 돼요.

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"

// 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);

# 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 키부터 완성된 결과물까지, 세 번의 호출로

모든 모델이 하나의 인증 방식, 하나의 비동기 요청 흐름, 동일한 필드 이름을 공유합니다.

1. 01

   API 키 만들기

   Mage에 로그인한 뒤 API → API Keys에서 키를 만드세요. 키는 mage_sk_로 시작하며 한 번만 표시됩니다. 계정당 활성 키를 최대 10개까지 보유할 수 있습니다.

2. 02

   생성 요청하기

   Authorization: Bearer 헤더와 함께 https://api.mage.space/v1/{model}/generate로 JSON 본문을 POST하세요. 응답은 request_id, status, status_url과 함께 즉시 반환됩니다. Idempotency-Key 헤더를 보내면 재시도해도 중복 결제되지 않습니다.

3. 03

   상태 확인 및 다운로드

   status가 completed, failed, cancelled 중 하나가 될 때까지 status_url을 폴링하세요. 완료된 요청에는 이미지, 영상 또는 오디오 파일의 result.url이 담기며, 파일은 30일간 보관됩니다.

프로덕션을 위해 설계

모든 Mage API 요청에 제공되는 기능

활용 사례

개발자들이 이미지 API로 만드는 것

FAQ

자주 묻는 질문

Mage로 지금 시작하세요

계정 하나, Gems 잔액 하나로 모든 모델을 사용하세요. 생성한 만큼만 결제하면 됩니다.

관련 항목

• AI 영상 생성 API
• AI 오디오 생성 API
• Mage MCP 서버
• Mage SDK
• ComfyUI용 Mage
• 모든 API 모델
• API 플레이그라운드
• API 문서