API Mage · Model video
API Berry
Video fidel referințelor tale
POST https://api.mage.space/v1/berry/generatePe 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_id | Nume | Implicit |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | Da |
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âmp | Valori |
|---|---|
| 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 |
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âmp | Rol |
|---|---|
| first_image | Imaginea primului cadru. |
| image | Imaginea de referință. |
| additional_images | Imagini de referință suplimentare. |
| video | Videoclipul 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
Blueberry API
Fixează primul și ultimul cadru
API Cherry
Familia noastră principală de modele video
Grok Video API
Grok Imagine, în mișcare
Kiwi API
Video de zi cu zi, fără configurare
API Lemon
Toate funcțiile video, la un preț mai prietenos
LTX Video API
Video rapid cu open-weights, pentru iterații
Întrebări frecvente
Întrebări frecvente
Cât costă API-ul Berry?
Care este endpoint-ul API-ului Berry?
Ce modele Berry pot apela?
Acceptă Berry imagini de referință sau personaje?
Pot folosi Berry din Claude sau ChatGPT?
Cât timp sunt păstrate rezultatele Berry?
Începe să construiești cu Mage
Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.