텍스트나 이미지로 만드는 AI 영상 생성 API

한눈에 보기

Mage 영상 생성 API는 https://api.mage.space/v1 에서 제공되는 REST API로, Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video, Wan 등 12개의 텍스트 투 비디오 및 이미지 투 비디오 모델을 실행합니다. 프롬프트와 선택 사항인 프레임 또는 참조 자료를 제출하고, 요청 상태를 조회한 뒤 MP4를 다운로드하세요. 클립마다 모델, 해상도, 길이에 따라 Gems로 결제됩니다.

• 12

  영상 모델

• $0.02

  클립당 최저 기본 가격

• 20

  동시 생성 수

• $0

  월 이용료

모델

Mage API의 모든 영상 모델

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

빠른 시작

Berry 2로 영상 생성하기

MAGE_API_KEY를 설정하고 요청을 제출한 뒤 완료될 때까지 조회하세요. URL의 berry를 위의 다른 모델로 바꾸면 됩니다.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "berry-2"
}' | 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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

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 문서