Cherry API

W skrócie

Cherry API uruchamia Cherry 2 Pro i 3 inne warianty przez Mage pod adresem POST https://api.mage.space/v1/cherry/generate. Zapytanie z domyślnymi ustawieniami kosztuje 618 Gems (ok. 0,618 USD), bez subskrypcji. Cherry przyjmuje zapisane postacie, referencje i referencje audio podawane w prompcie przez @handle.

• Wideo

  Wynik

• 4

  Warianty

• 618

  Gems za klip, domyślnie

• $0.618

  Około, w USD

Przegląd

Co robi Cherry API

Filmowe wideo z dźwiękiem: od Cherry Mini do szkiców po Cherry 2 Pro, nasz najmocniejszy model, z klipami do 30 sekund, wieloma referencjami lub Characters oraz edycją wideo źródłowego.

Flagowa linia wideo Mage z filmowym ruchem i dźwiękiem: Cherry Mini, Cherry, Cherry Pro i Cherry 2 Pro, najmocniejszy, z klipami do 30 sekund.

Przyjmuje jako dane wejściowe: image, additional_images, videos.

Szybki start

Wywołaj Cherry API

Ustaw MAGE_API_KEY, wyślij zapytanie do /cherry/generate i odpytuj status_url, aż zapytanie się zakończy.

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"])

Modele

Wartości model_id dla Cherry

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

Opcje

Parametry Cherry

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

Dane wejściowe

Pliki multimedialne akceptowane przez Cherry

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

Zasady

Jakie ograniczenia stosuje Cherry API

• Edycja wideo wymaga dokładnie jednego wideo źródłowego o długości od 4 do 30 sekund w `cherry-2-pro` i od 2 do 15 sekund w pozostałych modelach.
• W `cherry-2-pro` edycja zachowuje długość i proporcje obrazu oryginalnego wideo: parametry `duration` i `aspect_ratio` są ignorowane, a cena zależy od długości wideo.

Więcej modeli wideo

Inne API do generowania wideo w Mage

FAQ

Najczęściej zadawane pytania

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

Powiązane

• API do generowania wideo AI
• Dokumentacja API Cherry
• Playground Cherry
• Wszystkie modele API
• Serwer MCP Mage