Přeskočit na obsah

Mage API · Model pro video

Cherry API

Naše vlajková rodina videomodelů

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

Stručně

Cherry API spouští Cherry 2 Pro a 3 další varianty přes Mage na POST https://api.mage.space/v1/cherry/generate. Požadavek s výchozím nastavením stojí 618 Gems (asi 0,618 $), bez předplatného. Cherry bere uložené postavy, reference a audioreference přes @handle v promptu.

  • VideoVýstup
  • 4Varianty
  • 618Gems za klip, výchozí
  • $0.618Přibližně v USD

Přehled

Co umí Cherry API

Filmové video se zvukem, od Cherry Mini pro koncepty po Cherry 2 Pro, náš nejvýkonnější model, s klipy až 30 sekund, mnoha referencemi nebo Characters a úpravami zdrojového videa.

Vlajková videořada Mage s filmovým pohybem a zvukem: Cherry Mini, Cherry, Cherry Pro a nejvýkonnější Cherry 2 Pro s klipy až 30 sekund.

Jako vstup přijímá image, additional_images, videos.

Rychlý start

Zavolej Cherry API

Nastav MAGE_API_KEY, odešli požadavek na /cherry/generate a dotazuj se na status_url, dokud se požadavek nedokončí.

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

Modely

Hodnoty model_id pro Cherry

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
cherry-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2-proCherry 2 ProAno

Možnosti

Parametry Cherry

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

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

Vstupy

Mediální vstupy, které Cherry přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
imageReferenční obrázek.
additional_imagesDalší referenční obrázky.
videosZdrojová videa.

Pravidla

Co Cherry API vynucuje

  • Úprava videa vyžaduje přesně jedno zdrojové video o délce 4 až 30 sekund u `cherry-2-pro` a 2 až 15 sekund u ostatních modelů.
  • U `cherry-2-pro` si úprava zachová délku a poměr stran zdrojového videa: `duration` a `aspect_ratio` se ignorují a cena se řídí délkou videa.

Další video modely

Další API pro generování videa na Mage

  • Video · od 375 Gems

    Grok Video API

    Grok Imagine v pohybu

  • Video · od 270 Gems

    Kiwi API

    Každodenní video bez nastavování

  • Video · od 245 Gems

    Lemon API

    Všechny video funkce za příznivější cenu

  • Video · od 20 Gems

    LTX Video API

    Rychlé video s otevřenými váhami pro iterace

  • Video · od 147 Gems

    Melon API

    Anime v pohybu, volitelně se zvukem

  • Video · od 30 Gems

    MiniMax-H3 API

    Rychlé open video se stereo zvukem

Časté dotazy

Často kladené otázky

Kolik stojí Cherry API?
Požadavek na Cherry s výchozím nastavením (Cherry 2 Pro) stojí 618 Gems, asi 0,618 $. Cena se mění podle rozlišení, délky a varianty; přesnou částku najdeš v odpovědi. Neúspěšná generace se vrací; generace zablokovaná pravidly obsahu Mage ne.
Jaký je endpoint Cherry API?
POST https://api.mage.space/v1/cherry/generate s hlavičkou Authorization: Bearer obsahující tvůj API klíč Mage. Odpověď obsahuje status_url, na kterém se můžeš dotazovat na výsledek.
Které modely Cherry můžu volat?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2-pro (Cherry 2 Pro). Výchozí je Cherry 2 Pro.
Podporuje Cherry referenční obrázky nebo postavy?
Cherry přijímá image, additional_images, videos. Uložené postavy, reference a audioreference bere přes @handle v promptu.
Můžu používat Cherry z Claude nebo ChatGPT?
Ano. Připoj Mage MCP server ke Claude, ChatGPT, Claude Code, Grok nebo Cursor a řekni si o Cherry jeho názvem. Tvůj asistent si přes get_model načte jeho možnosti a před generováním ti sdělí cenu.
Jak dlouho se výsledky z Cherry uchovávají?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.