Mage API · Tạo video

API tạo video AI từ văn bản hoặc ảnh

Từ văn bản thành video, từ ảnh thành video, khung hình đầu và cuối, và từ ảnh tham chiếu thành video với 12 model, dẫn đầu là Cherry 2 Pro, model chủ lực của Mage, kèm âm thanh cho nhiều clip.

Lấy khóa APIĐọc tài liệu API
POST https://api.mage.space/v1/{model}/generate

Xem nhanh

API tạo video của Mage là một REST API tại https://api.mage.space/v1, chạy 12 model từ văn bản thành video và từ ảnh thành video, gồm Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video và Wan. Bạn gửi prompt cùng khung hình hoặc ảnh tham chiếu (tùy chọn), thăm dò trạng thái yêu cầu rồi tải về tệp MP4. Mỗi clip được trả bằng Gems theo model, độ phân giải và thời lượng.

Mô hình

Tất cả model video trong Mage API

Giá tính theo từng lượt tạo, bằng Gems. 1.000 Gems có giá 1 $ với gói tiêu chuẩn, và các gói lớn hơn được tặng thêm Gems. Giá phụ thuộc vào mô hình, độ phân giải và thời lượng; bảng này hiển thị giá ở cài đặt mặc định, còn mỗi phản hồi đều ghi rõ mức phí chính xác trong billing.gems_charged. Lượt tạo bị lỗi sẽ được hoàn Gems; lượt bị chính sách nội dung của Mage chặn thì không.

Mô hìnhPhù hợp nhất choGiá trị model_idGiá mặc định
BerryVideo bám sát ảnh tham chiếu của bạnberry, berry-2189 Gems ($0.189)
BlueberryCố định khung hình đầu và cuốiblueberry, blueberry-v2360 Gems ($0.36)
CherryDòng video chủ lực của chúng tôicherry-mini, cherry, cherry-pro, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine, chuyển độnggrok-imagine-video375 Gems ($0.375)
KiwiVideo hằng ngày, không cần thiết lậpkiwi270 Gems ($0.27)
LemonĐủ mọi tính năng video, giá dễ chịu hơnlemon245 Gems ($0.245)
LTX VideoVideo open-weights nhanh để thử lặpltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MelonAnime chuyển động, có thể kèm âm thanhmelon, melon-pro147 Gems ($0.147)
MiniMax-H3Video mã nguồn mở nhanh với âm thanh stereominimax-h3-turbo, minimax-h330 Gems ($0.03)
PlumCó âm thanh cho mọi clip, lên đến 2Kplum, plum-max338 Gems ($0.338)
RaspberryNhân vật sống động từ khung hình đầu tiênraspberry360 Gems ($0.36)
Wan Video v2.2Video open-weights với phiên bản Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

Bắt đầu nhanh

Tạo video với Berry 2

Đặt MAGE_API_KEY, gửi yêu cầu rồi thăm dò cho đến khi hoàn tất. Thay berry trong URL bằng bất kỳ model nào ở trên.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "3",
  "model_id": "berry-2"
}' | 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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

print(request["result"]["url"])

Cách hoạt động

Từ khóa API đến thành phẩm chỉ với ba lệnh gọi

Mọi mô hình đều dùng chung một cơ chế xác thực, một vòng đời yêu cầu bất đồng bộ và cùng tên trường.

  1. Tạo khóa API

    Đăng nhập Mage, mở API → API Keys và tạo một khóa. Khóa bắt đầu bằng mage_sk_ và chỉ hiển thị một lần. Mỗi tài khoản có thể có 10 khóa đang hoạt động.

  2. Gửi yêu cầu tạo

    Gửi POST một nội dung JSON đến https://api.mage.space/v1/{model}/generate kèm header Authorization: Bearer. Phản hồi trả về ngay với request_id, status và status_url. Hãy gửi header Idempotency-Key để thử lại không bao giờ bị tính phí hai lần.

  3. Kiểm tra và tải về

    Kiểm tra status_url cho đến khi trạng thái là completed, failed hoặc cancelled. Yêu cầu hoàn tất sẽ có result.url chứa tệp ảnh, video hoặc âm thanh, được lưu trong 30 ngày.

Sẵn sàng cho production

Mỗi yêu cầu Mage API đều nhận được

Một khóa, mọi mô hình

28 mô hình ảnh, video và âm thanh chỉ với một REST API và một số dư Gems. Đổi mô hình bằng cách thay đường dẫn URL.

Trả tiền theo mỗi lần tạo

Không cần đăng ký gói và không có mức chi tối thiểu. Bạn mua Gems, và mỗi yêu cầu sẽ bị tính theo giá niêm yết. Lượt tạo bị lỗi sẽ được hoàn lại, trừ khi bị chặn bởi chính sách nội dung của Mage.

Thử lại an toàn

Khóa idempotency giúp yêu cầu gửi lại trả về kết quả của yêu cầu ban đầu mà không bị tính phí lần nữa.

Nhân vật nhất quán

Chỉ cần lưu nhân vật hoặc ảnh tham chiếu một lần, rồi viết @handle trong bất kỳ prompt nào để dùng với mọi mô hình hỗ trợ.

Dữ liệu đầu vào lớn

Gửi ảnh, video và âm thanh đầu vào dưới dạng URL hoặc data URL, hoặc tải lên tệp tối đa 100 MB qua liên kết tải lên có chữ ký.

20 lượt tạo cùng lúc

Mỗi tài khoản có thể chạy 20 lượt tạo cùng lúc, và giới hạn này có thể được nâng lên theo nhu cầu của bạn. Yêu cầu bị từ chối sẽ không bao giờ bị tính phí.

Trường hợp sử dụng

