Mage API · Модель відео
Plum API
Звук у кожному кліпі, до 2K
POST https://api.mage.space/v1/plum/generateКоротко
Plum API запускає Plum Max і ще 1 варіант через Mage за адресою POST https://api.mage.space/v1/plum/generate. Запит із типовими налаштуваннями коштує 338 Gems (приблизно $0.338), без підписки. Plum приймає збережених персонажів, референси й аудіореференси за @handle у промпті.
- ВідеоРезультат
- 2Варіанти
- 338Gems за кліп, типово
- $0.338Приблизно, у USD
Огляд
Що вміє Plum API
Повнофункціональне відео зі звуком у кожному кліпі та виводом до 2K. Початковий і кінцевий кадри, до 9 референсів або Characters, а також Voices; від 4 до 15 секунд.
Повнофункціональна відеомодель Mage зі згенерованим звуком у кожному кліпі та виводом до 2K: Plum і швидша Plum Max.
Приймає 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-max"
}' | 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-max',
});
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-max",
})
print(request["result"]["url"])Моделі
Значення model_id для Plum
Передайте model_id, щоб вибрати варіант. Запит без нього використовує варіант за замовчуванням.
| model_id | Назва | За замовчуванням |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | Так |
Параметри
Параметри 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` останній кадр потрібно передавати разом із першим.
- Для редагування відео потрібне рівно одне вихідне відео тривалістю від 2 до 15 секунд, вихідна `duration` і до 2 референсних зображень, враховуючи згаданих персонажів і референси. Кадри, аудіореференси та голоси персонажів не приймаються: надішли `use_character_voices: false`, щоб згадати персонажа, який має голос.
- У `plum-max` вихідне відео оплачується за вищою ставкою за секунду, ніж результат, тому в 768P редагування на `plum-max` коштує дорожче, ніж на `plum`.
Більше відеомоделей
Інші API для генерації відео на Mage
Raspberry API
Персонажі оживають із першого кадру
Wan Video v2.2 API
Відео з відкритими вагами та варіантом Lightning
Berry API
Відео, яке лишається вірним твоїм референсам
Blueberry API
Закріпіть перший і останній кадр
Cherry API
Наша флагманська лінійка моделей для відео
Grok Video API
Grok Imagine у русі
Поширені запитання
Поширені запитання
Скільки коштує Plum API?
Яка кінцева точка Plum API?
Які моделі Plum можна викликати?
Чи підтримує Plum референсні зображення або персонажів?
Чи можна користуватися Plum із Claude або ChatGPT?
Як довго зберігаються результати Plum?
Створюй з Mage
Один акаунт, один баланс Gems, усі моделі. Плати лише за те, що генеруєш.