Mage API · Model wideo
API Plum
Dźwięk w każdym klipie, do 2K
POST https://api.mage.space/v1/plum/generateW skrócie
Plum API uruchamia Plum Fast i 2 inne warianty przez Mage pod adresem POST https://api.mage.space/v1/plum/generate. Zapytanie z domyślnymi ustawieniami kosztuje 173 Gems (ok. 0,173 $), bez subskrypcji. Plum przyjmuje zapisane postacie, referencje i referencje audio przez @handle w prompcie.
- WideoWynik
- 3Warianty
- 173Gems za klip, domyślnie
- $0.173Około, w USD
Przegląd
Co robi Plum API
Pełnofunkcyjne wideo z dźwiękiem w każdym klipie i rozdzielczością do 2K. Klatka początkowa i końcowa, do 9 referencji lub Characters oraz Voices; od 4 do 15 sekund.
Model wideo Mage z pełnią funkcji, z generowanym dźwiękiem w każdym klipie i obrazem do 2K: Plum, szybszy Plum Max oraz Plum Fast, najszybszy i najtańszy.
Jako dane wejściowe przyjmuje first_image, last_image, image, additional_images, videos.
Szybki start
Wywołaj Plum API
Ustaw MAGE_API_KEY, wyślij żądanie do /plum/generate i odpytuj status_url, aż żądanie zostanie zakończone.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/plum/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": "5",
"model_id": "plum-fast"
}' | 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('plum', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '5',
model_id: 'plum-fast',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("plum", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "plum-fast",
})
print(request["result"]["url"])Modele
Wartości model_id dla Plum
Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.
| model_id | Nazwa | Domyślny |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Tak |
Opcje
Parametry Plum
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, 21:9 |
| resolution | 768P, 2K, 480P |
| duration | 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
Dane wejściowe
Pliki wejściowe obsługiwane przez Plum
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. |
| image | Obraz referencyjny. |
| additional_images | Dodatkowe obrazy referencyjne. |
| videos | Wideo źródłowe. |
Zasady
Jakie ograniczenia narzuca Plum API
- Pierwszej i ostatniej klatki nie można łączyć z obrazami referencyjnymi: wyślij tylko jedno z nich.
- W `plum-max` i `plum-fast` ostatnia klatka musi być użyta razem z pierwszą klatką.
- Edycja wideo wymaga dokładnie jednego wideo źródłowego o długości od 2 do 15 sekund, `duration` wyjścia oraz maksymalnie 2 obrazów referencyjnych, wliczając wspomniane postacie i referencje. Nie przyjmuje klatek, referencji audio ani głosów postaci: wyślij `use_character_voices: false`, aby wspomnieć postać, która ma głos.
- W `plum-max` wideo źródłowe jest rozliczane według wyższej stawki za sekundę niż wyjściowe, więc przy 768P edycja kosztuje więcej na `plum-max` niż na `plum`.
Więcej modeli wideo
Inne API do generowania wideo w Mage
Raspberry API
Postacie ożywione z pierwszej klatki
Seedance API
Seedance z rygorystycznym filtrem
Wan 3.0 API
Wan 3.0 z rygorystycznym filtrem
Wan Video v2.2 API
Wideo z otwartymi wagami i wariantem Lightning
Berry API
Wideo wierne Twoim referencjom
Blueberry API
Ustaw pierwszą i ostatnią klatkę
FAQ
Najczęściej zadawane pytania
Ile kosztuje Plum API?
Jaki jest endpoint Plum API?
Które modele Plum mogę wywołać?
Czy Plum obsługuje obrazy referencyjne lub postacie?
Czy mogę używać Plum w Claude lub ChatGPT?
Jak długo przechowywane są wyniki Plum?
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.