Nhà phát triển xây dựng gì với API video

Video ngắn và mạng xã hội

Tạo clip dọc cho TikTok, Reels và Shorts từ một prompt hoặc ảnh sản phẩm.

Làm ảnh tĩnh chuyển động

Biến một khung hình đầu, hoặc khung hình đầu và cuối, thành chuyển động với các model từ ảnh thành video như Lemon và Kiwi.

Câu chuyện xoay quanh nhân vật

Giữ cùng một nhân vật qua các cảnh quay với các model từ ảnh tham chiếu thành video hỗ trợ nhân vật dạng @handle.

Video có âm thanh

Plum và một số model khác tạo giọng nói, hiệu ứng âm thanh và âm thanh nền cùng với hình ảnh, đồng thời nhận âm thanh tham chiếu cho giọng nói.

Quảng cáo và demo sản phẩm

Tạo nhiều biến thể của một quảng cáo rồi chọn bản thắng, với cơ chế gửi idempotent không bao giờ tính phí hai lần.

Chỉnh sửa clip có sẵn

Berry, Plum và Grok Video chỉnh sửa video gốc bạn gửi lên; Lemon và MiniMax-H3 còn nhận cả video tham chiếu.

FAQ

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

API tạo video AI nào tốt nhất?

Trên Mage, Cherry 2 Pro là lựa chọn mặc định cho video: hỗ trợ nhân vật, nhiều ảnh tham chiếu, âm thanh tham chiếu, đầu ra từ 480p đến 1080p và clip dài đến 30 giây. Lemon phù hợp khi cần kiểm soát khung hình đầu và cuối, Plum cho clip có âm thanh tạo kèm đến 2K, còn Cherry Mini hoặc Wan cho bản nháp rẻ hơn.

API video có hỗ trợ từ ảnh thành video không?

Có. Các model từ ảnh thành video nhận một khung hình đầu, một số còn nhận khung hình cuối hoặc ảnh tham chiếu, dưới dạng URL, data URL hoặc tệp tải lên. Trang của từng model liệt kê các đầu vào và việc có bắt buộc phải có ảnh hay không.

Video tạo ra có thể dài bao lâu?

Tùy theo model và độ phân giải. Nhiều model tạo video dài từ 4 đến 15 giây, còn Cherry 2 Pro đạt 20, 25 và 30 giây. Trang của từng model liệt kê các thời lượng hỗ trợ.

Tạo một video mất bao lâu?

Tùy theo model, độ phân giải và thời lượng. API hoạt động bất đồng bộ: bạn gửi yêu cầu, sau đó thăm dò status_url với backoff, hoặc để MCP client của bạn chờ bằng get_request.

Mage API có giá bao nhiêu?

Không có gói đăng ký hay phí hàng tháng. Mỗi lượt tạo được trả bằng Gems theo giá niêm yết của mô hình, và 1.000 Gems có giá 1 $ với gói tiêu chuẩn. Trang của từng mô hình đều ghi giá theo cài đặt mặc định, và mỗi phản hồi đều cho biết chính xác khoản đã tính. Lượt tạo bị lỗi sẽ được hoàn lại; lượt bị chặn bởi chính sách nội dung của Mage thì không. Yêu cầu vượt quá số dư của bạn sẽ bị từ chối trước khi tính bất kỳ khoản phí nào.

Tôi có cần gói thành viên Mage để dùng API không?

Không. API chỉ chạy bằng Gems. Các gói thành viên và quyền tạo không giới hạn trong ứng dụng không áp dụng cho các yêu cầu API, nên bất kỳ tài khoản Mage nào có Gems đều có thể gọi API.

Tôi có thể dùng kết quả từ API cho mục đích thương mại không?

Có. Bạn có thể dùng nội dung tạo bằng Mage, kể cả qua API và máy chủ MCP, cho mục đích thương mại. Ghi nguồn thì chúng tôi rất trân trọng nhưng không bắt buộc.

Giới hạn tốc độ (rate limit) là bao nhiêu?

Mỗi tài khoản có thể có tối đa 20 lượt tạo đang chờ hoặc đang chạy cùng lúc. Nếu gửi vượt mức này, yêu cầu sẽ bị từ chối với mã 429 và bạn không mất phí. Hãy gửi email tới [email protected] để nâng giới hạn theo nhu cầu của bạn.

Agent AI của tôi có dùng được Mage API không?

Có. Agent có thể gọi REST API bằng khóa API, hoặc kết nối với máy chủ MCP của Mage, nơi cung cấp cho Claude, ChatGPT, Claude Code, Grok và Cursor 16 công cụ dựng sẵn để chọn mô hình, báo giá, tạo nội dung và lấy kết quả. Xem máy chủ MCP.

Mage API có SDK không?

Có. Gói chính thức @mage-space/sdk trên npm và mage-space trên PyPI đều là mã nguồn mở và có định kiểu cho mọi mô hình. SDK sẽ gửi yêu cầu, chờ kết quả, thử lại an toàn và tải tệp lên giúp bạn. Người dùng ComfyUI có thể cài bộ node comfyui-mage. Xem các SDK của Mage.

Tôi đang dùng một API tạo nội dung khác. Tôi cần thay đổi những gì?

Trỏ client của bạn tới https://api.mage.space/v1, gửi khóa Mage dưới dạng Bearer token và ánh xạ các trường theo trang của mô hình: prompt, aspect_ratio, resolution, duration và model_id hoạt động giống nhau trên mọi mô hình của Mage. Yêu cầu được xử lý bất đồng bộ, nên bạn hãy gửi yêu cầu rồi poll status_url.

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.

Lấy khóa APIĐọc tài liệu API

Liên quan