88API88API
User GuideAI ApplicationsAPI ReferenceHelp & Support
Image

API mô hình hình ảnh Grok

Giao diện tạo ảnh từ văn bản và chỉnh sửa ảnh, tỷ lệ khung hình, độ phân giải, ảnh tham chiếu và mã lỗi của các mô hình hình ảnh Grok Imagine (grok-imagine-image, 2.0, quality, edit).

Phạm vi áp dụng

Trang này giới thiệu các mô hình hình ảnh Grok Imagine. Với mô hình video, xem Grok Video API.

Chọn giao diện

Các mô hình hình ảnh Grok dùng giao diện tương thích OpenAI Images:

Mục đíchPhương thứcĐiểm cuối
Tạo ảnh từ văn bảnPOST/v1/images/generations
Chỉnh sửa hình ảnh (tạo ảnh từ ảnh)POST/v1/images/edits

Không hỗ trợ /v1/chat/completions và /v1/responses. Ảnh tham chiếu chỉ có thể truyền qua /v1/images/edits, nếu đặt trong /v1/images/generations sẽ bị bỏ qua.

Mô hình và khả năng

Mô hìnhĐộ phân giảiẢnh tham chiếuSố ảnh mỗi yêu cầuTính phí
grok-imagine-image1K (mặc định) / 2K
aspect_ratio + resolution
tối đa 3 (data URI / URL công khai / tệp cục bộ)tối đa 10theo ảnh
grok-imagine-image-2.01K (mặc định) / 2K
aspect_ratio + resolution
tối đa 3 (data URI / URL công khai / tệp cục bộ)tối đa 10theo ảnh
grok-imagine-image-quality1K (mặc định) / 2K
aspect_ratio + resolution
tối đa 3 (data URI / URL công khai / tệp cục bộ)tối đa 10theo ảnh
grok-imagine-edit
Giống grok-imagine-image-quality
1K (mặc định) / 2K
aspect_ratio + resolution
tối đa 3 (data URI / URL công khai / tệp cục bộ)tối đa 10theo ảnh

Tỷ lệ khung hình hỗ trợ: auto (mặc định) / 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 / 21:9 / 5:2

Mô hìnhqualityresponse_format
grok-imagine-imageKhông hỗ trợb64_json / url
grok-imagine-image-2.0low / medium / autob64_json / url
grok-imagine-image-qualityKhông hỗ trợb64_json / url
grok-imagine-editKhông hỗ trợb64_json / url
  • Cả bốn mô hình đều có thể tạo ảnh từ văn bản và chỉnh sửa ảnh.
  • grok-imagine-edit và grok-imagine-image-quality là cùng một mô hình, kết quả đầu ra như nhau.
  • Tham số quality chỉ có tác dụng với grok-imagine-image-2.0.
  • Tính phí theo số ảnh trả về thành công, không phụ thuộc độ phân giải hay số lượng ảnh tham chiếu.

Mô hình thực tế có thể dùng được căn cứ theo danh sách mô hình hiển thị trong bảng điều khiển.

Xác thực

Authorization: Bearer $API_KEY
Content-Type: application/json

Tỷ lệ khung hình và độ phân giải

  • aspect_ratio: xem bảng khả năng ở trên. Mặc định là auto, mô hình chọn khung hình dựa theo prompt, cùng một prompt mỗi lần có thể cho tỷ lệ khác nhau; khi cần kích thước cố định, hãy truyền rõ giá trị.
  • resolution: 1k (mặc định) hoặc 2k, không hỗ trợ 4K.

Kích thước pixel đầu ra của từng mức (giống nhau cho cả bốn mô hình):

Tỷ lệ1K2K
1:11024x10242048x2048
16:91280x7202816x1584
9:16720x12801584x2816
4:31152x8642368x1776
3:4864x11521776x2368
3:21248x8322496x1664
2:3832x12481664x2496
2:11408x7042912x1456
1:2704x14081456x2912
19.5:91248x5762912x1344
9:19.5576x12481344x2912
20:91280x5763200x1440
9:20576x12801440x3200
21:91568x6723136x1344
5:21600x6403200x1280
  • Đầu ra 1K là JPEG, đầu ra 2K là PNG, không thể thay đổi qua output_format.
  • Cũng có thể dùng size theo thói quen của OpenAI (ví dụ 1024x1024), hệ thống sẽ tự quy đổi: cạnh dài không vượt quá 1024 thì theo 1k, vượt quá thì theo 2k, tỷ lệ lấy giá trị được hỗ trợ gần nhất, vì vậy kích thước pixel trả về không nhất thiết bằng size đã yêu cầu. 1536x1024, 1792x1024 đều xuất ra theo 2k.
  • Khi truyền đồng thời size và aspect_ratio / resolution, sẽ ưu tiên aspect_ratio / resolution.

Tạo ảnh từ văn bản

curl https://api.88api.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "Đường phố Tokyo trong đêm mưa dưới ánh đèn neon, chất điện ảnh, nhiếp ảnh chân thực",
    "aspect_ratio": "16:9",
    "resolution": "2k",
    "n": 1
  }'

