Przejdź do treści

Mage API · Model wideo

API Plum

Dźwięk w każdym klipie, do 2K

POST https://api.mage.space/v1/plum/generate

W 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_idNazwaDomyślny
plumPlum
plum-maxPlum Max
plum-fastPlum FastTak

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.

PoleWartości
aspect_ratio16:9, 9:16, 1:1, 4:3, 3:4, 21:9
resolution768P, 2K, 480P
duration4, 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.

PoleRola
first_imageObraz pierwszej klatki.
last_imageObraz ostatniej klatki.
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.
videosWideo ź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

  • Wideo · od 360 Gems

    Raspberry API

    Postacie ożywione z pierwszej klatki

  • Wideo · od 618 Gems

    Seedance API

    Seedance z rygorystycznym filtrem

  • Wideo · od 245 Gems

    Wan 3.0 API

    Wan 3.0 z rygorystycznym filtrem

  • Wideo · od 40 Gems

    Wan Video v2.2 API

    Wideo z otwartymi wagami i wariantem Lightning

  • Wideo · od 189 Gems

    Berry API

    Wideo wierne Twoim referencjom

  • Wideo · od 360 Gems

    Blueberry API

    Ustaw pierwszą i ostatnią klatkę

FAQ

Najczęściej zadawane pytania

Ile kosztuje Plum API?
Zapytanie do Plum z domyślnymi ustawieniami (Plum Fast) kosztuje 173 Gems, czyli ok. 0,173 $. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę, a dokładną opłatę podaje odpowiedź. Nieudana generacja jest zwracana, a zablokowana przez zasady treści Mage – nie.
Jaki jest endpoint Plum API?
POST https://api.mage.space/v1/plum/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 Plum mogę wywołać?
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast). Domyślny jest Plum Fast.
Czy Plum obsługuje obrazy referencyjne lub postacie?
Plum przyjmuje first_image, last_image, image, additional_images, videos. Zapisane postacie, referencje i referencje audio podajesz w prompcie przez @handle.
Czy mogę używać Plum w Claude lub ChatGPT?
Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Plum po nazwie. Asystent odczyta jego opcje przez get_model i poda cenę, zanim cokolwiek wygeneruje.
Jak długo przechowywane są wyniki Plum?
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.

CharactersSpołeczność