Mage API · Mô hình hình ảnh

API Mango

Dòng mô hình tạo ảnh hàng đầu của chúng tôi

Lấy khóa APIDùng thử Mango trong playground
POST https://api.mage.space/v1/mango/generate

Xem nhanh

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

Tổng quan

API Mango làm được gì

Dòng mô hình tạo ảnh giúp giữ nhân vật nhất quán, chỉnh sửa chính xác và ghép cảnh từ nhiều ảnh tham chiếu hoặc Characters. Mango 3 dẫn đầu dòng; Mango 3 Turbo nhanh nhất và rẻ nhất, còn Mango 3S đạt đến 3K.

Dòng mô hình tạo ảnh hàng đầu của Mage, giúp giữ nhân vật nhất quán, chỉnh sửa chính xác và ghép cảnh từ nhiều ảnh tham chiếu. Mango 3 (`mango-v3`) là mô hình hiện tại; Mango 3 Turbo (`mango-v3-turbo`) nhanh nhất và rẻ nhất, còn Mango 3S (`mango-v3s`) đạt đến 3K.

Model nhận image, additional_images làm đầu vào.

Bắt đầu nhanh

Gọi API Mango

Đặt MAGE_API_KEY, gửi yêu cầu đến /mango/generate, rồi 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/mango/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "mango-v3"
}' | 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('mango', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'mango-v3',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("mango", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "mango-v3",
})

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

Mô hình

Các giá trị model_id của Mango

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
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3Có
mango-v3-turboMango 3 Turbo

Tùy chọn

Tham số của Mango

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_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Đầu vào

Đầu vào phương tiện Mango 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ò
imageẢnh tham chiếu.
additional_imagesCác ảnh tham chiếu bổ sung.

Thêm mô hình ảnh

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

Ảnh · từ 68 Gems

Nano Banana 2 API

Chữ sắc nét, dễ đọc, lên đến 4K

Ảnh · từ 15 Gems

API SDXL Plus

SDXL đã sửa lỗi khuôn mặt và bàn tay

Ảnh · từ 10 Gems

Stable Diffusion v1.5 API

Bản kinh điển, giá tiết kiệm

Ảnh · từ 10 Gems

Stable Diffusion v3.5 Large API

Bản Stable Diffusion hiểu ý bạn nhất

Ảnh · từ 10 Gems

API Stable Diffusion XL

SDXL tinh chỉnh cho ảnh chân thực

Ảnh · từ 10 Gems

API Z-Image

Mô hình tạo ảnh nhanh nhất trên Mage

FAQ

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

API Mango có giá bao nhiêu?

Một yêu cầu Mango với cài đặt mặc định (Mango 3) có giá 135 Gems, khoảng $0,135. Độ phân giải, thời lượng và biến thể khác sẽ làm giá thay đổi; phản hồi sẽ cho biết chính xác mức phí. Lượt tạo bị lỗi sẽ được hoàn lại; lượt bị chính sách nội dung của Mage chặn thì không.

Endpoint của API Mango là gì?

POST https://api.mage.space/v1/mango/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 Mango nào?

mango (Mango), mango-v2 (Mango 2), mango-v3s (Mango 3S), mango-v3 (Mango 3), mango-v3-turbo (Mango 3 Turbo). Mặc định là Mango 3.

Mango có hỗ trợ ảnh tham chiếu hoặc nhân vật không?

Mango nhận image, additional_images. Mango nhận nhân vật đã lưu và tham chiếu qua @handle trong prompt.

Tôi có thể dùng Mango từ Claude hoặc ChatGPT không?

Có. Hãy kết nối máy chủ Mage MCP với Claude, ChatGPT, Claude Code, Grok hoặc Cursor rồi yêu cầu Mango theo tên. 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ả Mango được lưu giữ 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.

Lấy khóa APIDùng thử Mango trong playground

Liên quan