In breve
La API di Lemon esegue Lemon tramite Mage con POST https://api.mage.space/v1/lemon/generate. Una richiesta con le impostazioni predefinite costa 245 Gems (circa 0,245 $), senza abbonamento. Lemon usa personaggi salvati, riferimenti e riferimenti audio tramite @handle nel prompt.
Video
Output
1
Variante
245
Gems per clip, predefinito
$0.245
Circa, in USD
Panoramica
Cosa fa la API di Lemon
Il nostro modello video versatile. Fotogrammi iniziale e finale, fino a 10 riferimenti o Characters, Voci e audio, e clip da 2 a 30 secondi fino a 1080p.
Il modello video versatile di Mage a un prezzo più conveniente: fotogrammi, riferimenti, Voci, audio generato e clip da 2 a 30 secondi.
Accetta first_image, last_image, image, additional_images, videos come input.
Guida rapida
Chiama la API di Lemon
Imposta MAGE_API_KEY, invia la richiesta a /lemon/generate e interroga status_url finché la richiesta non è completata.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/lemon/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": "3",
"model_id": "lemon"
}' | 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('lemon', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'lemon',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("lemon", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "lemon",
})
print(request["result"]["url"])Modelli
Valori di model_id di Lemon
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| lemon | Lemon | Sì |
Opzioni
Parametri di Lemon
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, 4:3, 1:1, 3:4, 9:16 |
| resolution | 480p, 720p, 1080p |
| duration | 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 |
Input
Contenuti multimediali accettati da Lemon
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| first_image | L'immagine del primo frame. |
| last_image | L'immagine dell'ultimo fotogramma. |
| image | L'immagine di riferimento. |
| additional_images | Immagini di riferimento aggiuntive. |
| videos | I video di partenza. |
Regole
Cosa impone l'API di Lemon
- Primo e ultimo fotogramma non si possono combinare con immagini o video di riferimento: invia l'uno o l'altro.
- Fino a 10 immagini di riferimento e 5 video di riferimento.
- Ogni video di riferimento dura da 1 a 15 secondi, al massimo 15 secondi in totale, e la durata totale più `duration` non può superare i 30 secondi. I secondi dei video di riferimento si fatturano come i secondi di output.
Altri modelli video
Altre API per generare video su Mage
Video · da 20 Gems
API di LTX Video
Video veloce open-weights per iterare
Video · da 147 Gems
API di Melon
Anime in movimento, con audio opzionale
Video · da 30 Gems
API MiniMax-H3
Video open veloce con audio stereo
Video · da 338 Gems
API Plum
Audio su ogni clip, fino a 2K
Video · da 360 Gems
API di Raspberry
Personaggi che prendono vita a partire da un primo fotogramma
Video · da 40 Gems
API Wan Video v2.2
Video open-weights con variante Lightning
FAQ
Domande frequenti
Quanto costa l'API di Lemon?
Una richiesta Lemon con le impostazioni predefinite (Lemon) costa 245 Gems, circa 0,245 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'importo esatto addebitato. Una generazione non riuscita viene rimborsata; una bloccata dalla policy sui contenuti di Mage no.
Qual è l'endpoint dell'API di Lemon?
POST https://api.mage.space/v1/lemon/generate con un header Authorization: Bearer contenente la tua chiave API di Mage. La risposta include uno status_url da interrogare per ottenere il risultato.
Quali modelli Lemon posso richiamare?
lemon. Quello predefinito è Lemon.
Lemon supporta immagini di riferimento o personaggi?
Lemon accetta first_image, last_image, image, additional_images, videos. Lemon usa personaggi salvati, riferimenti e riferimenti audio tramite @handle nel prompt.
Posso usare Lemon da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Lemon per nome. Il tuo assistente legge le opzioni con get_model e ti indica il prezzo prima di generare.
Per quanto tempo vengono conservati i risultati di Lemon?
Risultati e input vengono conservati per 30 giorni. Scarica tutto ciò che vuoi tenere nel tuo spazio di archiviazione.
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.