Mage API · Videomodel
Berry API
Video die trouw blijft aan je referenties
POST https://api.mage.space/v1/berry/generateIn één oogopslag
De Berry API draait Berry 2 en 1 andere variant via Mage op POST https://api.mage.space/v1/berry/generate. Een verzoek met de standaardinstellingen kost 189 Gems (ongeveer $0,189), zonder abonnement. Berry accepteert opgeslagen Characters en References via @handle in de prompt.
- VideoUitvoer
- 2Varianten
- 189Gems per clip (standaard)
- $0.189Ongeveer, in USD
Overzicht
Wat de Berry API doet
Video die trouw blijft aan elke referentie die je geeft. Een startframe, tot 9 referenties of Characters, of een bronvideo om te bewerken; 3 tot 15 seconden in maximaal 1080p.
Het videomodel van Mage dat op referenties draait en trouw blijft aan de afbeeldingen die je geeft; Berry 2 is de huidige versie. Een eerste frame of referentie-afbeeldingen, of een bronvideo om te bewerken.
Het accepteert first_image, image, additional_images en video als invoer.
Snel starten
De Berry API aanroepen
Stel MAGE_API_KEY in, verstuur naar /berry/generate en poll status_url tot het verzoek klaar is.
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"])Modellen
Berry model_id-waarden
Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.
| model_id | Naam | Standaard |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | Ja |
Opties
Berry-parameters
Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.
| Veld | Waarden |
|---|---|
| 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 |
Invoer
Media-invoer die Berry accepteert
Stuur elk als https-URL, data-URL of upload tot 100 MB.
| Veld | Rol |
|---|---|
| first_image | De afbeelding van het eerste frame. |
| image | De referentieafbeelding. |
| additional_images | Extra referentieafbeeldingen. |
| video | De bronvideo. |
Regels
Wat de Berry API afdwingt
- Een eerste frame kan niet worden gecombineerd met referentieafbeeldingen.
- Videobewerking werkt alleen met `berry`, niet met `berry-2`: stuur `model_id: "berry"` mee met een bronvideo van 3 tot 60 seconden.
Meer videomodellen
Andere API's voor videogeneratie op Mage
Blueberry API
Leg het eerste en laatste frame vast
Cherry API
Onze vlaggenschip-videofamilie
Grok Video API
Grok Imagine, in beweging
Kiwi API
Video voor elke dag, zonder setup
Lemon API
Alle videofuncties, tegen een vriendelijkere prijs
LTX Video API
Snelle open-weights video om mee te itereren
FAQ
Veelgestelde vragen
Wat kost de Berry API?
Wat is het endpoint van de Berry API?
Welke Berry-modellen kan ik aanroepen?
Ondersteunt Berry referentieafbeeldingen of personages?
Kan ik Berry gebruiken vanuit Claude of ChatGPT?
Hoe lang worden Berry-resultaten bewaard?
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.