API Berry

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éo

  Sortie

• 2

  Variantes

• 189

  Gems par clip, par défaut

• $0.189

  Environ, 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.

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"

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

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

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.

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.

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

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 Berry
• Playground Berry
• Tous les modèles de l'API
• Serveur MCP Mage