En un coup d’œil
L'API Lemon exécute Lemon via Mage à l'adresse POST https://api.mage.space/v1/lemon/generate. Une requête avec les réglages par défaut coûte 245 Gems (environ 0,245 $), sans abonnement. Lemon prend en charge les personnages, références et références audio enregistrés via @handle dans le prompt.
Vidéo
Sortie
1
Variante
245
Gems par clip, par défaut
$0.245
Environ, en USD
Présentation
Ce que fait l'API Lemon
Notre modèle vidéo polyvalent. Images de début et de fin, jusqu'à 10 références ou Characters, Voices et audio, et des clips de 2 à 30 secondes jusqu'en 1080p.
Le modèle vidéo polyvalent de Mage à un prix plus doux : images clés, références, Voices, audio généré et clips de 2 à 30 secondes.
Elle accepte first_image, last_image, image, additional_images, videos en entrée.
Démarrage rapide
Appeler l'API Lemon
Définis MAGE_API_KEY, envoie ta requête à /lemon/generate, puis interroge status_url jusqu'à ce que la requête soit terminée.
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"])Modèles
Valeurs de model_id pour Lemon
Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.
| model_id | Nom | Par défaut |
|---|---|---|
| lemon | Lemon | Oui |
Options
Paramètres de Lemon
Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.
| Champ | Valeurs |
|---|---|
| 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 |
Entrées
Médias acceptés par Lemon
Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.
| Champ | Rôle |
|---|---|
| first_image | L'image de la première frame. |
| last_image | L'image de la dernière frame. |
| image | L'image de référence. |
| additional_images | Images de référence supplémentaires. |
| videos | Les vidéos sources. |
Règles
Ce que l'API Lemon impose
- Les première et dernière images ne peuvent pas être combinées avec des images ou vidéos de référence : envoie l'un ou l'autre.
- Jusqu'à 10 images de référence et 5 vidéos de référence.
- Chaque vidéo de référence dure de 1 à 15 secondes, 15 secondes maximum au total, et la durée totale plus `duration` ne dépasse pas 30 secondes. Les secondes de vidéo de référence sont facturées comme les secondes de sortie.
Plus de modèles vidéo
Autres API de génération vidéo sur Mage
Vidéo · à partir de 20 Gems
API LTX Video
Vidéo rapide à poids ouverts pour itérer
Vidéo · à partir de 147 Gems
API Melon
Anime en mouvement, avec audio en option
Vidéo · à partir de 30 Gems
API MiniMax-H3
Vidéo ouverte rapide avec son stéréo
Vidéo · à partir de 338 Gems
API Plum
Du son sur chaque clip, jusqu'en 2K
Vidéo · à partir de 360 Gems
API Raspberry
Des personnages animés à partir d'une première image
Vidéo · à partir de 40 Gems
API Wan Video v2.2
Vidéo open-weights avec une variante Lightning
FAQ
Questions fréquentes
Combien coûte l'API Lemon ?
Une requête Lemon avec les réglages par défaut (Lemon) coûte 245 Gems, soit environ 0,245 $. D'autres résolutions, durées et variantes modifient le prix ; la réponse indique le montant exact débité. Une génération qui échoue est remboursée ; celle que bloque la politique de contenu de Mage ne l'est pas.
Quel est le point de terminaison de l'API Lemon ?
POST https://api.mage.space/v1/lemon/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut une status_url à interroger pour obtenir le résultat.
Quels modèles Lemon puis-je appeler ?
lemon. Le modèle par défaut est Lemon.
Lemon prend-il en charge les images de référence ou les personnages ?
Lemon accepte first_image, last_image, image, additional_images, videos. Lemon gère les personnages, références et références audio enregistrés via @handle dans le prompt.
Puis-je utiliser Lemon depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande Lemon par son nom. Ton assistant lit ses options avec get_model et annonce le prix avant de générer.
Combien de temps les résultats Lemon sont-ils conservés ?
Les résultats et les entrées sont conservés pendant 30 jours. Télécharge tout ce que tu veux garder sur ton propre stockage.
Lance-toi avec Mage
Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.