Skip to main content
POST
Sử dụng route này để chỉnh sửa một hoặc nhiều hình ảnh bằng các mô hình hình ảnh Grok. Phần thân yêu cầu sử dụng application/json.

​
Cung cấp dữ liệu đầu vào hình ảnh

  • Chỉ gửi một trong hai image hoặc images.
  • Sử dụng image cho một hình ảnh nguồn.
  • Sử dụng images cho hai hoặc ba hình ảnh nguồn.
  • Trong mỗi đối tượng hình ảnh, sử dụng url cho URL công khai hoặc URI dữ liệu. image_url là bí danh tương thích cho url.
  • Sử dụng aspect_ratio để kiểm soát hình dạng đầu ra cho các lần chỉnh sửa nhiều hình ảnh.
Chọn ID mô hình hình ảnh Grok trên trang Models. Các ví dụ API sử dụng grok-imagine-image-quality.
Gửi yêu cầu chỉnh sửa hình ảnh Grok dưới dạng JSON. Dữ liệu biểu mẫu multipart không thể hiện cấu trúc yêu cầu này.
Phương thức images.edit() của OpenAI SDK gửi dữ liệu biểu mẫu multipart. Hãy sử dụng yêu cầu HTTP trực tiếp cho các lần chỉnh sửa hình ảnh Grok bằng JSON. Để biết thông tin chi tiết về tham số nhà cung cấp, hãy xem hướng dẫn chỉnh sửa hình ảnh xAI.

Ủ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
Ví dụ:

"grok-imagine-image-quality"

​
prompt
string
bắt buộc

A text instruction that describes the requested edit.

Minimum string length: 1
Ví dụ:

"Replace the daytime sky with a soft sunset and preserve the building"

​
image
object
bắt buộc

One source image. Use this field instead of images.

​
images
object[]

Two or three source images. Use this field instead of image.

Required array length: 2 - 3 elements

A source image represented by url or the compatibility alias image_url.

​
n
integer
mặc định:1

The number of edited 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 for a multi-image edit.

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

"16:9"

​
resolution
enum<string>

The requested output resolution.

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

"1k"

​
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 edited image results.

​
data
object[]
bắt buộc

The edited images.

Minimum array length: 1
​
usage
object
bắt buộc

Usage details for the request.