Ugrás a tartalomhoz

Mage API · Videómodell

Cherry API

Zászlóshajó videós modellcsaládunk

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

Dióhéjban

A Cherry API a Mage-en keresztül futtatja a Cherry 2 Pro modellt és 3 másik változatot a POST https://api.mage.space/v1/cherry/generate végponton. Egy kérés az alapbeállításokkal 618 Gembe kerül (kb. 0,618 $), előfizetés nélkül. A Cherry a mentett karaktereket, referenciákat és hangreferenciákat a promptban megadott @handle alapján veszi.

  • VideóKimenet
  • 4Variánsok
  • 618Gems klipenként, alapértelmezett
  • $0.618Körülbelül, USD-ben

Áttekintés

Mire jó a Cherry API

Filmszerű videó hanggal: a vázlatokhoz való Cherry Minitől a legerősebb modellünkig, a Cherry 2 Róig, akár 30 másodperces klipekkel, sok referenciával vagy Characters elemmel, valamint forrásvideó-szerkesztéssel.

A Mage zászlóshajó videósorozata filmszerű mozgással és hanggal: Cherry Mini, Cherry, Cherry Pro és a legerősebb Cherry 2 Pro, akár 30 másodperces klipekkel.

Bemenetként az image, additional_images, videos mezőket fogadja.

Gyors kezdés

A Cherry API hívása

Állítsd be a MAGE_API_KEY-t, küldd el a kérést a /cherry/generate végpontra, és kérdezd le a status_url címet, amíg a kérés le nem fut.

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

Modellek

Cherry model_id értékek

Küldj model_id-t a változat kiválasztásához. Ha nincs megadva, az alapértelmezett fut.

model_idNévAlapértelmezett
cherry-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2-proCherry 2 ProIgen

Beállítások

Cherry paraméterek

Az összes változatra megengedett értékek; egy változat kevesebbet kínálhat. A dokumentáció változatonként felsorolja a lehetőségeket.

MezőÉrtékek
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 5, 8, 10, 15, 20, 25, 30

Bemenetek

A Cherry által fogadott médiabemenetek

Mindegyiket küldheted https URL-ként, data URL-ként vagy legfeljebb 100 MB-os feltöltésként.

MezőSzerep
imageA referenciakép.
additional_imagesTovábbi referenciaképek.
videosA forrásvideók.

Szabályok

Mit ír elő a Cherry API

  • A videószerkesztés pontosan egy forrásvideót fogad: a `cherry-2-pro` modellen 4–30 másodperceset, a többi modellen 2–15 másodperceset.
  • A `cherry-2-pro` modellen a szerkesztés megtartja a forrásvideó hosszát és képarányát: a `duration` és az `aspect_ratio` figyelmen kívül marad, az ár pedig a videó hosszától függ.

További videómodellek

További videógeneráló API-k a Mage-en

  • Videó · 375 Gemtől

    Grok Video API

    A Grok Imagine mozgásban

  • Videó · 270 Gemtől

    Kiwi API

    Hétköznapi videók, beállítás nélkül

  • Videó · 245 Gemtől

    Lemon API

    Minden videófunkció, barátibb áron

  • Videó · 20 Gemtől

    LTX Video API

    Gyors, nyílt súlyozású videómodell a finomhangoláshoz

  • Videó · 147 Gemtől

    Melon API

    Anime mozgásban, opcionális hanggal

  • Videó · 30 Gemtől

    MiniMax-H3 API

    Gyors, nyílt videómodell sztereó hanggal

GYIK

Gyakran ismételt kérdések

Mennyibe kerül a Cherry API?
Egy Cherry-kérés az alapbeállításokkal (Cherry 2 Pro) 618 Gembe kerül, ami kb. 0,618 $. Más felbontások, hosszok és változatok módosítják az árat; a válasz megadja a pontos díjat. A sikertelen generálás összegét visszatérítjük, azt viszont nem, amelyet a Mage tartalmi irányelvei letiltanak.
Mi a Cherry API végpontja?
POST https://api.mage.space/v1/cherry/generate, az Authorization: Bearer fejlécben a Mage API-kulcsoddal. A válasz tartalmaz egy status_url címet, amelyet lekérdezve megkapod az eredményt.
Mely Cherry modelleket hívhatom meg?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2-pro (Cherry 2 Pro). Az alapértelmezett a Cherry 2 Pro.
A Cherry támogat referenciaképeket vagy karaktereket?
A Cherry az image, additional_images, videos bemeneteket fogadja. A Cherry a mentett karaktereket, referenciákat és hangreferenciákat a promptban megadott @handle alapján veszi.
Használhatom a Cherryt Claude-ból vagy ChatGPT-ből?
Igen. Csatlakoztasd a Mage MCP-szervert a Claude-hoz, ChatGPT-hez, Claude Code-hoz, Grokhoz vagy Cursorhoz, és kérd név szerint a Cherryt. Az asszisztensed a get_model segítségével olvassa ki a beállításait, és generálás előtt megmondja az árat.
Meddig őrződnek meg a Cherry eredményei?
Az eredményeket és a bemeneteket 30 napig őrizzük. Amit meg szeretnél tartani, töltsd le a saját tárhelyedre.

Kezdj el építeni a Mage-dzsel

Egy fiók, egy Gems-egyenleg, az összes modell. Csak azért fizetsz, amit legenerálsz.