Passer au contenu

API Mage · Modèle vidéo

API Blueberry

Fixe la première et la dernière frame

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

En un coup d’œil

L'API Blueberry exécute Blueberry et 1 autre variante via Mage sur POST https://api.mage.space/v1/blueberry/generate. Une requête avec les paramètres par défaut coûte 360 Gems (environ 0,36 $), sans abonnement. Blueberry accepte les références audio enregistrées via @handle dans le prompt.

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

Présentation

Ce que fait l'API Blueberry

Définis la première et la dernière frame et regarde le mouvement se créer entre les deux, avec de l'audio. De 2 à 15 secondes en 720p ou 1080p.

Un modèle vidéo qui génère le mouvement entre une première et une dernière frame, avec audio ; Blueberry 2 est la version actuelle.

Il accepte first_image, last_image en entrée.

Démarrage rapide

Appeler l'API Blueberry

Définis MAGE_API_KEY, envoie ta requête à /blueberry/generate, puis interroge status_url jusqu'à ce que la requête soit terminée.

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Modèles

Valeurs model_id de Blueberry

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

model_idNomPar défaut
blueberryBlueberry
blueberry-v2BlueberryOui

Options

Paramètres de Blueberry

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

Entrées

Entrées média acceptées par Blueberry

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.
last_imageL'image de la dernière frame.

Règles

Ce que l'API Blueberry impose

  • Une dernière frame n'est prise en charge que sur `blueberry-v2`.

Plus de modèles vidéo

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

  • 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

  • Vidéo · à partir de 1 856 Gems

    API Magejutsu

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

FAQ

Questions fréquentes

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