Skip to main content
POST
Sử dụng route này để tạo hình ảnh từ văn bản bằng các model hình ảnh Grok. Phần thân yêu cầu sử dụng application/json. model và prompt là bắt buộc.

​
Chọn một model

Chọn ID model hình ảnh Grok từ trang Models. Các ví dụ API sử dụng grok-imagine-image-2.0. quality chỉ khả dụng với grok-imagine-image-2.0 và chấp nhận low hoặc medium. Hãy thiết lập rõ ràng khi ứng dụng của bạn phụ thuộc vào một mức chất lượng cụ thể. Khi bỏ qua resolution cho Image 2.0, CometAPI sử dụng 1k.

​
Cấu hình đầu ra

  • Sử dụng aspect_ratio để chọn hình dạng đầu ra, hoặc sử dụng auto để model tự chọn hình dạng.
  • Sử dụng resolution để yêu cầu đầu ra 1k hoặc 2k.
  • Sử dụng n để yêu cầu từ 1 đến 10 hình ảnh. Giá trị mặc định là 1.
  • Sử dụng response_format để trả về URL tạm thời hoặc dữ liệu hình ảnh được mã hóa Base64.
Để biết hành vi cụ thể theo model, hãy xem hướng dẫn tạo hình ảnh xAI.
Hãy tải xuống kết quả URL ngay sau khi yêu cầu hoàn tất. URL hình ảnh được tạo là tạm thời. Sử dụng b64_json khi ứng dụng của bạn cần byte hình ảnh trong phản hồi API.

Ủy quyền

​
Authorization
string
header
bắt buộc

Use your CometAPI API key as the bearer value.

Nội dung

application/json
​
model
enum<string>
bắt buộc

The Grok image model ID. See the Models page for available model IDs.

Tùy chọn có sẵn:
grok-imagine-image,
grok-imagine-image-quality,
grok-imagine-image-2.0
Ví dụ:

"grok-imagine-image-2.0"

​
prompt
string
bắt buộc

A text description of the image to generate.

Minimum string length: 1
Ví dụ:

"A glass observatory above a quiet alpine lake at sunrise"

​
n
integer
mặc định:1

The number of images to generate. Use an integer from 1 through 10.

Phạm vi bắt buộc: 1 <= x <= 10
​
aspect_ratio
enum<string>

The output shape. Use auto to let the model select the aspect ratio.

Tùy chọn có sẵn:
1:1,
3:4,
4:3,
9:16,
16:9,
2:3,
3:2,
9:19.5,
19.5:9,
9:20,
20:9,
1:2,
2:1,
auto
Ví dụ:

"16:9"

​
resolution
enum<string>
mặc định:1k

The requested output resolution. Image 2.0 uses 1k when this field is omitted.

Tùy chọn có sẵn:
1k,
2k
Ví dụ:

"1k"

​
quality
enum<string>

Image quality for grok-imagine-image-2.0. This field is not available for the older Grok image model IDs.

Tùy chọn có sẵn:
low,
medium
Ví dụ:

"low"

​
response_format
enum<string>
mặc định:url

The image representation in each response item. Use url for a temporary download URL or b64_json for Base64-encoded image bytes.

Tùy chọn có sẵn:
url,
b64_json

Phản hồi

200 - application/json

The generated image results.

​
data
object[]
bắt buộc

The generated images.

Minimum array length: 1
​
usage
object

Additional usage metadata returned for the request. Its contents can vary by model.

Lần sửa đổi cuối 21 tháng 8, 2026