Chỉnh sửa hình ảnh bằng JSON

Chỉnh sửa một hoặc nhiều hình ảnh Grok bằng URL hình ảnh trong JSON.

Yêu cầu sử dụng application/json và gửi tác vụ chỉnh sửa một hoặc nhiều hình ảnh bằng URL hình ảnh có thể truy cập công khai.

POST/v1/images/edits

Chỉnh sửa một hoặc nhiều hình ảnh tham chiếu theo chỉ dẫn bằng văn bản. Yêu cầu phải dùng application/json và truyền URL hình ảnh có thể truy cập công khai qua image hoặc images.

Cấu trúc yêu cầu JSON URL này chỉ áp dụng cho mô hình hỗ trợ chỉnh sửa hình ảnh Grok.

Sử dụng /v1/images/edits, không dùng /v1/edits. Với nhiều hình ảnh tham chiếu, dùng images; không khuyến nghị dùng reference_images.

Xác thực

bearerAuth

Xác thựcBearer <token>

Sử dụng Bearer your-api-key trong Header Authorization.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Tham số yêu cầu chỉnh sửa hình ảnh Grok. Cần cung cấp ít nhất một trong image và images.

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

model*string

ID mô hình dùng để chỉnh sửa hình ảnh. Các mô hình hỗ trợ định dạng yêu cầu này gồm grok-imagine-image và grok-imagine-image-pro; phạm vi thực tế khả dụng phụ thuộc vào danh sách mô hình do API Key hiện tại trả về và khả năng của kênh.

Độ dài1 <= length

prompt*string

Chỉ dẫn chỉnh sửa hình ảnh. Nên nêu rõ chủ thể cần giữ lại, vùng cần thay đổi và phong cách đích.

Độ dài1 <= length

image?|

Bắt buộc có điều kiện. Một hình ảnh đầu vào; nên truyền URL hình ảnh công khai mà cả máy chủ và dịch vụ mô hình phía nhà cung cấp đều truy cập được. Cần điền ít nhất một trong image và images, không được bỏ qua cả hai.

images?array<>

Bắt buộc có điều kiện. Danh sách URL công khai của nhiều hình ảnh đầu vào; cần điền ít nhất một trong image và images, không được bỏ qua cả hai.

Số phần tử1 <= items

size?string

Kích thước hoặc tỷ lệ khung hình, chẳng hạn 1024x1024, 1:1 hoặc 16:9.

n?integer

Số kết quả chỉnh sửa cần tạo. Nếu bỏ qua, thường được xử lý là 1 hình ảnh.

Phạm vi1 <= value

Giá trị mặc định1

response_format?string

Định dạng trả về, được quyết định bởi khả năng thực tế của máy chủ và mô hình phía nhà cung cấp.

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/images/edits" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Chuyển hình ảnh sang phong cách cảnh đêm cyberpunk, giữ nguyên nhân vật chính",    "image": "https://example.com/input.png",    "size": "1024x1024",    "n": 1  }'

{
  "created": 1710000000,
  "data": [
    {
      "url": "https://example.com/result.png"
    }
  ]
}

Chỉnh sửa hình ảnh bằng JSON

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`