API tạo ảnh AI cho mọi mô hình

Xem nhanh

API tạo ảnh của Mage là một REST API tại https://api.mage.space/v1, chạy 15 mô hình tạo ảnh từ văn bản và chỉnh sửa ảnh, gồm Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 và Krea 2. Bạn gửi POST một prompt tới /{model}/generate, poll yêu cầu rồi tải ảnh về. Mỗi ảnh được thanh toán bằng Gems, không cần đăng ký gói.

• 15

  mô hình ảnh

• $0.009

  Mặc định rẻ nhất, mỗi ảnh

• 20

  Lượt tạo đồng thời

• $0

  Phí 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.

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.

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"

// 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);

# 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.

1. 01

   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. 02

   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. 03

   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

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

Lập trình viên xây dựng gì với API tạo ảnh

FAQ

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

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.

Liên quan

• API tạo video AI
• API tạo âm thanh AI
• Máy chủ MCP của Mage
• SDK của Mage
• Mage cho ComfyUI
• Tất cả mô hình API
• Sân chơi API
• Tài liệu API