Passer au contenu

API Mage · Modèle vidéo

API Berry

Une vidéo fidèle à tes références

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

En un coup d’œil

L'API Berry exécute Berry 2 et une autre variante via Mage à l'adresse POST https://api.mage.space/v1/berry/generate. Une requête avec les réglages par défaut coûte 189 Gems (environ 0,189 $), sans abonnement. Berry accepte les personnages et références enregistrés, mentionnés par @handle dans le prompt.

  • VidéoSortie
  • 2Variantes
  • 189Gems par clip, par défaut
  • $0.189Environ, en USD

Présentation

Ce que fait l'API Berry

Une vidéo qui reste fidèle à chacune de tes références. Une image de départ, jusqu'à 9 références ou Characters, ou une vidéo source à modifier ; de 3 à 15 secondes, jusqu'en 1080p.

Le modèle vidéo de Mage piloté par références, fidèle aux images que tu lui donnes ; Berry 2 est la version actuelle. Une première image ou des images de référence, ou une vidéo source à modifier.

Il accepte en entrée : first_image, image, additional_images, video.

Démarrage rapide

Appeler l'API Berry

Définis MAGE_API_KEY, envoie ta requête à /berry/generate, puis interroge status_url jusqu'à la fin de la requête.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "berry-2"
}' | 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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

print(request["result"]["url"])

Modèles

Valeurs model_id de Berry

Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.

model_idNomPar défaut
berryBerry
berry-2Berry 2Oui

Options

Paramètres de Berry

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, 4:3, 3:4, 4:5, 5:4
resolution720p, 1080p, 480p
duration3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Entrées

Médias acceptés en entrée par Berry

Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.

ChampRôle
first_imageL'image de la première frame.
imageL'image de référence.
additional_imagesImages de référence supplémentaires.
videoLa vidéo source.

Règles

Ce que l'API Berry impose

  • Une première frame ne peut pas être associée à des images de référence.
  • L'édition vidéo fonctionne uniquement avec `berry`, pas avec `berry-2` : envoie `model_id: "berry"` avec une vidéo source de 3 à 60 secondes.

Plus de modèles vidéo

Autres API de génération vidéo sur Mage

  • Vidéo · à partir de 360 Gems

    API Blueberry

    Fixe la première et la dernière frame

  • Vidéo · à partir de 618 Gems

    API Cherry

    Notre famille de vidéos phare

  • 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

FAQ

Questions fréquentes

Combien coûte l'API Berry ?
Une requête Berry avec les paramètres par défaut (Berry 2) coûte 189 Gems, soit environ 0,189 $. Les 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 Berry ?
POST https://api.mage.space/v1/berry/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 Berry puis-je appeler ?
berry (Berry), berry-2 (Berry 2). Le modèle par défaut est Berry 2.
Berry prend-il en charge les images de référence ou les personnages ?
Berry accepte first_image, image, additional_images, video. Berry accepte aussi les personnages et références enregistrés, via @handle dans le prompt.
Puis-je utiliser Berry depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande Berry 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 Berry 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é