Przejdź do treści

Mage API · Model wideo

Cherry API

Nasza flagowa rodzina modeli wideo

POST https://api.mage.space/v1/cherry/generate

W skrócie

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

  • WideoWynik
  • 5Warianty
  • 618Gems za klip, domyślnie
  • $0.618Okoł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, Cherry 2 i najpotężniejszy Cherry 2 Pro. Modele Cherry 2 tworzą klipy 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.

cURL
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"
TypeScript
// 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);
Python
# 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.

model_idNazwaDomyślny
cherry-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2Cherry 2
cherry-2-proCherry 2 ProTak

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.

PoleWartości
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 5, 8, 10, 15, 20, 25, 30

Dane wejściowe

Pliki multimedialne akceptowane przez Cherry

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

PoleRola
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.
videosWideo źródłowe.

Zasady

Jakie ograniczenia stosuje Cherry API

  • Edycja wideo przyjmuje dokładnie jedno wideo źródłowe: od 4 do 30 sekund w `cherry-2` i `cherry-2-pro` oraz od 2 do 15 sekund w pozostałych modelach.
  • W `cherry-2` i `cherry-2-pro` edycja zachowuje długość i proporcje wideo źródłowego: `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

  • Wideo · od 375 Gems

    Grok Video API

    Grok Imagine w ruchu

  • Wideo · od 270 Gems

    Kiwi API

    Wideo na co dzień, bez konfiguracji

  • Wideo · od 245 Gems

    Lemon API

    Wszystkie funkcje wideo w bardziej przyjaznej cenie

  • Wideo · od 20 Gems

    LTX Video API

    Szybkie wideo z otwartymi wagami do iteracji

  • Wideo · od 1856 Gems

    Magejutsu API

    Zmień obsadę dowolnego wideo, zachowując jego ruch

  • Wideo · od 147 Gems

    Melon API

    Anime w ruchu, opcjonalnie z dźwiękiem

FAQ

Najczęściej zadawane pytania

Ile kosztuje Cherry API?
Zapytanie do Cherry z domyślnymi ustawieniami (Cherry 2 Pro) kosztuje 618 Gems, czyli ok. 0,618 USD. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę; dokładną kwotę podaje odpowiedź. Za nieudane generowanie zwracamy koszt, a za zablokowane przez zasady dotyczące treści Mage – nie.
Jaki jest endpoint Cherry API?
POST https://api.mage.space/v1/cherry/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz o wynik.
Które modele Cherry mogę wywołać?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2 (Cherry 2), cherry-2-pro (Cherry 2 Pro). Domyślnie używany jest Cherry 2 Pro.
Czy Cherry obsługuje obrazy referencyjne lub postacie?
Cherry akceptuje image, additional_images, videos. Zapisane postacie, referencje i referencje audio podajesz w prompcie przez @handle.
Czy mogę używać Cherry w Claude lub ChatGPT?
Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Cherry po nazwie. Twój asystent odczyta jego opcje przez get_model i poda cenę przed generowaniem.
Jak długo przechowujemy wyniki Cherry?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

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

CharactersSpołeczność