In breve
L'API Melon esegue Melon e un'altra variante tramite Mage su POST https://api.mage.space/v1/melon/generate. Una richiesta con le impostazioni predefinite costa 147 Gems (circa 0,147 $), senza abbonamento. Melon usa personaggi salvati e riferimenti tramite @handle nel prompt.
Video
Output
2
Varianti
147
Gems per clip, predefinito
$0.147
Circa, in USD
Panoramica
Cosa fa l'API Melon
Il nostro modello video per anime, disponibile come Melon e Melon Pro. Fotogrammi iniziale e finale oppure fino a 7 riferimenti o Characters, audio opzionale, da 3 a 16 secondi fino a 1080p.
Il modello video anime di Mage, disponibile come Melon e Melon Pro, con audio opzionale.
Accetta first_image, last_image, image, additional_images come input.
Guida rapida
Chiama l'API di Melon
Imposta MAGE_API_KEY, invia la richiesta a /melon/generate e fai polling su status_url finché la richiesta non è completata.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/melon/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": "melon"
}' | 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('melon', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'melon',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("melon", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "melon",
})
print(request["result"]["url"])Modelli
Valori model_id di Melon
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| melon | Melon | Sì |
| melon-pro | Melon Pro |
Opzioni
Parametri di Melon
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, 3:4, 4:3 |
| resolution | 540p, 720p, 1080p |
| duration | 3, 4, 5, 6, 8, 10, 16 |
Input
Input multimediali accettati da Melon
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. |
Regole
Cosa applica l'API di Melon
- Primo e ultimo fotogramma non si possono combinare con le immagini di riferimento: invia solo un tipo o l'altro.
Altri modelli video
Altre API per generare video su Mage
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
Video · da 189 Gems
API Berry
Video fedeli ai tuoi riferimenti
Video · da 360 Gems
API di Blueberry
Fissa il primo e l'ultimo fotogramma
FAQ
Domande frequenti
Quanto costa l'API di Melon?
Una richiesta Melon con le impostazioni predefinite (Melon) costa 147 Gems, circa 0,147 $. Altre risoluzioni, durate e varianti cambiano il prezzo; la risposta indica l'addebito esatto. Una generazione non riuscita viene rimborsata; una bloccata dalla content policy di Mage no.
Qual è l'endpoint dell'API di Melon?
POST https://api.mage.space/v1/melon/generate con un header Authorization: Bearer contenente la tua chiave API di Mage. La risposta include uno status_url su cui fare polling per ottenere il risultato.
Quali modelli Melon posso chiamare?
melon (Melon), melon-pro (Melon Pro). Il predefinito è Melon.
Melon supporta immagini di riferimento o personaggi?
Melon accetta first_image, last_image, image, additional_images. Melon usa personaggi e riferimenti salvati tramite @handle nel prompt.
Posso usare Melon da Claude o ChatGPT?
Sì. Collega il server MCP di Mage a Claude, ChatGPT, Claude Code, Grok o Cursor e chiedi Melon per nome. Il tuo assistente legge le sue opzioni con get_model e ti indica il prezzo prima di generare.
Per quanto tempo vengono conservati i risultati di Melon?
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.