Перейти до вмісту

Mage API · Модель відео

Cherry API

Наша флагманська лінійка відеомоделей

POST https://api.mage.space/v1/cherry/generate

Коротко

Cherry API запускає Cherry 2 Pro і ще 3 варіанти через Mage за адресою POST https://api.mage.space/v1/cherry/generate. Запит із типовими налаштуваннями коштує 618 Gems (приблизно $0.618), без підписки. Cherry бере збережені персонажі, референси й аудіореференси за @handle у промпті.

  • ВідеоРезультат
  • 4Варіанти
  • 618Gems за кліп, типово
  • $0.618Приблизно, у USD

Огляд

Що вміє Cherry API

Кінематографічне відео зі звуком: від Cherry Mini для чернеток до Cherry 2 Pro, нашої найпотужнішої моделі, з кліпами до 30 секунд, великою кількістю референсів чи Characters і редагуванням вихідного відео.

Флагманська відеолінійка Mage з кінематографічним рухом і звуком: Cherry Mini, Cherry, Cherry Pro і найпотужніша Cherry 2 Pro з кліпами до 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-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-pro` і від 2 до 15 секунд в інших моделях.
  • У `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

    Швидке відео з відкритими вагами для ітерацій

  • Відео · від 147 Gems

    Melon API

    Аніме в русі, за бажанням зі звуком

  • Відео · від 30 Gems

    MiniMax-H3 API

    Швидке відкрите відео зі стереозвуком

Поширені запитання

Поширені запитання

Скільки коштує Cherry API?
Запит до Cherry із типовими налаштуваннями (Cherry 2 Pro) коштує 618 Gems, приблизно $0.618. Інші роздільності, тривалості й варіанти змінюють ціну; точну суму списання показано у відповіді. За невдалу генерацію кошти повертаються; за ту, яку заблокувала політика контенту Mage, — ні.
Яка кінцева точка 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-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, усі моделі. Плати лише за те, що генеруєш.