Passer au contenu

API Mage · Modèle vidéo

API Cherry

Notre famille de modèles vidéo phare

POST https://api.mage.space/v1/cherry/generate

En 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_idNomPar défaut
cherry-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2Cherry 2
cherry-2-proCherry 2 ProOui

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.

ChampValeurs
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 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.

ChampRôle
imageL'image de référence.
additional_imagesImages de référence supplémentaires.
videosLes 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

  • Vidéo · à partir de 375 Gems

    API Grok Video

    Grok Imagine, en mouvement

  • Vidéo · à partir de 270 Gems

    API Kiwi

    La vidéo au quotidien, zéro configuration

  • Vidéo · à partir de 245 Gems

    API Lemon

    Toutes les fonctions vidéo, à un prix plus doux

  • Vidéo · à partir de 20 Gems

    API LTX Video

    Vidéo rapide à poids ouverts pour itérer

  • Vidéo · à partir de 1 856 Gems

    API Magejutsu

    Redonnez vie à n'importe quelle vidéo en gardant son mouvement

  • Vidéo · à partir de 147 Gems

    API Melon

    Anime en mouvement, avec audio en option

FAQ

Questions fréquentes

Combien coûte l'API Cherry ?
Une requête Cherry avec les réglages par défaut (Cherry 2 Pro) coûte 618 Gems, soit environ 0,618 $. 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 bloquée par la politique de contenu de Mage ne l'est pas.
Quel est le endpoint de l'API Cherry ?
POST https://api.mage.space/v1/cherry/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut un status_url à interroger pour obtenir le résultat.
Quels modèles Cherry puis-je appeler ?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2 (Cherry 2), cherry-2-pro (Cherry 2 Pro). Le modèle par défaut est Cherry 2 Pro.
Cherry prend-il en charge les images de référence ou les personnages ?
Cherry accepte image, additional_images et videos. Cherry utilise les personnages, références et références audio enregistrés via @handle dans le prompt.
Puis-je utiliser Cherry depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor, puis demande Cherry par son nom. Ton assistant lit ses options avec get_model et t'indique le prix avant de générer.
Combien de temps les résultats Cherry 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.

CharactersCommunauté