Перейти к содержимому

Mage API · Модель для видео

Plum API

Звук в каждом клипе, до 2K

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

Главное

Plum API запускает Plum Fast и ещё 2 варианта через Mage по адресу POST https://api.mage.space/v1/plum/generate. Запрос с настройками по умолчанию стоит 173 Gems (около 0,173 $), без подписки. Plum принимает сохранённых персонажей, референсы и аудиореференсы по @handle в промпте.

  • ВидеоРезультат
  • 3Варианты
  • 173Gems за клип, по умолчанию
  • $0.173Примерно, в USD

Обзор

Что умеет Plum API

Полнофункциональная генерация видео со звуком в каждом клипе и разрешением до 2K. Начальный и конечный кадры, до 9 референсов или Characters, а также Voices; от 4 до 15 секунд.

Полнофункциональная видеомодель Mage со сгенерированным звуком в каждом клипе и разрешением до 2K: Plum, более быстрая Plum Max и Plum Fast — самая быстрая и недорогая.

На вход принимает first_image, last_image, image, additional_images, videos.

Быстрый старт

Вызов Plum API

Задайте MAGE_API_KEY, отправьте запрос на /plum/generate и опрашивайте status_url, пока запрос не завершится.

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"])

Модели

Значения model_id для Plum

Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.

model_idНазваниеПо умолчанию
plumPlum
plum-maxPlum Max
plum-fastPlum FastДа

Параметры

Параметры Plum

Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.

ПолеЗначения
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

Входные данные

Какие медиафайлы принимает Plum

Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.

ПолеРоль
first_imageИзображение первого кадра.
last_imageИзображение последнего кадра.
imageРеференсное изображение.
additional_imagesДополнительные референсные изображения.
videosИсходные видео.

Правила

Ограничения Plum API

  • Первый и последний кадры нельзя сочетать с референсными изображениями: отправляйте что-то одно.
  • В `plum-max` и `plum-fast` последний кадр нужно указывать вместе с первым.
  • Для редактирования видео нужно ровно одно исходное видео длительностью от 2 до 15 секунд, `duration` выходного видео и до 2 референс-изображений, включая упомянутых персонажей и референсы. Кадры, аудиореференсы и голоса персонажей не принимаются: чтобы упомянуть персонажа с голосом, передайте `use_character_voices: false`.
  • В `plum-max` исходное видео тарифицируется по более высокой ставке за секунду, чем выходное, поэтому при 768P редактирование в `plum-max` стоит дороже, чем в `plum`.

Другие видеомодели

Другие API для генерации видео в Mage

  • Видео · от 360 Gems

    Raspberry API

    Персонажи оживают с первого кадра

  • Видео · от 618 Gems

    Seedance API

    Seedance со строгим фильтром

  • Видео · от 245 Gems

    Wan 3.0 API

    Wan 3.0 со строгим фильтром

  • Видео · от 40 Gems

    Wan Video v2.2 API

    Видеомодель с открытыми весами и вариантом Lightning

  • Видео · от 189 Gems

    Berry API

    Видео, которое остаётся верным вашим референсам

  • Видео · от 360 Gems

    Blueberry API

    Закрепите первый и последний кадр

FAQ

Частые вопросы

Сколько стоит Plum API?
Запрос к Plum с настройками по умолчанию (Plum Fast) стоит 173 Gems, около 0,173 $. Другие разрешения, длительность и варианты меняют цену; точная стоимость указана в ответе. Если генерация не удалась, Gems возвращаются; если её заблокировала политика контента Mage — нет.
Какой у Plum API эндпоинт?
POST https://api.mage.space/v1/plum/generate с заголовком Authorization: Bearer, содержащим ваш API-ключ Mage. В ответе приходит status_url, по которому нужно опрашивать результат.
Какие модели Plum можно вызывать?
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast). По умолчанию используется Plum Fast.
Поддерживает ли Plum референс-изображения и персонажей?
Plum принимает first_image, last_image, image, additional_images, videos. Сохранённые персонажи, референсы и аудиореференсы подключаются через @handle в промпте.
Можно ли использовать Plum из Claude или ChatGPT?
Да. Подключите MCP-сервер Mage к Claude, ChatGPT, Claude Code, Grok или Cursor и попросите Plum по названию. Ваш ассистент прочитает доступные опции через get_model и назовёт цену до генерации.
Как долго хранятся результаты Plum?
Результаты и входные файлы хранятся 30 дней. Всё, что нужно сохранить, скачайте в своё хранилище.

Начните создавать с Mage

Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.

CharactersСообщество