Tham số yêu cầu

Tham sốKiểuBắt buộcMô tả
modelstringCóTên mô hình.
promptstringCóMô tả hình ảnh, không được để trống. Nên giữ trong vòng vài nghìn ký tự.
aspect_ratiostringKhôngTỷ lệ khung hình, mặc định auto.
resolutionstringKhông1k (mặc định) hoặc 2k.
nintegerKhôngSố lượng ảnh, từ 1 đến 10, mặc định 1.
response_formatstringKhôngb64_json (mặc định) hoặc url. Khi chọn url sẽ trả về liên kết ảnh của 88API.
qualitystringKhôngChỉ grok-imagine-image-2.0: low, medium, auto (mặc định; khi tạo ảnh tương đương low, khi chỉnh sửa tương đương medium). medium tạo ảnh chậm hơn.

Các tham số như style, seed, negative_prompt, background, output_format, stream sẽ bị bỏ qua.

Ví dụ phản hồi

{
  "created": 1760000000,
  "data": [
    { "b64_json": "/9j/4AAQ...", "mime_type": "image/jpeg" }
  ]
}

Phản hồi không chứa revised_prompt.

Chỉnh sửa hình ảnh

Yêu cầu JSON (khuyến nghị, hỗ trợ nhiều ảnh tham chiếu)

Một ảnh tham chiếu dùng image, nhiều ảnh tham chiếu dùng mảng images, tối đa 3 ảnh:

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "Đưa người trong ảnh thứ nhất vào khung cảnh của ảnh thứ hai, giữ nguyên ngoại hình của người đó",
    "images": [
      "data:image/png;base64,...",
      "https://example.com/scene.jpg"
    ],
    "resolution": "2k"
  }'
  • Ảnh tham chiếu có thể là Data URI hoặc URL công khai tải trực tiếp được. Base64 phải có tiền tố data:image/...;base64,.
  • Hỗ trợ JPG, PNG, WebP, không hỗ trợ GIF, BMP.
  • Đừng viết image thành mảng, cũng đừng truyền đồng thời image và images.
  • Ảnh tham chiếu được đánh số theo thứ tự truyền vào, trong prompt có thể gọi là «ảnh thứ nhất», «ảnh thứ hai».
  • Khi không truyền tỷ lệ, tỷ lệ đầu ra theo ảnh tham chiếu đầu tiên, độ phân giải mặc định là 1k; có thể ghi đè bằng aspect_ratio, resolution.

Tải lên multipart (một ảnh)

Tệp cục bộ cũng có thể tải lên bằng multipart, nhưng mỗi lần chỉ được một ảnh, mỗi tệp không vượt quá 20 MB:

curl https://api.88api.ai/v1/images/edits \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=grok-imagine-image" \
  -F "image=@input.png" \
  -F "prompt=Thay nền thành cảnh hoàng hôn bên bờ biển" \
  -F "aspect_ratio=1:1"

Khi cần nhiều ảnh tham chiếu, hãy dùng yêu cầu JSON.

Giới hạn

  • Không hỗ trợ vẽ lại cục bộ bằng mask, mặt nạ được truyền vào sẽ bị bỏ qua.
  • Không hỗ trợ đầu ra dạng luồng và lấy kết quả bất đồng bộ.
  • Ảnh đầu ra có kèm thông tin xác thực nội dung C2PA (đánh dấu là do AI tạo), không có hình mờ hiển thị.

Lỗi thường gặp

Tình huốngHTTPThông tin trả về
Gọi giao diện hội thoại hoặc Responses400<模型> 是生图模型,不支持 <接口> 接口。请改用:POST /v1/images/generations, POST /v1/images/edits (mô hình là mô hình tạo ảnh, không hỗ trợ giao diện này)
Tỷ lệ không được hỗ trợ400不支持的图片比例。支持:… (tỷ lệ ảnh không được hỗ trợ, kèm danh sách tỷ lệ hỗ trợ)
Độ phân giải không được hỗ trợ (ví dụ 4k)400不支持的图片分辨率。resolution 仅支持 1k 或 2k,请使用小写格式。 (resolution chỉ hỗ trợ 1k hoặc 2k, viết thường)
n ngoài khoảng 1 đến 10, prompt trống, truyền đồng thời image và images, multipart truyền nhiều ảnh400上游拒绝了请求参数(invalid-argument),请检查模型名、调用接口和请求参数 (thượng nguồn từ chối tham số yêu cầu, hãy kiểm tra tên mô hình, giao diện gọi và tham số)
Định dạng ảnh tham chiếu không được hỗ trợ, Base64 thiếu tiền tố, URL không tải được400Thông báo lỗi liên quan đến ảnh tham chiếu
Hơn 3 ảnh tham chiếu502Upstream request failed
Không vượt qua kiểm duyệt nội dung400图片生成未通过内容安全审核,请修改提示词或参考素材后重试。 (tạo ảnh không vượt qua kiểm duyệt an toàn nội dung, hãy sửa prompt hoặc tư liệu tham chiếu rồi thử lại)

Các yêu cầu thất bại nêu trên không bị tính phí.