Главное
Melon API запускает Melon и ещё 1 вариант через Mage по адресу POST https://api.mage.space/v1/melon/generate. Запрос с настройками по умолчанию стоит 147 Gems (около $0,147), без подписки. Сохранённые персонажи и референсы Melon берёт из промпта по @handle.
Видео
Результат
2
Варианты
147
Gems за клип, по умолчанию
$0.147
Примерно, в USD
Обзор
Что умеет Melon API
Наша модель для аниме-видео в версиях Melon и Melon Pro. Начальный и конечный кадры или до 7 референсов либо Characters, необязательный звук, от 3 до 16 секунд, до 1080p.
Аниме-модель Mage для видео в версиях Melon и Melon Pro с возможностью добавить звук.
В качестве входных данных принимает first_image, last_image, image, additional_images.
Быстрый старт
Вызов Melon API
Задайте MAGE_API_KEY, отправьте запрос на /melon/generate и опрашивайте status_url, пока запрос не завершится.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/melon/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": "melon"
}' | 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('melon', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'melon',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("melon", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "melon",
})
print(request["result"]["url"])Модели
Значения model_id для Melon
Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.
| model_id | Название | По умолчанию |
|---|---|---|
| melon | Melon | Да |
| melon-pro | Melon Pro |
Параметры
Параметры Melon
Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.
| Поле | Значения |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 3:4, 4:3 |
| resolution | 540p, 720p, 1080p |
| duration | 3, 4, 5, 6, 8, 10, 16 |
Входные данные
Медиафайлы, которые принимает Melon
Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.
| Поле | Роль |
|---|---|
| first_image | Изображение первого кадра. |
| last_image | Изображение последнего кадра. |
| image | Референсное изображение. |
| additional_images | Дополнительные референсные изображения. |
Правила
Какие ограничения действуют в Melon API
- Первый и последний кадры нельзя сочетать с референсными изображениями: отправляйте что-то одно.
Другие видеомодели
Другие API для генерации видео в Mage
Видео · от 30 Gems
MiniMax-H3 API
Быстрое открытое видео со стереозвуком
Видео · от 338 Gems
Plum API
Звук в каждом клипе, до 2K
Видео · от 360 Gems
Raspberry API
Персонажи оживают с первого кадра
Видео · от 40 Gems
Wan Video v2.2 API
Видеомодель с открытыми весами и вариантом Lightning
Видео · от 189 Gems
Berry API
Видео, которое остаётся верным вашим референсам
Видео · от 360 Gems
Blueberry API
Закрепите первый и последний кадр
FAQ
Частые вопросы
Сколько стоит Melon API?
Запрос к Melon с настройками по умолчанию (Melon) стоит 147 Gems, примерно $0,147. Другие разрешения, длительности и варианты меняют цену; точная сумма списания указана в ответе. За неудачную генерацию Gems возвращаются, а если генерацию блокирует контент-политика Mage — нет.
Какой эндпоинт у Melon API?
POST https://api.mage.space/v1/melon/generate с заголовком Authorization: Bearer, в котором передаётся ваш API-ключ Mage. В ответе приходит status_url, по которому нужно опрашивать результат.
Какие модели Melon можно вызывать?
melon (Melon), melon-pro (Melon Pro). По умолчанию используется Melon.
Поддерживает ли Melon референсные изображения и персонажей?
Melon принимает first_image, last_image, image, additional_images. Сохранённых персонажей и референсы Melon берёт по @handle в промпте.
Можно ли использовать Melon в Claude или ChatGPT?
Да. Подключите MCP-сервер Mage к Claude, ChatGPT, Claude Code, Grok или Cursor и попросите Melon по названию. Ассистент считывает параметры через get_model и называет цену до генерации.
Как долго хранятся результаты Melon?
Результаты и входные файлы хранятся 30 дней. Всё, что нужно сохранить, скачайте в своё хранилище.
Начните создавать с Mage
Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.