API Mage · Modèle vidéo
API Cherry
Notre famille de modèles vidéo phare
POST https://api.mage.space/v1/cherry/generateEn un coup d’œil
L'API Cherry fait tourner Cherry 2 Pro et 4 autres variantes via Mage à l'adresse POST https://api.mage.space/v1/cherry/generate. Une requête avec les réglages par défaut coûte 618 Gems (environ 0,618 $), sans abonnement. Cherry accepte les personnages enregistrés, les références et les références audio via @handle dans le prompt.
- VidéoSortie
- 5Variantes
- 618Gems par clip, par défaut
- $0.618Environ, en USD
Présentation
Ce que fait l'API Cherry
De la vidéo cinématographique avec audio, de Cherry Mini pour les brouillons à Cherry 2 Pro, notre modèle le plus puissant, avec des clips jusqu'à 30 secondes, de nombreuses références ou Characters, et des modifications de vidéo source.
La gamme vidéo phare de Mage, avec mouvements cinématographiques et audio : Cherry Mini, Cherry, Cherry Pro, Cherry 2 et Cherry 2 Pro, le plus puissant. Les modèles Cherry 2 créent des clips allant jusqu'à 30 secondes.
Elle accepte image, additional_images et videos en entrée.
Démarrage rapide
Appeler l'API Cherry
Définis MAGE_API_KEY, envoie ta requête à /cherry/generate, puis interroge status_url jusqu'à la fin de la requête.
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"])Modèles
Valeurs model_id de Cherry
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 |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2 | Cherry 2 | |
| cherry-2-pro | Cherry 2 Pro | Oui |
Options
Paramètres de Cherry
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, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
Entrées
Médias acceptés par Cherry
Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.
| Champ | Rôle |
|---|---|
| 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 Cherry impose
- Le montage vidéo prend exactement une vidéo source, de 4 à 30 secondes avec `cherry-2` et `cherry-2-pro`, et de 2 à 15 secondes avec les autres modèles.
- Avec `cherry-2` et `cherry-2-pro`, un montage conserve la durée et le format d'image de sa vidéo source : `duration` et `aspect_ratio` sont ignorés, et le prix dépend de la durée de la vidéo.
Plus de modèles vidéo
Autres API de génération vidéo sur Mage
API Grok Video
Grok Imagine, en mouvement
API Kiwi
La vidéo au quotidien, zéro configuration
API Lemon
Toutes les fonctions vidéo, à un prix plus doux
API LTX Video
Vidéo rapide à poids ouverts pour itérer
API Magejutsu
Redonnez vie à n'importe quelle vidéo en gardant son mouvement
API Melon
Anime en mouvement, avec audio en option
FAQ
Questions fréquentes
Combien coûte l'API Cherry ?
Quel est le endpoint de l'API Cherry ?
Quels modèles Cherry puis-je appeler ?
Cherry prend-il en charge les images de référence ou les personnages ?
Puis-je utiliser Cherry depuis Claude ou ChatGPT ?
Combien de temps les résultats Cherry sont-ils conservés ?
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.