Xem nhanh
HiDream API chạy HiDream qua Mage tại POST https://api.mage.space/v1/hidream/generate. Một yêu cầu với cài đặt mặc định có giá 20 Gems (khoảng $0,02), không cần đăng ký gói. HiDream không hỗ trợ @handle.
Hình ảnh
Đầu ra
1
Biến thể
20
Gems mỗi hình ảnh, mặc định
$0.02
Khoảng, tính bằng USD
Tổng quan
HiDream API làm được gì
Mô hình tạo ảnh từ văn bản đa năng, nhanh, có negative prompt. Rất hợp với các prompt hằng ngày, từ ảnh siêu thực đến tranh minh họa.
Mô hình ảnh đa năng, nhanh, có negative prompt, tạo ảnh siêu thực hoặc minh họa.
Mô hình chỉ tạo ảnh từ prompt.
Bắt đầu nhanh
Gọi HiDream API
Đặt MAGE_API_KEY, gửi yêu cầu đến /hidream/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/hidream/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": "hidream-fast"
}' | 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('hidream', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'hidream-fast',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("hidream", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "hidream-fast",
})
print(request["result"]["url"])Mô hình
Các giá trị model_id của HiDream
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 |
|---|---|---|
| hidream-fast | HiDream | Có |
Tùy chọn
Tham số của HiDream
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 |
Thêm mô hình ảnh
Các API tạo ảnh khác trên Mage
Ả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
Ảnh · từ 10 Gems
Stable Diffusion v3.5 Large API
Bản Stable Diffusion hiểu ý bạn nhất
FAQ
Câu hỏi thường gặp
HiDream API có giá bao nhiêu?
Một yêu cầu HiDream với cài đặt mặc định (HiDream) có giá 20 Gems, khoảng $0,02. Độ 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 HiDream API là gì?
POST https://api.mage.space/v1/hidream/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 HiDream nào?
hidream-fast. Mặc định là HiDream.
HiDream có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
HiDream không nhận đầu vào ảnh, video hay âm thanh. HiDream không hỗ trợ @handle.
Tôi có thể dùng HiDream 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 HiDream 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 HiDream đượ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.