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 принимает сохранённых персонажей и референсы через @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
Быстрое видео с открытыми весами для итераций
FAQ
Частые вопросы
Сколько стоит Berry API?
Какой у Berry API эндпоинт?
Какие модели Berry можно вызывать?
Поддерживает ли Berry референсные изображения или персонажей?
Можно ли использовать Berry в Claude или ChatGPT?
Как долго хранятся результаты Berry?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.