API di Mage · Modello video
API Cherry
La nostra famiglia video di punta
POST https://api.mage.space/v1/cherry/generateIn breve
L'API Cherry esegue Cherry 2 Pro e altre 4 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 accetta Characters salvati, References e riferimenti audio tramite @handle nel prompt.
- VideoOutput
- 5Varianti
- 618Gems per clip, predefinito
- $0.618Circa, 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, Cherry 2 e Cherry 2 Pro, il più potente. I modelli Cherry 2 creano 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.
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"])Modelli
Valori model_id di Cherry
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2 | Cherry 2 | |
| cherry-2-pro | Cherry 2 Pro | Sì |
Opzioni
Parametri di Cherry
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
Input
Input multimediali accettati da Cherry
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| image | L'immagine di riferimento. |
| additional_images | Immagini di riferimento aggiuntive. |
| videos | I video di partenza. |
Regole
Cosa impone l'API Cherry
- La modifica video richiede esattamente un video di partenza, da 4 a 30 secondi su `cherry-2` e `cherry-2-pro` e da 2 a 15 secondi sugli altri modelli.
- Su `cherry-2` e `cherry-2-pro` una modifica mantiene la durata e il formato 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
API di Grok Video
Grok Imagine, in movimento
API di Kiwi
Video di tutti i giorni, senza configurazione
API Lemon
Tutte le funzioni video, a un prezzo più accessibile
API di LTX Video
Video veloce open-weights per iterare
API Magejutsu
Rifai qualsiasi video mantenendone il movimento
API di Melon
Anime in movimento, con audio opzionale
FAQ
Domande frequenti
Quanto costa l'API Cherry?
Qual è l'endpoint dell'API Cherry?
Quali modelli Cherry posso chiamare?
Cherry supporta immagini di riferimento o personaggi?
Posso usare Cherry da Claude o ChatGPT?
Per quanto tempo vengono conservati i risultati di Cherry?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.