Tạo hình ảnh

API này dùng lại đường dẫn OpenAI Images Generations và hỗ trợ các tham số riêng của Grok như aspect_ratio và resolution.

POST/v1/images/generations

Tạo một hoặc nhiều hình ảnh từ prompt văn bản. API dùng lại endpoint POST /v1/images/generations theo phong cách OpenAI, đồng thời bổ sung tham số tỷ lệ khung hình và độ phân giải cho mô hình hình ảnh Grok.

Ví dụ ID mô hình gồm grok-imagine-image-pro và grok-imagine-image. Trước khi gọi, hãy xác nhận ID mô hình thực tế khả dụng qua danh sách mô hình của API Key hiện tại.

Mỗi yêu cầu tạo tối đa 10 hình ảnh; kết quả URL là liên kết tạm thời, cần tải xuống hoặc xử lý kịp thời; nội dung đã tạo có thể bị lọc theo chính sách nội dung; hình ảnh đầu ra thường có định dạng JPG.

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 tạo hình ảnh Grok.

Định nghĩa kiểu TypeScript

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

model*string

ID mô hình dùng để tạo hình ảnh. Ví dụ mô hình gồm:

grok-imagine-image-pro: mô hình hình ảnh nâng cao, phù hợp với các cảnh chất lượng cao, nhiều chi tiết.
grok-imagine-image: mô hình tạo hình ảnh đa dụng.

Các mô hình thực tế khả dụng phụ thuộc vào danh sách mô hình được API Key hiện tại trả về.

Độ dài1 <= length

prompt*string

Mô tả bằng văn bản về hình ảnh muốn tạo.

Độ dài1 <= length

n?integer

Số hình ảnh cần tạo, từ 1 đến 10.

Phạm vi1 <= value <= 10

Giá trị mặc định1

response_format?string

Định dạng trả về hình ảnh đã tạo. url trả về URL hình ảnh tạm thời, cần tải xuống hoặc xử lý sớm; b64_json trả về dữ liệu hình ảnh mã hóa Base64.

Giá trị mặc định"url"

Giá trị được phép

"url"
"b64_json"

aspect_ratio?string

Tỷ lệ khung hình của hình ảnh đã tạo. Nếu bỏ qua, mô hình tự chọn. Ví dụ các giá trị thường dùng:

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
auto

Các giá trị trên là ví dụ thường dùng, không phải giới hạn enum đóng.

resolution?string

Độ phân giải đầu ra của hình ảnh đã tạo, hỗ trợ 1k và 2k.

Giá trị được phép

"1k"
"2k"

user?string

Định danh duy nhất đại diện cho người dùng cuối, dùng để giám sát và kiểm soát rủi ro.

Độ dài1 <= length

Nội dung phản hồi

`application/json`

curl -X POST "https://example.com/v1/images/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "A cat in a tree",    "n": 1,    "response_format": "url"  }'

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/generated-image-1.jpg"
    },
    {
      "url": "https://example.com/generated-image-2.jpg"
    }
  ]
}

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`