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

Mage API · Модель для видео

Melon API

Аниме в движении, с необязательным звуком

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

Главное

Melon API запускает Melon и ещё 1 вариант через Mage по адресу POST https://api.mage.space/v1/melon/generate. Запрос с настройками по умолчанию стоит 147 Gems (около $0,147), без подписки. Сохранённые персонажи и референсы Melon берёт из промпта по @handle.

  • ВидеоРезультат
  • 2Варианты
  • 147Gems за клип, по умолчанию
  • $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НазваниеПо умолчанию
melonMelonДа
melon-proMelon Pro

Параметры

Параметры Melon

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

ПолеЗначения
aspect_ratio16:9, 9:16, 1:1, 3:4, 4:3
resolution540p, 720p, 1080p
duration3, 4, 5, 6, 8, 10, 16

Входные данные

Медиафайлы, которые принимает Melon

Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.

ПолеРоль
first_imageИзображение первого кадра.
last_imageИзображение последнего кадра.
imageРеференсное изображение.
additional_imagesДополнительные референсные изображения.

Правила

Какие ограничения действуют в Melon API

  • Первый и последний кадры нельзя сочетать с референсными изображениями: отправляйте что-то одно.
  • Длина промпта — не более 5000 символов.

Другие видеомодели

Другие API для генерации видео в Mage

  • Видео · от 45 Gems

    MiniMax-H3 API

    Быстрое открытое видео со стереозвуком

  • Видео · от 173 Gems

    Plum API

    Звук в каждом клипе, до 2K

  • Видео · от 360 Gems

    Raspberry API

    Персонажи оживают с первого кадра

  • Видео · от 618 Gems

    Seedance API

    Seedance со строгим фильтром

  • Видео · от 245 Gems

    Wan 3.0 API

    Wan 3.0 со строгим фильтром

  • Видео · от 40 Gems

    Wan Video v2.2 API

    Видеомодель с открытыми весами и вариантом Lightning

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, все модели. Платите только за то, что генерируете.

CharactersСообщество