Chuyển đến nội dung

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/generate

Xem 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_idTênMặc định
grok-imagine-imageGrok Image
grok-imagine-image-2.0Grok Image 2.0Có

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ườngGiá trị
aspect_ratio1: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
resolution1k, 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ườngVai trò
imageẢnh tham chiếu.
additional_imagesCá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ừ 37 Gems

    Guava API

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

  • Ả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

  • Hình ảnh · từ 42 Gems

    Mango API

    Dòng mô hình ảnh chủ lực của chúng tôi

  • Ảnh · từ 15 Gems

    MiniMax H3 Image API

    Ảnh gốc 16 megapixel, trọng số mở

  • Hình ảnh · từ 25 Gems

    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?
Một yêu cầu Grok Image với cài đặt mặc định (Grok Image 2.0) tốn 90 Gems, khoảng 0,09 $. Độ 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 khoản phí. Lượt tạo bị lỗi sẽ được hoàn tiền; lượt bị chính sách nội dung của Mage chặn thì không.
Endpoint của API Grok Image là gì?
POST https://api.mage.space/v1/grok_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 poll lấy kết quả.
Tôi có thể gọi những model Grok Image nào?
grok-imagine-image (Grok Image), grok-imagine-image-2.0 (Grok Image 2.0). Mặc định là Grok Image 2.0.
Grok Image có hỗ trợ ảnh tham chiếu hoặc nhân vật không?
Grok Image nhận image, additional_images. Grok Image cho phép dùng nhân vật và tham chiếu đã lưu bằng @handle trong prompt.
Tôi có thể dùng Grok 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 gọi tên Grok Image. 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ả Grok 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.

CharactersCộng đồng