Cherry API

한눈에 보기

Cherry API는 POST https://api.mage.space/v1/cherry/generate 를 통해 Mage에서 Cherry 2 Pro를 포함한 4가지 모델을 실행합니다. 기본 설정으로 요청하면 618 Gems(약 $0.618)가 들며, 구독은 필요 없습니다. Cherry는 프롬프트에서 @handle로 저장된 캐릭터, 레퍼런스, 오디오 레퍼런스를 불러올 수 있습니다.

• 비디오

  출력

• 4

  변형

• 618

  클립당 Gems(기본)

• $0.618

  약 USD 기준

개요

Cherry API로 할 수 있는 일

오디오가 포함된 시네마틱 영상을 만들 수 있습니다. 초안용 Cherry Mini부터 가장 강력한 Cherry 2 Pro까지, 최대 30초 클립, 다수의 레퍼런스 또는 Characters, 원본 영상 편집을 지원합니다.

시네마틱한 움직임과 오디오를 갖춘 Mage의 대표 영상 라인업입니다. Cherry Mini, Cherry, Cherry Pro, 그리고 가장 강력한 Cherry 2 Pro는 최대 30초 클립을 지원합니다.

image, additional_images, videos를 입력으로 받습니다.

빠른 시작

Cherry API 호출하기

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

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

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

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

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

모델

Cherry model_id 값

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

옵션

Cherry 매개변수

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

입력

Cherry가 받는 미디어 입력

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

규칙

Cherry API의 제한 사항

• 영상 편집에는 원본 영상이 정확히 하나 필요하며, `cherry-2-pro`에서는 4~30초, 다른 모델에서는 2~15초여야 합니다.
• `cherry-2-pro`에서 편집하면 원본 영상의 길이와 화면 비율이 그대로 유지돼요. `duration`과 `aspect_ratio`는 무시되고, 가격은 영상 길이에 따라 정해져요.

더 많은 영상 모델

Mage의 다른 영상 생성 API

FAQ

자주 묻는 질문

Mage로 지금 시작하세요

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

관련 항목

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