API Cherry

En un coup d’œil

L'API Cherry exécute Cherry 2 Pro et 3 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 utilise les personnages, références et références audio enregistrés via @handle dans le prompt.

• Vidéo

  Sortie

• 4

  Variantes

• 618

  Gems par clip, par défaut

• $0.618

  Environ, 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 mouvement cinématographique et audio : Cherry Mini, Cherry, Cherry Pro et Cherry 2 Pro, le plus puissant, avec des clips 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.

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"

// 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);

# 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.

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.

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.

Règles

Ce que l'API Cherry impose

• La modification vidéo exige exactement une vidéo source, de 4 à 30 secondes avec `cherry-2-pro` et de 2 à 15 secondes avec les autres modèles.
• Sur `cherry-2-pro`, une modification 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

FAQ

Questions fréquentes

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.

À voir aussi

• API de génération de vidéos IA
• Référence de l'API Cherry
• Playground Cherry
• Tous les modèles de l'API
• Serveur MCP Mage