Treci la conținut

API Mage · Model video

Cherry API

Familia noastră de modele video de top

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

Pe scurt

Cherry API rulează Cherry 2 Pro și alte 3 variante prin Mage la POST https://api.mage.space/v1/cherry/generate. O cerere cu setările implicite costă 618 Gems (aproximativ $0.618), fără abonament. Cherry acceptă personaje salvate, referințe și referințe audio prin @handle în prompt.

  • VideoRezultat
  • 4Variante
  • 618Gems per clip, implicit
  • $0.618Aproximativ, în USD

Prezentare generală

Ce face Cherry API

Video cinematic cu audio, de la Cherry Mini pentru schițe până la Cherry 2 Pro, cel mai puternic model al nostru, cu clipuri de până la 30 de secunde, multe referințe sau Characters și editări pe baza unui videoclip sursă.

Linia video de top din Mage, cu mișcare cinematică și audio: Cherry Mini, Cherry, Cherry Pro și Cherry 2 Pro, cel mai puternic, cu clipuri de până la 30 de secunde.

Acceptă image, additional_images, videos ca intrări.

Pornire rapidă

Apelează Cherry API

Setează MAGE_API_KEY, trimite cererea la /cherry/generate și interoghează status_url până când cererea se finalizează.

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

Valori model_id pentru Cherry

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
cherry-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2-proCherry 2 ProDa

Opțiuni

Parametrii Cherry

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

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

Intrări

Intrări media acceptate de Cherry

Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.

CâmpRol
imageImaginea de referință.
additional_imagesImagini de referință suplimentare.
videosVideoclipurile sursă.

Reguli

Ce impune Cherry API

  • Editarea video necesită exact un videoclip sursă, de 4–30 de secunde pe `cherry-2-pro` și de 2–15 secunde pe celelalte modele.
  • Pe `cherry-2-pro`, o editare păstrează durata și raportul de aspect ale videoclipului sursă: `duration` și `aspect_ratio` sunt ignorate, iar prețul depinde de durata videoclipului.

Mai multe modele video

Alte API-uri de generare video pe Mage

  • Video · de la 375 Gems

    Grok Video API

    Grok Imagine, în mișcare

  • Video · de la 270 Gems

    Kiwi API

    Video de zi cu zi, fără configurare

  • Video · de la 245 de Gems

    API Lemon

    Toate funcțiile video, la un preț mai prietenos

  • Video · de la 20 Gems

    LTX Video API

    Video rapid cu open-weights, pentru iterații

  • Video · de la 147 Gems

    Melon API

    Anime în mișcare, cu sunet opțional

  • Video · de la 30 Gems

    MiniMax-H3 API

    Video open rapid cu sunet stereo

Întrebări frecvente

Întrebări frecvente

Cât costă Cherry API?
O cerere Cherry cu setările implicite (Cherry 2 Pro) costă 618 Gems, aproximativ $0.618. Alte rezoluții, durate și variante schimbă prețul; răspunsul indică costul exact. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul Cherry API?
POST https://api.mage.space/v1/cherry/generate cu un antet Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi pentru rezultat.
Ce modele Cherry pot apela?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2-pro (Cherry 2 Pro). Implicit este Cherry 2 Pro.
Acceptă Cherry imagini de referință sau personaje?
Cherry acceptă image, additional_images, videos. Cherry folosește personaje salvate, referințe și referințe audio prin @handle în prompt.
Pot folosi Cherry din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Cherry pe nume. Asistentul tău citește opțiunile cu get_model și îți spune prețul înainte să genereze.
Cât timp sunt păstrate rezultatele Cherry?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.