Mage API · Tạo ảnh
API tạo ảnh AI cho mọi mô hình
Tạo ảnh từ văn bản, chỉnh sửa ảnh và nhân vật nhất quán từ 18 mô hình, gồm Mango 4 là mô hình chủ lực của Mage, chỉ với một khóa và một số dư.
POST https://api.mage.space/v1/{model}/generateXem nhanh
API tạo ảnh của Mage là REST API tại https://api.mage.space/v1, chạy 18 mô hình tạo ảnh từ văn bản và chỉnh sửa ảnh, gồm Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 và Krea 2. Bạn gửi POST một prompt đến /{model}/generate, kiểm tra trạng thái yêu cầu rồi tải ảnh về. Mỗi ảnh được trả bằng Gems, không cần gói đăng ký.
- 18mô hình ảnh
- $0.009Mặc định rẻ nhất, mỗi ảnh
- 20Lượt tạo đồng thời
- $0Phí hằng tháng
Mô hình
Tất cả mô hình ảnh 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ình | Phù hợp nhất cho | Giá trị model_id | Giá mặc định |
|---|---|---|---|
| Anima | Được xây dựng riêng cho anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Open-weights, xây dựng trên Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Prompt dài và chỉnh sửa với nhiều ảnh tham chiếu | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Prompt chính xác và chữ dễ đọc | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, hai phiên bản | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | Chân thực như ảnh chụp | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Nhanh, đa năng, hỗ trợ negative prompt | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Thẩm mỹ tuyệt đẹp chỉ trong vài giây | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Dòng mô hình ảnh chủ lực của chúng tôi | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Ảnh gốc 16 megapixel, trọng số mở | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Prompt dài và văn bản song ngữ, trọng số mở | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Chữ sắc nét, dễ đọc, lên đến 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL đã khắc phục lỗi khuôn mặt và bàn tay | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, có bộ lọc nghiêm ngặt | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | Bản kinh điển, giá tiết kiệm | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Stable Diffusion hiểu ý bạn nhất | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL tinh chỉnh cho ảnh chân thực | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Mô hình ảnh nhanh nhất trên Mage | z-image-turbo | 10 Gems ($0.01) |
Bắt đầu nhanh
Tạo ảnh với Anima v1
Đặt MAGE_API_KEY, gửi yêu cầu rồi poll cho đến khi hoàn tất. Thay anima trong URL bằng bất kỳ mô hình nào ở trên.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
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.
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.
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.
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
37 mô hình ảnh, video và âm thanh dùng chung một REST API và một số dư Gems. Đổi mô hình bằng cách đổi đườ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
Lập trình viên xây dựng gì với API tạo ảnh
Ảnh sản phẩm và marketing
Tạo ảnh sản phẩm, các biến thể quảng cáo và bài đăng mạng xã hội theo nhu cầu, với chữ dễ đọc nhờ GPT Image 2.6 hoặc Nano Banana 2.
Nhân vật nhất quán
Lưu nhân vật một lần và giữ nguyên khuôn mặt trong cả bộ ảnh với Mango 4, Guava 2 Pro và các mô hình khác hỗ trợ nhắc tên bằng @handle.
Quy trình chỉnh sửa ảnh
Gửi một ảnh gốc kèm hướng dẫn để thay đổi đúng phần bạn yêu cầu và giữ nguyên phần còn lại.
Ứng dụng và game
Tạo avatar, sticker, thẻ và cảnh ngay trong sản phẩm của bạn mà không cần tự vận hành GPU nào.
Chân dung chân thực như ảnh chụp
Guava 2 Pro tạo ra ảnh chân dung, thời trang và lifestyle với làn da, vải vóc và ánh sáng chân thực như đời thật.
Bản nháp nhanh với quy mô lớn
Z-Image Turbo và Krea 2 giữ giá thấp cho ảnh thu nhỏ số lượng lớn và các bản tạo đầu tiên.
FAQ
Câu hỏi thường gặp
API tạo ảnh AI nào tốt nhất?
API tạo ảnh có hỗ trợ chỉnh sửa ảnh và ảnh tham chiếu không?
API tạo ảnh hỗ trợ những độ phân giải nào?
Mage API có giá bao nhiêu?
Tôi có cần gói thành viên Mage để dùng API không?
Tôi có thể dùng kết quả từ API cho mục đích thương mại không?
Giới hạn tốc độ (rate limit) là bao nhiêu?
Agent AI của tôi có dùng được Mage API không?
Mage API có SDK không?
Tôi đang dùng một API tạo nội dung khác. Tôi cần thay đổi những gì?
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.