Mage API · Model wideo
API Berry
Wideo wierne Twoim referencjom
POST https://api.mage.space/v1/berry/generateW skrócie
API Berry uruchamia Berry 2 i 1 inny wariant przez Mage pod adresem POST https://api.mage.space/v1/berry/generate. Zapytanie z ustawieniami domyślnymi kosztuje 189 Gems (około $0.189), bez subskrypcji. Berry przyjmuje zapisane postacie i referencje przez @handle w prompcie.
- WideoWynik
- 2Warianty
- 189Gems za klip, domyślnie
- $0.189Około, w USD
Przegląd
Co potrafi API Berry
Wideo, które pozostaje wierne każdej podanej referencji. Klatka początkowa, do 9 referencji lub Characters albo wideo źródłowe do edycji; od 3 do 15 sekund w rozdzielczości do 1080p.
Model wideo Mage oparty na referencjach, wierny podanym obrazom; Berry 2 to aktualna wersja. Pierwsza klatka lub obrazy referencyjne albo wideo źródłowe do edycji.
Jako dane wejściowe przyjmuje first_image, image, additional_images, video.
Szybki start
Wywołaj API Berry
Ustaw MAGE_API_KEY, wyślij zapytanie do /berry/generate i odpytuj status_url, aż zapytanie się zakończy.
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
Wartości model_id dla Berry
Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.
| model_id | Nazwa | Domyślny |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | Tak |
Opcje
Parametry Berry
Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.
| Pole | Wartości |
|---|---|
| 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 |
Dane wejściowe
Pliki wejściowe obsługiwane przez Berry
Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.
| Pole | Rola |
|---|---|
| first_image | Obraz pierwszej klatki. |
| image | Obraz referencyjny. |
| additional_images | Dodatkowe obrazy referencyjne. |
| video | Źródłowe wideo. |
Zasady
Co wymusza Berry API
- Pierwszej klatki nie można łączyć z obrazami referencyjnymi.
- Edycja wideo działa tylko w `berry`, nie w `berry-2`: wyślij `model_id: "berry"` z wideo źródłowym o długości od 3 do 60 sekund.
Więcej modeli wideo
Inne API do generowania wideo w Mage
Blueberry API
Ustaw pierwszą i ostatnią klatkę
Cherry API
Nasza flagowa rodzina modeli wideo
Grok Video API
Grok Imagine w ruchu
Kiwi API
Wideo na co dzień, bez konfiguracji
Lemon API
Wszystkie funkcje wideo w bardziej przyjaznej cenie
LTX Video API
Szybkie wideo z otwartymi wagami do iteracji
FAQ
Najczęściej zadawane pytania
Ile kosztuje Berry API?
Jaki jest endpoint Berry API?
Które modele Berry mogę wywołać?
Czy Berry obsługuje obrazy referencyjne lub postacie?
Czy mogę używać Berry w Claude lub ChatGPT?
Jak długo przechowywane są wyniki Berry?
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.