POST

/v1/images

Tạo ảnh từ một đoạn mô tả bằng chữ, hoặc sửa một ảnh bạn đã có. Ảnh luôn được trả về dạng base64 trong data[].b64_json.

POST: https://api.ltnproxy.com/v1/images/generations
POST: https://api.ltnproxy.com/v1/images/edits
Xác thực: Authorization: Bearer sk-your_api_key

“Những tấm ảnh phơi trên dây trong phòng tối, soi bằng ánh đèn an toàn màu hổ phách trên khay tráng.”Phòng tráng ảnh · grok-imagine-video-1.5

Tạo ảnh

POST /v1/images/generations nhận model và prompt. Thêm n để nhận nhiều ảnh trong một request. Lấy id của một mô hình mà API key của bạn gọi được từ GET /v1/models.

curl "https://api.ltnproxy.com/v1/images/generations" \
  -H "Authorization: Bearer sk-your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "Một tách cà phê trên bàn gỗ, ánh nắng buổi sáng"
  }'

cURL7 dòng · Framewharf

Chọn khung hình bằng aspect_ratio (1:1, 16:9, 9:16…) và kích thước bằng resolution (1k, 2k). Cả hai cũng dùng được khi sửa ảnh.

Phản hồi chứa một phần tử trong data cho mỗi ảnh:

Phản hồi

{
  "created": 1756180000,
  "data": [
    { "b64_json": "/9j/4AAQSkZJRg..." }
  ]
}

Phản hồi6 dòng · Framewharf

Mỗi ảnh dưới đây được tạo từ endpoint này, mỗi ảnh một request, kèm prompt đã tạo ra nó.

Bìa tạp chí: người phụ nữ mặc áo dài lụa xanh cobalt giữa đồng lau lúc hoàng hôn.grok-imagine-image-2.0

Tô phở bò tái với rau thơm, chanh và ớt nhìn từ trên xuống trên bàn tối.grok-imagine-image-2.0

Đồng hồ đeo tay mặt lộ cơ xanh trên đá marble đen ướt.grok-imagine-image-2.0

Robot đất sét tròn dễ thương mắt xanh to, cầm cọ vẽ.grok-imagine-image-2.0

Căn bếp hiện đại tủ đen, đảo bếp gỗ sồi và cửa sổ nhìn ra vườn.grok-imagine-image-2.0

Chú cáo đỏ màu nước ngủ trên tuyết.grok-imagine-image-2.0

Sửa ảnh

POST /v1/images/edits nhận multipart/form-data: tệp image (JPEG, PNG hoặc WebP), prompt mô tả thay đổi, và model. Ảnh đã sửa cũng được trả về dạng base64. Trường mask không được hỗ trợ.

curl "https://api.ltnproxy.com/v1/images/edits" \
  -H "Authorization: Bearer sk-your_api_key" \
  -F "model=grok-imagine-image-2.0" \
  -F "prompt=Đổi nền thành bãi biển lúc hoàng hôn" \
  -F "image=@input.jpg"

cURL5 dòng · Framewharf

Kéo thanh trượt: bên trái là ảnh gốc, bên phải là kết quả của một request sửa ảnh.

Phòng khách tối giản với sofa vải lanh và cửa kính lớn nhìn ra rừng.

TrướcSau

Gửi tối đa năm trường image để ghép nhiều ảnh trong một lần sửa, rồi gọi chúng trong prompt là <IMAGE_0>, <IMAGE_1> theo đúng thứ tự bạn gửi:

cURL

curl "https://api.ltnproxy.com/v1/images/edits" \
  -H "Authorization: Bearer sk-your_api_key" \
  -F "model=grok-imagine-image-2.0" \
  -F "prompt=Mặc chiếc áo khoác trong <IMAGE_1> cho người trong <IMAGE_0>" \
  -F "image=@person.jpg" \
  -F "image=@jacket.jpg" \
  -F "aspect_ratio=1:1"

cURL7 dòng · Framewharf

Mô hình và giá

Mỗi mô hình tính phí theo một trong hai cách: mô hình tính theo ảnh lấy đơn giá nhân n lần cho một request n ảnh, còn mô hình tính theo token ảnh thì tính theo số token ảnh trong kết quả. Mô hình ảnh được mở theo từng API key — GET /v1/models với key của bạn liệt kê đúng những mô hình bạn gọi được; nhắn Framewharf nếu bạn cần thêm quyền truy cập.

Độ phân giải và chất lượng có thể có đơn giá riêng, và bạn trả theo chất lượng thực sự được phục vụ. Một lần sửa ảnh còn tính phí cho mỗi ảnh bạn gửi lên, ngoài ảnh được trả về; bảng giá đầy đủ của từng mô hình nằm trong mục của nó ở danh mục mô hình.

grok-imagine-image-2.0: 60 VND / ảnh
grok-imagine-image: 20 VND / ảnh
gpt-image-2.5-sunburst: 30,000 VND / 1M token ảnh
gpt-image-2.5-flare: 30,000 VND / 1M token ảnh
gpt-image-2: 30,000 VND / 1M token ảnh
gpt-image-1.5: 32,000 VND / 1M token ảnh
gemini-3.1-flash-lite-image: 30,000 VND / 1M token ảnh
gemini-3.1-flash-image-preview: 60,000 VND / 1M token ảnh
gemini-3.1-flash-image: 60,000 VND / 1M token ảnh
gemini-3-pro-image-preview: 120,000 VND / 1M token ảnh
gemini-3-pro-image: 120,000 VND / 1M token ảnh
gemini-2.5-flash-image: 30,000 VND / 1M token ảnh

curl "https://api.ltnproxy.com/v1/images/generations" \ -H "Authorization: Bearer sk-your_api_key" \ -H "Content-Type: application/json" \ -d '{ "model": "grok-imagine-image-2.0", "prompt": "Một tách cà phê trên bàn gỗ, ánh nắng buổi sáng" }'

curl "https://api.ltnproxy.com/v1/images/edits" \ -H "Authorization: Bearer sk-your_api_key" \ -F "model=grok-imagine-image-2.0" \ -F "prompt=Đổi nền thành bãi biển lúc hoàng hôn" \ -F "image=@input.jpg"

curl "https://api.ltnproxy.com/v1/images/edits" \ -H "Authorization: Bearer sk-your_api_key" \ -F "model=grok-imagine-image-2.0" \ -F "prompt=Mặc chiếc áo khoác trong <IMAGE_1> cho người trong <IMAGE_0>" \ -F "image=@person.jpg" \ -F "image=@jacket.jpg" \ -F "aspect_ratio=1:1"