Treci la conținut

API Mage · Model video

API Berry

Video fidel referințelor tale

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

Pe scurt

API-ul Berry rulează Berry 2 și încă o variantă prin Mage la POST https://api.mage.space/v1/berry/generate. O cerere cu setările implicite costă 189 Gems (aproximativ 0,189 $), fără abonament. Berry acceptă personaje salvate și referințe prin @handle în prompt.

  • VideoRezultat
  • 2Variante
  • 189Gems per clip, implicit
  • $0.189Aproximativ, în USD

Prezentare generală

Ce face API-ul Berry

Video care rămâne fidel fiecărei referințe pe care i-o dai. Un cadru de start, până la 9 referințe sau Characters, ori un video sursă de editat; de la 3 la 15 secunde, până la 1080p.

Modelul video Mage bazat pe referințe, fidel imaginilor pe care i le dai; Berry 2 este versiunea curentă. Un prim cadru sau imagini de referință, ori un video sursă de editat.

Acceptă ca intrări first_image, image, additional_images, video.

Pornire rapidă

Apelează API-ul Berry

Setează MAGE_API_KEY, trimite cererea la /berry/generate și interoghează status_url până când cererea se finalizează.

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

Modele

Valori model_id pentru Berry

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
berryBerry
berry-2Berry 2Da

Opțiuni

Parametri Berry

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
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

Intrări

Intrări media acceptate de Berry

Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.

CâmpRol
first_imageImaginea primului cadru.
imageImaginea de referință.
additional_imagesImagini de referință suplimentare.
videoVideoclipul sursă.

Reguli

Ce impune API-ul Berry

  • Un prim cadru nu poate fi combinat cu imagini de referință.
  • Editarea video funcționează doar cu `berry`, nu și cu `berry-2`: trimite `model_id: "berry"` cu un videoclip sursă de 3 până la 60 de secunde.

Mai multe modele video

Alte API-uri de generare video pe Mage

  • Video · de la 360 Gems

    Blueberry API

    Fixează primul și ultimul cadru

  • Video · de la 618 Gems

    API Cherry

    Familia noastră principală de modele video

  • Video · de la 375 Gems

    Grok Video API

    Grok Imagine, în mișcare

  • Video · de la 270 Gems

    Kiwi API

    Video de zi cu zi, fără configurare

  • Video · de la 245 de Gems

    API Lemon

    Toate funcțiile video, la un preț mai prietenos

  • Video · de la 20 Gems

    LTX Video API

    Video rapid cu open-weights, pentru iterații

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Berry?
O cerere Berry cu setările implicite (Berry 2) costă 189 Gems, adică aproximativ 0,189 $. Alte rezoluții, durate și variante modifică prețul; răspunsul indică costul exact. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul API-ului Berry?
POST https://api.mage.space/v1/berry/generate cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi periodic pentru a obține rezultatul.
Ce modele Berry pot apela?
berry (Berry), berry-2 (Berry 2). Implicit este Berry 2.
Acceptă Berry imagini de referință sau personaje?
Berry acceptă first_image, image, additional_images, video. Berry folosește personaje salvate și referințe prin @handle în prompt.
Pot folosi Berry din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Berry pe nume. Asistentul tău își citește opțiunile cu get_model și îți spune prețul înainte să genereze.
Cât timp sunt păstrate rezultatele Berry?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.