W skrócie
Blueberry API uruchamia Blueberry i 1 inny wariant przez Mage pod adresem POST https://api.mage.space/v1/blueberry/generate. Żądanie z domyślnymi ustawieniami kosztuje 360 Gems (ok. 0,36 $), bez subskrypcji. Blueberry przyjmuje zapisane referencje audio przez @handle w prompcie.
Wideo
Wynik
2
Warianty
360
Gems za klip, domyślnie
$0.36
Około, w USD
Przegląd
Co robi Blueberry API
Ustaw pierwszą i ostatnią klatkę, a model dopełni ruch pomiędzy nimi, razem z dźwiękiem. Od 2 do 15 sekund w 720p lub 1080p.
Model wideo, który dopełnia ruch między pierwszą a ostatnią klatką, razem z dźwiękiem; Blueberry 2 to aktualna wersja.
Jako dane wejściowe przyjmuje first_image, last_image.
Szybki start
Wywołaj Blueberry API
Ustaw MAGE_API_KEY, wyślij żądanie do /blueberry/generate i odpytuj status_url, aż żądanie się zakończy.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/blueberry/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": "4",
"model_id": "blueberry-v2"
}' | 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('blueberry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'blueberry-v2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("blueberry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "blueberry-v2",
})
print(request["result"]["url"])Modele
Wartości model_id dla Blueberry
Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.
| model_id | Nazwa | Domyślny |
|---|---|---|
| blueberry | Blueberry | |
| blueberry-v2 | Blueberry | Tak |
Opcje
Parametry Blueberry
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, 4:3, 1:1, 3:4, 9:16 |
| resolution | 720p, 1080p |
| duration | 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
Dane wejściowe
Media, które przyjmuje Blueberry
Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.
| Pole | Rola |
|---|---|
| first_image | Obraz pierwszej klatki. |
| last_image | Obraz ostatniej klatki. |
Zasady
Co wymusza Blueberry API
- Ostatnia klatka jest obsługiwana tylko w `blueberry-v2`.
Więcej modeli wideo
Inne API do generowania wideo w Mage
Wideo · od 618 Gems
Cherry API
Nasza flagowa rodzina modeli wideo
Wideo · od 375 Gems
Grok Video API
Grok Imagine w ruchu
Wideo · od 270 Gems
Kiwi API
Wideo na co dzień, bez konfiguracji
Wideo · od 245 Gems
Lemon API
Wszystkie funkcje wideo w bardziej przyjaznej cenie
Wideo · od 20 Gems
LTX Video API
Szybkie wideo z otwartymi wagami do iteracji
Wideo · od 147 Gems
Melon API
Anime w ruchu, opcjonalnie z dźwiękiem
FAQ
Najczęściej zadawane pytania
Ile kosztuje Blueberry API?
Żądanie Blueberry z domyślnymi ustawieniami (Blueberry) kosztuje 360 Gems, czyli ok. 0,36 $. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę; dokładną opłatę podaje odpowiedź. Za nieudane generowanie zwracamy Gems, a za zablokowane przez zasady treści Mage – nie.
Jaki jest endpoint Blueberry API?
POST https://api.mage.space/v1/blueberry/generate z nagłówkiem Authorization: Bearer zawierającym twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, aby pobrać wynik.
Które modele Blueberry mogę wywołać?
blueberry, blueberry-v2. Domyślny jest Blueberry.
Czy Blueberry obsługuje obrazy referencyjne lub postacie?
Blueberry akceptuje first_image, last_image. Zapisane referencje audio podajesz w prompcie przez @handle.
Czy mogę używać Blueberry w Claude lub ChatGPT?
Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Blueberry po nazwie. Twój asystent odczyta jego opcje przez get_model i poda cenę przed generowaniem.
Jak długo przechowujemy wyniki Blueberry?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.