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 | Название | По умолчанию |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Да |
Параметры
Параметры Plum
Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.
| Поле | Значения |
|---|---|
| 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 |
Входные данные
Какие медиафайлы принимает 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
Raspberry API
Персонажи оживают с первого кадра
Seedance API
Seedance со строгим фильтром
Wan 3.0 API
Wan 3.0 со строгим фильтром
Wan Video v2.2 API
Видеомодель с открытыми весами и вариантом Lightning
Berry API
Видео, которое остаётся верным вашим референсам
Blueberry API
Закрепите первый и последний кадр
FAQ
Частые вопросы
Сколько стоит Plum API?
Какой у Plum API эндпоинт?
Какие модели Plum можно вызывать?
Поддерживает ли Plum референс-изображения и персонажей?
Можно ли использовать Plum из Claude или ChatGPT?
Как долго хранятся результаты Plum?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.