API Cherry

In breve

L'API Cherry esegue Cherry 2 Pro e altre 3 varianti tramite Mage su POST https://api.mage.space/v1/cherry/generate. Una richiesta con le impostazioni predefinite costa 618 Gems (circa 0,618 $), senza abbonamento. Cherry usa personaggi, riferimenti e riferimenti audio salvati tramite @handle nel prompt.

• Video

  Output

• 4

  Varianti

• 618

  Gems per clip, predefinito

• $0.618

  Circa, in USD

Panoramica

Cosa fa l'API Cherry

Video cinematografici con audio, da Cherry Mini per le bozze a Cherry 2 Pro, il nostro modello più potente, con clip fino a 30 secondi, molti riferimenti o Characters e modifiche di video di partenza.

La linea video di punta di Mage, con movimento cinematografico e audio: Cherry Mini, Cherry, Cherry Pro e Cherry 2 Pro, il più potente, con clip fino a 30 secondi.

Accetta image, additional_images, videos come input.

Guida rapida

Chiama l'API Cherry

Imposta MAGE_API_KEY, invia a /cherry/generate e interroga status_url finché la richiesta non è completata.

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

Modelli

Valori model_id di Cherry

Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.

Opzioni

Parametri di Cherry

Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.

Input

Input multimediali accettati da Cherry

Invia ciascuno come URL https, data URL o upload fino a 100 MB.

Regole

Cosa impone l'API Cherry

• La modifica video richiede esattamente un video di partenza, di 4-30 secondi con `cherry-2-pro` e di 2-15 secondi con gli altri modelli.
• Su `cherry-2-pro` una modifica mantiene la durata e le proporzioni del video di partenza: `duration` e `aspect_ratio` vengono ignorati e il prezzo dipende dalla durata del video.

Altri modelli video

Altre API per generare video su Mage

FAQ

Domande frequenti

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.

Correlati

• API per la generazione di video con AI
• Riferimento API di Cherry
• Playground di Cherry
• Tutti i modelli API
• Server MCP di Mage