Ugrás a tartalomhoz

Mage API · Videómodell

Berry API

Videó, amely hű marad a referenciáidhoz

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

Dióhéjban

A Berry API a Berry 2 modellt és még 1 másik változatot futtat a Mage-en keresztül a POST https://api.mage.space/v1/berry/generate címen. Az alapbeállításokkal indított kérés 189 Gems (kb. $0,189), előfizetés nélkül. A Berry elfogad mentett karaktereket és referenciákat is, amelyeket @handle-lel adhatsz meg a promptban.

  • VideóKimenet
  • 2Variánsok
  • 189Gems klipenként, alapértelmezett
  • $0.189Körülbelül, USD-ben

Áttekintés

Mit tud a Berry API

Videó, amely hű marad minden megadott referenciához. Kezdőkép, legfeljebb 9 referencia vagy Characters, vagy egy szerkesztendő forrásvideó; 3–15 másodperc, legfeljebb 1080p felbontásban.

A Mage referenciavezérelt videómodellje, amely hű marad a megadott képekhez; a Berry 2 az aktuális verzió. Első képkocka vagy referenciaképek, esetleg egy szerkesztendő forrásvideó.

Bemenetként a következőket fogadja: first_image, image, additional_images, video.

Gyors kezdés

Hívd meg a Berry API-t

Állítsd be a MAGE_API_KEY-t, küldd el a kérést a /berry/generate végpontra, és kérdezd le a status_url-t, amíg a kérés le nem fut.

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

Modellek

Berry model_id értékek

Küldj model_id-t a változat kiválasztásához. Ha nincs megadva, az alapértelmezett fut.

model_idNévAlapértelmezett
berryBerry
berry-2Berry 2Igen

Beállítások

Berry paraméterek

Az összes változatra megengedett értékek; egy változat kevesebbet kínálhat. A dokumentáció változatonként felsorolja a lehetőségeket.

MezőÉrtékek
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

Bemenetek

A Berry által elfogadott médiabemenetek

Mindegyiket küldheted https URL-ként, data URL-ként vagy legfeljebb 100 MB-os feltöltésként.

MezőSzerep
first_imageAz első képkocka képe.
imageA referenciakép.
additional_imagesTovábbi referenciaképek.
videoA forrásvideó.

Szabályok

Mit kényszerít ki a Berry API

  • Az első képkocka nem kombinálható referenciaképekkel.
  • A videószerkesztés csak a `berry` modellel működik, a `berry-2` modellel nem: küldd el a `model_id: "berry"` értéket egy 3–60 másodperces forrásvideóval.

További videómodellek

További videógeneráló API-k a Mage-en

  • Videó · 360 Gemtől

    Blueberry API

    Rögzítsd az első és az utolsó képkockát

  • Videó · 618 Gemtől

    Cherry API

    Zászlóshajó videómodellcsaládunk

  • Videó · 375 Gemtől

    Grok Video API

    A Grok Imagine mozgásban

  • Videó · 270 Gemtől

    Kiwi API

    Hétköznapi videók, beállítás nélkül

  • Videó · 245 Gemtől

    Lemon API

    Minden videófunkció, barátibb áron

  • Videó · 20 Gemtől

    LTX Video API

    Gyors, nyílt súlyozású videómodell a finomhangoláshoz

GYIK

Gyakran ismételt kérdések

Mennyibe kerül a Berry API?
Egy Berry-kérés az alapbeállításokkal (Berry 2) 189 Gembe kerül, ami körülbelül 0,189 dollár. Más felbontás, hossz és változat módosítja az árat; a pontos díjat a válasz tartalmazza. A sikertelen generálás összegét visszatérítjük, a Mage tartalmi irányelvei miatt blokkolt generálásét viszont nem.
Mi a Berry API végpontja?
POST https://api.mage.space/v1/berry/generate egy Authorization: Bearer fejléccel, amely a Mage API-kulcsodat tartalmazza. A válasz tartalmaz egy status_url címet, amelyet lekérdezve megkapod az eredményt.
Mely Berry modelleket hívhatom meg?
berry (Berry), berry-2 (Berry 2). Az alapértelmezett a Berry 2.
Támogatja a Berry a referenciaképeket vagy a karaktereket?
A Berry elfogadja a first_image, image, additional_images és video bemeneteket. A Berry a mentett karaktereket és referenciákat a promptban megadott @handle alapján veszi figyelembe.
Használhatom a Berry-t Claude-ból vagy ChatGPT-ből?
Igen. Csatlakoztasd a Mage MCP-szervert a Claude-hoz, ChatGPT-hez, Claude Code-hoz, Grokhoz vagy Cursorhoz, és név szerint kérd a Berry-t. Az asszisztensed a get_model segítségével kiolvassa a lehetőségeit, és generálás előtt megmondja az árat.
Mennyi ideig őrződnek meg a Berry eredményei?
Az eredményeket és a bemeneteket 30 napig őrizzük. Amit meg szeretnél tartani, töltsd le a saját tárhelyedre.

Kezdj el építeni a Mage-dzsel

Egy fiók, egy Gems-egyenleg, az összes modell. Csak azért fizetsz, amit legenerálsz.