API Mage · Modèle vidéo
API Berry
Une vidéo fidèle à tes références
POST https://api.mage.space/v1/berry/generateEn 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_id | Nom | Par défaut |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | Oui |
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.
| Champ | Valeurs |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 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.
| Champ | Rôle |
|---|---|
| first_image | L'image de la première frame. |
| image | L'image de référence. |
| additional_images | Images de référence supplémentaires. |
| video | La 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
API Blueberry
Fixe la première et la dernière frame
API Cherry
Notre famille de vidéos phare
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
FAQ
Questions fréquentes
Combien coûte l'API Berry ?
Quel est le point de terminaison de l'API Berry ?
Quels modèles Berry puis-je appeler ?
Berry prend-il en charge les images de référence ou les personnages ?
Puis-je utiliser Berry depuis Claude ou ChatGPT ?
Combien de temps les résultats Berry 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.