Mage API · Модель відео
Berry API
Відео, яке лишається вірним твоїм референсам
POST https://api.mage.space/v1/berry/generateКоротко
Berry API запускає Berry 2 і ще 1 варіант через Mage за адресою POST https://api.mage.space/v1/berry/generate. Запит із типовими налаштуваннями коштує 189 Gems (близько $0.189), без підписки. Berry приймає збережені Characters і референси через @handle у промпті.
- ВідеоРезультат
- 2Варіанти
- 189Gems за кліп, типово
- $0.189Приблизно, у USD
Огляд
Що вміє Berry API
Відео, яке лишається вірним кожному референсу, що ти додаєш. Початковий кадр, до 9 референсів або Characters, чи вихідне відео для редагування; від 3 до 15 секунд до 1080p.
Референсна відеомодель Mage, вірна зображенням, які ти додаєш; Berry 2 — поточна версія. Перший кадр або референсні зображення, чи вихідне відео для редагування.
Приймає на вході: first_image, image, additional_images, video.
Швидкий старт
Виклик Berry API
Задай MAGE_API_KEY, надішли запит на /berry/generate і перевіряй status_url, доки запит не завершиться.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "3",
"model_id": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
print(request["result"]["url"])Моделі
Значення model_id для Berry
Передайте model_id, щоб вибрати варіант. Запит без нього використовує варіант за замовчуванням.
| model_id | Назва | За замовчуванням |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | Так |
Параметри
Параметри Berry
Допустимі значення для всіх варіантів; окремий варіант може пропонувати менше. Параметри кожного варіанта наведено в документації.
| Поле | Значення |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
Вхідні дані
Медіавходи, які приймає Berry
Надсилайте кожен файл як https-посилання, data URL або завантаження до 100 МБ.
| Поле | Роль |
|---|---|
| first_image | Зображення першого кадру. |
| image | Референсне зображення. |
| additional_images | Додаткові референсні зображення. |
| video | Вихідне відео. |
Правила
Які обмеження застосовує Berry API
- Перший кадр не можна поєднувати з референсними зображеннями.
- Редагування відео працює лише на `berry`, а не на `berry-2`: надішліть `model_id: "berry"` з вихідним відео тривалістю від 3 до 60 секунд.
Більше відеомоделей
Інші API для генерації відео на Mage
Blueberry API
Закріпіть перший і останній кадр
Cherry API
Наша флагманська лінійка моделей для відео
Grok Video API
Grok Imagine у русі
Kiwi API
Повсякденне відео без налаштувань
Lemon API
Усі відеофункції за привабливішою ціною
LTX Video API
Швидке відео з відкритими вагами для ітерацій
Поширені запитання
Поширені запитання
Скільки коштує Berry API?
Яка кінцева точка Berry API?
Які моделі Berry можна викликати?
Чи підтримує Berry референсні зображення або персонажів?
Чи можна користуватися Berry у Claude або ChatGPT?
Як довго зберігаються результати Berry?
Створюй з Mage
Один акаунт, один баланс Gems, усі моделі. Плати лише за те, що генеруєш.