Chuyển đến nội dung

Mage API · Mô hình video

Melon API

Anime chuyển động, có thể kèm âm thanh

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

Xem nhanh

Melon API chạy Melon và 1 biến thể khác qua Mage tại POST https://api.mage.space/v1/melon/generate. Một yêu cầu với cài đặt mặc định có giá 147 Gems (khoảng $0.147), không cần đăng ký gói. Melon dùng nhân vật và tham chiếu đã lưu thông qua @handle trong prompt.

  • VideoĐầu ra
  • 2Biến thể
  • 147Gems mỗi clip, mặc định
  • $0.147Khoảng, tính bằng USD

Tổng quan

Melon API làm được gì

Mô hình video anime của chúng tôi, gồm Melon và Melon Pro. Dùng khung hình đầu và cuối hoặc tối đa 7 tham chiếu hay Characters, có thể thêm âm thanh, dài 3 đến 16 giây với độ phân giải tối đa 1080p.

Mô hình video anime của Mage, gồm Melon và Melon Pro, có thể kèm âm thanh.

Nhận first_image, last_image, image, additional_images làm đầu vào.

Bắt đầu nhanh

Gọi API Melon

Đặt MAGE_API_KEY, gửi yêu cầu tới /melon/generate và thăm dò status_url cho đến khi yêu cầu hoàn tất.

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"])

Mô hình

Giá trị model_id của Melon

Gửi model_id để chọn phiên bản. Yêu cầu không có model_id sẽ chạy phiên bản mặc định.

model_idTênMặc định
melonMelonCó
melon-proMelon Pro

Tùy chọn

Tham số của Melon

Các giá trị được phép trên tất cả phiên bản; mỗi phiên bản có thể hỗ trợ ít hơn. Tài liệu liệt kê các tùy chọn theo từng phiên bản.

TrườngGiá trị
aspect_ratio16:9, 9:16, 1:1, 3:4, 4:3
resolution540p, 720p, 1080p
duration3, 4, 5, 6, 8, 10, 16

Đầu vào

Đầu vào media mà Melon hỗ trợ

Gửi mỗi tệp dưới dạng URL https, data URL hoặc tải lên tối đa 100 MB.

TrườngVai trò
first_imageẢnh khung hình đầu tiên.
last_imageẢnh khung hình cuối.
imageẢnh tham chiếu.
additional_imagesCác ảnh tham chiếu bổ sung.

Quy tắc

Các quy tắc API Melon áp dụng

  • Không thể kết hợp khung hình đầu và cuối với ảnh tham chiếu: chỉ gửi một loại.
  • Prompt dài tối đa 5000 ký tự.

Thêm mô hình video

Các API tạo video khác trên Mage

  • Video · từ 45 Gems

    MiniMax-H3 API

    Video mã nguồn mở nhanh, có âm thanh stereo

  • Video · từ 173 Gems

    Plum API

    Có âm thanh cho mọi clip, lên đến 2K

  • Video · từ 360 Gems

    Raspberry API

    Nhân vật sống động từ khung hình đầu tiên

  • Video · từ 618 Gems

    Seedance API

    Seedance, với bộ lọc nghiêm ngặt

  • Video · từ 245 Gems

    Wan 3.0 API

    Wan 3.0, với bộ lọc nghiêm ngặt

  • Video · từ 40 Gems

    Wan Video v2.2 API

    Video open-weights có thêm biến thể Lightning

FAQ

Câu hỏi thường gặp

API Melon có giá bao nhiêu?
Một yêu cầu Melon với cài đặt mặc định (Melon) tốn 147 Gems, khoảng $0.147. Độ phân giải, thời lượng và biến thể khác sẽ thay đổi giá; phản hồi cho biết mức phí chính xác. Lượt tạo thất bại sẽ được hoàn tiền; lượt bị chính sách nội dung của Mage chặn thì không.
Endpoint của API Melon là gì?
POST https://api.mage.space/v1/melon/generate kèm header Authorization: Bearer chứa khóa API Mage của bạn. Phản hồi có status_url để bạn thăm dò kết quả.
Tôi có thể gọi những mô hình Melon nào?
melon (Melon), melon-pro (Melon Pro). Mặc định là Melon.
Melon có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Melon nhận first_image, last_image, image, additional_images. Melon dùng nhân vật và tham chiếu đã lưu qua @handle trong prompt.
Tôi có thể dùng Melon từ Claude hoặc ChatGPT không?
Có. Kết nối máy chủ Mage MCP với Claude, ChatGPT, Claude Code, Grok hoặc Cursor rồi gọi tên Melon. Trợ lý của bạn sẽ đọc các tùy chọn bằng get_model và báo giá trước khi tạo.
Kết quả Melon được lưu trong bao lâu?
Kết quả và đầu vào được lưu trong 30 ngày. Hãy tải về bộ nhớ của bạn bất cứ thứ gì bạn muốn giữ lại.

Bắt đầu xây dựng với Mage

Một tài khoản, một số dư Gems, mọi mô hình. Bạn chỉ trả tiền cho những gì mình tạo.

CharactersCộng đồng