Xem nhanh
API Guava chạy Guava và 4 biến thể khác qua Mage tại POST https://api.mage.space/v1/guava/generate. Một yêu cầu với cài đặt mặc định có giá 37 Gems (khoảng $0.037), không cần đăng ký gói. Guava cho phép dùng nhân vật và tham chiếu đã lưu bằng @handle trong prompt.
Hình ảnh
Đầu ra
5
Biến thể
37
Gems mỗi hình ảnh, mặc định
$0.037
Khoảng, tính bằng USD
Tổng quan
API Guava làm được gì
Dòng model ảnh siêu thực của chúng tôi, dành cho chân dung, thời trang và ảnh sản phẩm với làn da, vải vóc và ánh sáng như thật. Hỗ trợ ảnh tham chiếu hoặc Characters, lên đến 2K.
Dòng mô hình ảnh siêu thực của Mage, dành cho chân dung, thời trang và ảnh sản phẩm trông như ảnh chụp thật, hỗ trợ ảnh tham chiếu. Guava 2 và Guava 2 Pro là cặp mô hình hiện tại.
Model nhận image, additional_images làm đầu vào.
Bắt đầu nhanh
Gọi Guava API
Đặt MAGE_API_KEY, gửi yêu cầu đến /guava/generate và poll status_url cho đến khi yêu cầu hoàn tất.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/guava/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": "guava"
}' | 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('guava', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'guava',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("guava", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "guava",
})
print(request["result"]["url"])Mô hình
Các giá trị model_id của Guava
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_id | Tên | Mặc định |
|---|---|---|
| guava | Guava | Có |
| guava-pro | Guava Pro | |
| guava-pro-v1-5 | Guava Pro 1.5 | |
| guava-2 | Guava 2 | |
| guava-2-pro | Guava 2 Pro |
Tùy chọn
Tham số của Guava
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ường | Giá trị |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
Đầu vào
Đầu vào media mà Guava 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ường | Vai trò |
|---|---|
| image | Ảnh tham chiếu. |
| additional_images | Cá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ừ 20 Gems
HiDream API
Nhanh và linh hoạt, hỗ trợ negative prompt
Ảnh · từ 20 Gems
Krea 2 API
Thẩm mỹ tuyệt đẹp chỉ trong vài giây
Ảnh · từ 135 Gems
Mango API
Dòng mô hình ảnh chủ lực của chúng tôi
Ả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
FAQ
Câu hỏi thường gặp
Guava API có giá bao nhiêu?
Một yêu cầu Guava với cài đặt mặc định (Guava) có giá 37 Gems, khoảng $0,037. Độ 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 Guava API là gì?
POST https://api.mage.space/v1/guava/generate kèm header Authorization: Bearer chứa khóa API Mage của bạn. Phản hồi có một status_url để bạn poll lấy kết quả.
Tôi có thể gọi những mô hình Guava nào?
guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). Mặc định là Guava.
Guava có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Guava nhận image, additional_images. Guava dùng các nhân vật và tham chiếu đã lưu thông qua @handle trong prompt.
Tôi có thể dùng Guava 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 dùng Guava 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ả của Guava đượ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.