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-mini | Cherry Mini | |
| cherry | Cherry | |
| cherry-pro | Cherry Pro | |
| 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-pro` і від 2 до 15 секунд в інших моделях.
- У `cherry-2-pro` редагування зберігає тривалість і співвідношення сторін вихідного відео: `duration` та `aspect_ratio` ігноруються, а ціна залежить від тривалості відео.
Більше відеомоделей
Інші API для генерації відео на Mage
Grok Video API
Grok Imagine у русі
Kiwi API
Повсякденне відео без налаштувань
Lemon API
Усі відеофункції за привабливішою ціною
LTX Video API
Швидке відео з відкритими вагами для ітерацій
Melon API
Аніме в русі, за бажанням зі звуком
MiniMax-H3 API
Швидке відкрите відео зі стереозвуком
Поширені запитання
Поширені запитання
Скільки коштує Cherry API?
Яка кінцева точка Cherry API?
Які моделі Cherry можна викликати?
Чи підтримує Cherry референсні зображення або персонажів?
Чи можна користуватися Cherry із Claude або ChatGPT?
Як довго зберігаються результати Cherry?
Створюй з Mage
Один акаунт, один баланс Gems, усі моделі. Плати лише за те, що генеруєш.