API Plum

W skrócie

API Plum uruchamia Plum Max i jeszcze jeden wariant przez Mage pod adresem POST https://api.mage.space/v1/plum/generate. Żądanie z ustawieniami domyślnymi kosztuje 338 Gems (około 0,338 $), bez subskrypcji. Zapisane postacie, referencje i referencje audio możesz wywołać w prompcie przez @handle.

• Wideo

  Wynik

• 2

  Warianty

• 338

  Gems za klip, domyślnie

• $0.338

  Okoł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.

Pełnofunkcyjny model wideo Mage z generowanym dźwiękiem w każdym klipie i rozdzielczością do 2K – jako Plum i szybszy Plum Max.

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.

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-max"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// 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-max',
});

console.log(request.result.url);

# 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-max",
})

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.

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.

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.

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` ostatnia klatka musi występować 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

FAQ

Najczęściej zadawane pytania

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

Powiązane

• API do generowania wideo AI
• Dokumentacja Plum API
• Playground Plum
• Wszystkie modele API
• Serwer MCP Mage