Berry API

In breve

L'API di Berry esegue Berry 2 e un'altra variante tramite Mage su POST https://api.mage.space/v1/berry/generate. Una richiesta con le impostazioni predefinite costa 189 Gems (circa 0,189 $), senza abbonamento. Berry accetta Characters salvati e riferimenti tramite @handle nel prompt.

• Video

  Output

• 2

  Varianti

• 189

  Gems per clip, predefinito

• $0.189

  Circa, in USD

Panoramica

Cosa fa l'API di Berry

Video che resta fedele a ogni riferimento che gli dai. Un frame iniziale, fino a 9 riferimenti o Characters, oppure un video sorgente da modificare; da 3 a 15 secondi fino a 1080p.

Il modello video di Mage basato sui riferimenti, fedele alle immagini che gli fornisci; Berry 2 è la versione attuale. Un primo frame o immagini di riferimento, oppure un video sorgente da modificare.

Accetta come input first_image, image, additional_images, video.

Guida rapida

Richiama l'API di Berry

Imposta MAGE_API_KEY, invia a /berry/generate e interroga status_url finché la richiesta non è completata.

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"])

Modelli

Valori model_id di Berry

Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.

Opzioni

Parametri di Berry

Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.

Input

Input multimediali accettati da Berry

Invia ciascuno come URL https, data URL o upload fino a 100 MB.

Regole

Cosa applica l'API di Berry

• Un primo fotogramma non può essere combinato con immagini di riferimento.
• La modifica video funziona solo con `berry`, non con `berry-2`: invia `model_id: "berry"` con un video di origine da 3 a 60 secondi.

Altri modelli video

Altre API per generare video su Mage

FAQ

Domande frequenti

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.

Correlati

• API per la generazione di video con AI
• Riferimento API di Berry
• Playground di Berry
• Tutti i modelli API
• Server MCP di Mage