API Mage · SDK
SDK chính thức cho API Mage
Client có định kiểu cho TypeScript và Python, cùng các node Mage cho ComfyUI. Dùng mọi mô hình tạo ảnh, video và âm thanh chỉ với vài dòng code.
Xem nhanh
Mage phát hành các SDK mã nguồn mở cho API của mình: @mage-space/sdk trên npm cho TypeScript và JavaScript, mage-space trên PyPI cho Python, và bộ node comfyui-mage cho ComfyUI. Mỗi SDK bao bọc REST API với cấu hình có kiểu dữ liệu cho cả 37 mô hình, tự động thăm dò kết quả, thử lại an toàn (idempotent) và tải lên tệp.
- 3SDK và tích hợp
- 37Mô hình có định kiểu
- MITMã nguồn mở
- $0Để cài đặt
Chọn SDK của bạn
SDK và tích hợp
npm install @mage-space/sdkSDK TypeScript
Tạo ảnh, video và âm thanh từ Node.js với cấu hình có định kiểu cho mọi mô hình Mage. Một lệnh gọi sẽ gửi yêu cầu, chờ và trả về kết quả.
pip install mage-spaceSDK Python
Tạo ảnh, video và âm thanh từ Python với client đồng bộ và asyncio, cùng cấu hình có định kiểu cho mọi mô hình Mage.
comfy node install comfyui-mageMage cho ComfyUI
Mango, Cherry, Seed Audio và mọi mô hình khác của Mage dưới dạng node ComfyUI. Không cần GPU, không cần tải mô hình.
Bắt đầu nhanh
Lần tạo đầu tiên với SDK
Cài gói, xuất MAGE_API_KEY rồi chạy một mô hình.
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-v4',
});
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-v4",
})
print(request["result"]["url"])Tích hợp sẵn
Những việc SDK nào cũng lo giúp bạn
Một lệnh gọi, có ngay kết quả
run gửi yêu cầu tạo, polling theo backoff mà API khuyến nghị và trả về yêu cầu đã hoàn tất cùng result.url.
Thử lại mà không bao giờ bị tính phí hai lần
Mỗi lần gửi đều kèm một idempotency key. Lỗi mạng và lỗi máy chủ được thử lại với backoff, và lần gửi được thử lại sẽ không bị tính phí thêm.
Tải tệp lên chỉ với một lệnh gọi
Các tệp quá lớn cho data URL sẽ đi qua signed upload, còn ticket, PUT và bước kiểm tra kích thước đã có SDK lo.
Lỗi rõ ràng
Khi API từ chối, bạn nhận được HTTP status, mã lỗi và request id; lần tạo thất bại hoặc bị hủy và lỗi hết thời gian chờ đều có loại lỗi riêng.
Gói
Tải ở đâu
| SDK | Gói | Cài đặt | Mã nguồn |
|---|---|---|---|
| SDK TypeScript | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| SDK Python | mage-space | pip install mage-space | GitHub |
| Mage cho ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
FAQ
Câu hỏi thường gặp
SDK của Mage có miễn phí và là mã nguồn mở không?
Các mô hình Mage mới có chạy được với SDK cũ hơn không?
SDK tránh trả tiền hai lần cho một yêu cầu được thử lại bằng cách nào?
SDK đã ổn định chưa?
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?
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.