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

API Z-Image

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

Lấy khóa APIDùng thử Z-Image trong playground
POST https://api.mage.space/v1/z_image/generate

Xem nhanh

API Z-Image chạy Z-Image qua Mage tại POST https://api.mage.space/v1/z_image/generate. Một yêu cầu với cài đặt mặc định có giá 10 Gems (khoảng $0.01), không cần đăng ký gói. Z-Image không nhận mention @handle.

Tổng quan

API Z-Image làm được gì

Siêu nhanh và tiết kiệm Gems. Tạo ảnh từ văn bản chân thực như ảnh chụp, giải phẫu chuẩn, chữ rõ nét, tối đa 2K; không dùng ảnh tham chiếu.

Mô hình tạo ảnh nhanh nhất trên Mage: tạo ảnh từ văn bản chân thực như ảnh chụp, giải phẫu chuẩn, chữ rõ nét, ở 1K hoặc 2K.

Mô hình chỉ tạo ảnh từ prompt.

Bắt đầu nhanh

Gọi API Z-Image

Đặt MAGE_API_KEY, gửi yêu cầu đến /z_image/generate và truy vấn status_url cho đến khi yêu cầu hoàn tất.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/z_image/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": "z-image-turbo"
}' | 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('z_image', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'z-image-turbo',
});

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Mô hình

Các giá trị model_id của Z-Image

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
z-image-turboZ-ImageCó

Tùy chọn

Tham số của Z-Image

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

Thêm mô hình ảnh

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

Ảnh · từ 20 Gems

Anima API

Được tạo riêng cho anime

Ảnh · từ 35 Gems

Chroma API

Trọng số mở, xây dựng trên Flux

Ảnh · từ 40 Gems

Flux 2 API

Prompt dài và chỉnh sửa với nhiều ảnh tham chiếu

Ảnh · từ 9 Gems

GPT Image 2 API

Prompt chính xác và chữ dễ đọc

Ảnh · từ 75 Gems

Grok Image API

Grok Imagine, với ba mức chất lượng

Ảnh · từ 37 Gems

Guava API

Chân thực đến mức như ảnh chụp thật

FAQ

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

API Z-Image có giá bao nhiêu?

Một yêu cầu Z-Image với cài đặt mặc định (Z-Image) có giá 10 Gems, khoảng $0.01. Độ 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, còn lượt bị chính sách nội dung của Mage chặn thì không.

Endpoint của API Z-Image là gì?

POST https://api.mage.space/v1/z_image/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 truy vấn kết quả.

Tôi có thể gọi những mô hình Z-Image nào?

z-image-turbo (Z-Image). Mặc định là Z-Image.

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

Z-Image không nhận đầu vào hình ảnh, video hay âm thanh. Z-Image không nhận mention @handle.

Tôi có thể dùng Z-Image 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 Z-Image 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ả Z-Image được lưu 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ử Z-Image trong playground

Liên quan