Mage API · Mô hình hình ảnh
API Grok Image
Grok Imagine, hai phiên bản
POST https://api.mage.space/v1/grok_image/generateXem nhanh
Grok Image API chạy Grok Image 2.0 và 1 biến thể khác qua Mage tại POST https://api.mage.space/v1/grok_image/generate. Một yêu cầu với cài đặt mặc định tốn 90 Gems (khoảng 0,09 $), không cần đăng ký gói. Grok Image hỗ trợ nhân vật đã lưu và ảnh tham chiếu bằng @handle trong prompt.
- Hình ảnhĐầu ra
- 2Biến thể
- 90Gems mỗi hình ảnh, mặc định
- $0.09Khoảng, tính bằng USD
Tổng quan
API Grok Image làm được gì
Mô hình ảnh Grok Imagine của xAI với hai phiên bản. Tạo ảnh hoặc chỉnh sửa từ tối đa 3 ảnh tham chiếu mà vẫn giữ nguyên các chi tiết của ảnh gốc. Áp dụng bộ lọc an toàn của xAI.
Các mô hình ảnh Grok Imagine của xAI với hai phiên bản, dùng để tạo ảnh và chỉnh sửa từ ảnh tham chiếu: Grok Image 2.0 (`grok-imagine-image-2.0`), là mặc định, và Grok Image (`grok-imagine-image`) cho bản nháp giá rẻ. xAI đã ngừng cung cấp Grok Image Quality (`grok-imagine-image-quality`) vào ngày 2 tháng 11 năm 2026, nên yêu cầu nào nêu tên mô hình này sẽ bị từ chối. Áp dụng bộ lọc an toàn của xAI.
Model nhận image, additional_images làm đầu vào.
Bắt đầu nhanh
Gọi API Grok Image
Đặt MAGE_API_KEY, gửi yêu cầu đến /grok_image/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/grok_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": "1:1",
"model_id": "grok-imagine-image-2.0"
}' | 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('grok_image', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '1:1',
model_id: 'grok-imagine-image-2.0',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("grok_image", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "1:1",
"model_id": "grok-imagine-image-2.0",
})
print(request["result"]["url"])Mô hình
Các giá trị model_id của Grok 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_id | Tên | Mặc định |
|---|---|---|
| grok-imagine-image | Grok Image | |
| grok-imagine-image-2.0 | Grok Image 2.0 | Có |
Tùy chọn
Tham số của Grok 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ường | Giá trị |
|---|---|
| aspect_ratio | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20 |
| resolution | 1k, 2k |
Đầu vào
Đầu vào media mà Grok Image chấp nhận
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
Guava API
Chân thực đến mức như ảnh chụp thật
HiDream API
Nhanh và linh hoạt, hỗ trợ negative prompt
Krea 2 API
Thẩm mỹ tuyệt đẹp chỉ trong vài giây
Mango API
Dòng mô hình ảnh chủ lực của chúng tôi
MiniMax H3 Image API
Ảnh gốc 16 megapixel, trọng số mở
MOSS-Image API
Prompt dài và văn bản song ngữ, trọng số mở
FAQ
Câu hỏi thường gặp
API Grok Image có giá bao nhiêu?
Endpoint của API Grok Image là gì?
Tôi có thể gọi những model Grok Image nào?
Grok Image có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Tôi có thể dùng Grok Image từ Claude hoặc ChatGPT không?
Kết quả Grok Image được lưu trong bao lâu?
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.