Mage API · Модель для видео
Cherry API
Наше флагманское семейство видеомоделей
POST https://api.mage.space/v1/cherry/generateГлавное
Cherry API запускает Cherry 2 Pro и ещё 4 варианта через Mage по адресу POST https://api.mage.space/v1/cherry/generate. Запрос с настройками по умолчанию стоит 618 Gems (около $0,618), без подписки. Cherry принимает сохранённых персонажей, референсы и аудиореференсы по @handle в промпте.
- ВидеоРезультат
- 5Варианты
- 618Gems за клип, по умолчанию
- $0.618Примерно, в USD
Обзор
Что умеет Cherry API
Кинематографичное видео со звуком: от Cherry Mini для черновиков до Cherry 2 Pro — нашей самой мощной модели, с клипами до 30 секунд, множеством референсов или Characters и правкой исходного видео.
Флагманская линейка видеомоделей Mage с кинематографичным движением и звуком: Cherry Mini, Cherry, Cherry Pro, Cherry 2 и самая мощная — Cherry 2 Pro. Модели Cherry 2 создают клипы длиной до 30 секунд.
Принимает на вход image, additional_images, videos.
Быстрый старт
Вызов Cherry API
Задайте MAGE_API_KEY, отправьте запрос на /cherry/generate и опрашивайте status_url, пока запрос не завершится.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/cherry/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": "4",
"model_id": "cherry-2-pro"
}' | 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('cherry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'cherry-2-pro',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("cherry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "cherry-2-pro",
})
print(request["result"]["url"])Модели
Значения model_id для Cherry
Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.
| model_id | Название | По умолчанию |
|---|---|---|
| cherry-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| cherry-2 | Cherry 2 | |
| cherry-2-pro | Cherry 2 Pro | Да |
Параметры
Параметры Cherry
Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.
| Поле | Значения |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1 |
| resolution | 480p, 720p, 1080p, 4k |
| duration | 4, 5, 8, 10, 15, 20, 25, 30 |
Входные данные
Входные медиафайлы Cherry
Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.
| Поле | Роль |
|---|---|
| image | Референсное изображение. |
| additional_images | Дополнительные референсные изображения. |
| videos | Исходные видео. |
Правила
Какие ограничения задаёт Cherry API
- Для редактирования видео нужно ровно одно исходное видео длиной от 4 до 30 секунд в `cherry-2` и `cherry-2-pro` и от 2 до 15 секунд в остальных моделях.
- В `cherry-2` и `cherry-2-pro` при редактировании сохраняются длина и соотношение сторон исходного видео: `duration` и `aspect_ratio` игнорируются, а цена зависит от длины видео.
Другие видеомодели
Другие API для генерации видео в Mage
Grok Video API
Grok Imagine в движении
Kiwi API
Повседневное видео без настройки
Lemon API
Все возможности видео по более доступной цене
LTX Video API
Быстрое видео с открытыми весами для итераций
Magejutsu API
Замена героев в любом видео с сохранением движения
Melon API
Аниме в движении, со звуком по желанию
FAQ
Частые вопросы
Сколько стоит Cherry API?
Какой endpoint у Cherry API?
Какие модели Cherry можно вызывать?
Поддерживает ли Cherry референсные изображения или персонажей?
Можно ли использовать Cherry из Claude или ChatGPT?
Как долго хранятся результаты Cherry?
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.