Plum API

한눈에 보기

Plum API는 POST https://api.mage.space/v1/plum/generate를 통해 Mage에서 Plum Max와 다른 1개 모델을 실행합니다. 기본 설정의 요청은 338 Gems(약 $0.338)이며 구독이 필요 없습니다. Plum은 저장된 캐릭터, 참조, 오디오 참조를 프롬프트에서 @handle로 불러올 수 있습니다.

• 비디오

  출력

• 2

  변형

• 338

  클립당 Gems(기본)

• $0.338

  약 USD 기준

개요

Plum API 기능

클립마다 오디오가 포함되고 최대 2K 출력을 지원하는 풀 기능 영상 모델이에요. 시작·종료 프레임, 최대 9개의 레퍼런스 또는 Characters, Voices를 지원하며 길이는 4~15초예요.

클립마다 오디오를 생성하고 최대 2K까지 출력하는 Mage의 풀 기능 영상 모델로, Plum과 더 빠른 Plum Max가 있어요.

입력으로 first_image, last_image, image, additional_images, videos를 받아요.

빠른 시작

Plum API 호출하기

MAGE_API_KEY를 설정하고 /plum/generate로 요청을 보낸 다음, 요청이 완료될 때까지 status_url을 폴링하세요.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/plum/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": "5",
  "model_id": "plum-max"
}' | 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('plum', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'plum-max',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

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

print(request["result"]["url"])

모델

Plum model_id 값

model_id를 보내 버전을 선택하세요. 지정하지 않으면 기본 모델이 실행됩니다.

옵션

Plum 파라미터

모든 버전에서 허용되는 값입니다. 일부 버전은 지원 범위가 더 좁을 수 있습니다. 버전별 옵션은 문서에서 확인하세요.

입력

Plum이 지원하는 미디어 입력

각각 https URL, data URL 또는 최대 100 MB 업로드로 보내세요.

규칙

Plum API가 적용하는 제한

• 첫 프레임 및 마지막 프레임은 참조 이미지와 함께 사용할 수 없습니다. 둘 중 한 종류만 보내세요.
• `plum-max`에서는 마지막 프레임을 사용하려면 첫 프레임과 함께 지정해야 해요.
• 영상 편집에는 2~15초 길이의 원본 영상 정확히 1개, 출력 `duration`, 그리고 최대 2개의 레퍼런스 이미지가 필요해요. 멘션한 캐릭터와 레퍼런스도 이 개수에 포함돼요. 프레임, 오디오 레퍼런스, 캐릭터 음성은 사용할 수 없어요. 음성이 있는 캐릭터를 멘션하려면 `use_character_voices: false`를 보내세요.
• `plum-max`에서는 원본 영상이 출력보다 초당 더 높은 요금으로 청구돼요. 그래서 768P에서는 편집 비용이 `plum`보다 `plum-max`에서 더 많이 들어요.

더 많은 영상 모델

Mage의 다른 영상 생성 API

FAQ

자주 묻는 질문

Mage로 지금 시작하세요

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

관련 항목

• AI 영상 생성 API
• Plum API 레퍼런스
• Plum 플레이그라운드
• 모든 API 모델
• Mage MCP 서버