Перейти к содержимому

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-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2Cherry 2
cherry-2-proCherry 2 ProДа

Параметры

Параметры Cherry

Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.

ПолеЗначения
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 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

  • Видео · от 375 Gems

    Grok Video API

    Grok Imagine в движении

  • Видео · от 270 Gems

    Kiwi API

    Повседневное видео без настройки

  • Видео · от 245 Gems

    Lemon API

    Все возможности видео по более доступной цене

  • Видео · от 20 Gems

    LTX Video API

    Быстрое видео с открытыми весами для итераций

  • Видео · от 1 856 Gems

    Magejutsu API

    Замена героев в любом видео с сохранением движения

  • Видео · от 147 Gems

    Melon API

    Аниме в движении, со звуком по желанию

FAQ

Частые вопросы

Сколько стоит Cherry API?
Запрос Cherry с настройками по умолчанию (Cherry 2 Pro) стоит 618 Gems, около $0.618. Другие разрешения, длительность и варианты меняют цену; точная сумма списания указана в ответе. Если генерация не удалась, Gems возвращаются; если её заблокировала политика контента Mage — нет.
Какой endpoint у Cherry API?
POST https://api.mage.space/v1/cherry/generate с заголовком Authorization: Bearer, содержащим ваш API-ключ Mage. В ответе приходит status_url, по которому можно опрашивать результат.
Какие модели Cherry можно вызывать?
cherry-mini (Cherry Mini), cherry (Cherry), cherry-pro (Cherry Pro), cherry-2 (Cherry 2), cherry-2-pro (Cherry 2 Pro). По умолчанию используется Cherry 2 Pro.
Поддерживает ли Cherry референсные изображения или персонажей?
Cherry принимает image, additional_images, videos. Сохранённых персонажей, референсы и аудиореференсы Cherry берёт по @handle прямо в промпте.
Можно ли использовать Cherry из Claude или ChatGPT?
Да. Подключите MCP-сервер Mage к Claude, ChatGPT, Claude Code, Grok или Cursor и просто назовите Cherry. Ваш ассистент прочитает его параметры через get_model и назовёт цену до генерации.
Как долго хранятся результаты Cherry?
Результаты и входные файлы хранятся 30 дней. Всё, что нужно сохранить, скачайте в своё хранилище.

Начните создавать с Mage

Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.

CharactersСообщество