Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
Tổng Quan

Tạo một hình ảnh đã chỉnh sửa hoặc mở rộng dựa trên ảnh gốc và prompt. Route này hỗ trợ cả:
  • luồng upload kiểu DALL-E truyền thống bằng multipart/form-data được mô tả bên dưới
  • request JSON cung cấp image_url, image_urls, hoặc tham chiếu chính thức images cho các nhóm image-to-image được hỗ trợ
gpt-image-2 được hỗ trợ tại đây. Endpoint chấp nhận upload multipart image, JSON image_url / image_urls, và tham chiếu chính thức images[] (image_url hoặc file_id) với tối đa 16 ảnh nguồn. Hãy tạo file_id qua /v1/files trước. Đặt async: true để nhận task trước; các model edit FLUX/BFL chính thức cũng dùng cùng luồng polling task.Ghi chu tuong thich: neu yeu cau gpt-image-2 gui input_fidelity, LemonData se xoa truong nay truoc khi chuyen tiep vi GPT Image 2 tu dong xu ly dau vao hinh anh voi do trung thuc cao.

​
Thân Yêu Cầu

Timeout cho yêu cầu đồng bộ: một số nhà cung cấp hình ảnh được định tuyến sẽ trả ảnh cuối cùng inline và chờ quá trình tạo hoàn tất. Yêu cầu độ phân giải cao hoặc chất lượng cao có thể mất gần một phút hoặc lâu hơn, vì vậy hãy đặt timeout của HTTP client ít nhất là 120s. Nếu phản hồi tạo có status: "pending", task_id, hoặc poll_url, hãy theo poll_url được trả về để polling. URL ảnh từ xa: khi provider được định tuyến yêu cầu input multipart, LemonData sẽ tải JSON image_url, image_urls, hoặc images[].image_url rồi chuyển byte dưới dạng các phần multipart image. URL phải là http/https công khai, không chứa credentials nhúng hoặc fragment, và không được resolve tới localhost, dải IP private hoặc reserved; mỗi redirect đều được kiểm tra lại. Payload tải về phải là ảnh PNG, JPEG hoặc WebP thật. Giới hạn: 50MB mỗi ảnh, tổng 200MB cho ảnh tải từ URL trong một request, timeout tải 10s, và tối đa 3 redirect.
​
image
file
Ảnh nguồn multipart. Lặp lại trường image để gửi nhiều nguồn GPT Image. File phải là PNG, JPEG hoặc WebP, tối đa 16 ảnh nguồn và 50MB mỗi ảnh. Các edit mask DALL-E 2 legacy vẫn yêu cầu PNG có vùng trong suốt, hoặc một mask riêng.
​
prompt
string
bắt buộc
Mô tả bằng văn bản cho chỉnh sửa mong muốn.
​
mask
file
Một ảnh bổ sung có các vùng trong suốt hoàn toàn để chỉ ra nơi ảnh sẽ được chỉnh sửa. Phải là tệp PNG hợp lệ, nhỏ hơn 50MB, và có cùng kích thước với image.
​
model
string
mặc định:"dall-e-2"
Model dùng cho edit ảnh. gpt-image-2 được hỗ trợ; các edit kiểu DALL-E legacy vẫn có thể dùng dall-e-2.
​
n
integer
mặc định:"1"
Số lượng ảnh cần tạo. Phải nằm trong khoảng từ 1 đến 10.
​
size
string
Kích thước ảnh được tạo. Với gpt-image-2, dùng auto hoặc WIDTHxHEIGHT; kích thước phải là bội số của 16, cạnh dài nhất tối đa 3840px, tỷ lệ cạnh dài/ngắn tối đa 3:1, và tổng pixel nằm trong khoảng 655,360 đến 8,294,400. Edit DALL-E legacy hỗ trợ 256x256, 512x512, hoặc 1024x1024.
​
response_format
string
mặc định:"url"
Định dạng trả về của ảnh được tạo. Phải là url hoặc b64_json; mặc định là url.Với các tuyến gpt-image-2 Azure Official hoặc tương thích Azure, LemonData không chuyển response_format lên upstream. Gateway luôn nhận dữ liệu ảnh upstream dưới dạng b64_json; với request url, gateway tải từng ảnh lên CDN rồi trả về data[].url. Nếu CDN storage không khả dụng hoặc upload thất bại, request sẽ fail thay vì fallback về Base64. Với b64_json, Base64 gốc được trả về.
​
async
boolean
mặc định:"false"
Đặt true với gpt-image-2 hoặc các model edit FLUX/BFL chính thức để trả về task trước khi ảnh cuối sẵn sàng. Edit async hoàn tất trả về URL bất kể response_format được yêu cầu; dùng request đồng bộ nếu cần b64_json.
​
user
string
Một định danh duy nhất đại diện cho end-user của bạn để theo dõi lạm dụng.

​
Phản Hồi

​
created
integer
Unix timestamp lúc ảnh được tạo.
​
data
array
Mảng các ảnh được tạo.Mỗi object chứa:
  • url (string): URL của ảnh đã chỉnh sửa (nếu response_format là url)
  • b64_json (string): Ảnh mã hoá Base64 (nếu response_format là b64_json)

​
Phản hồi task async

Đặt async: true với gpt-image-2 hoặc các model edit FLUX/BFL chính thức để tạo task thay vì chờ ảnh đã chỉnh sửa trong request. Phản hồi gồm status: "pending", task_id và poll_url. Hãy poll /v1/tasks/{task_id} cho đến khi task chuyển sang completed hoặc failed. Task edit async chỉ trả về URL của ảnh cuối. Nếu cần dữ liệu ảnh thô b64_json, hãy dùng request đồng bộ. Khi tạo tác vụ, hệ thống có thể tạm giữ chi phí ước tính. Tác vụ hoàn tất được tính theo mức sử dụng thực tế; tác vụ thất bại hoặc hết hạn sẽ được giải phóng khoản tạm giữ hoặc hoàn phí. 
curl -X POST "https://api.lemondata.cc/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "image=@sunlit_lounge.png" \
  -F "[email protected]" \
  -F "prompt=A sunlit indoor lounge area with a pool" \
  -F "n=1" \
  -F "size=1024x1024"

{
  "created": 1706000000,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

​
Ghi Chú

Lỗi tải ảnh từ xa được trả về như lỗi input trước khi gửi request tới upstream. URL không truy cập được, timeout, phản hồi 403/404, host private/internal, credentials hoặc fragment trong URL, nội dung không phải ảnh, định dạng không hỗ trợ, và vượt giới hạn kích thước sẽ trả 400 hoặc 413 và chỉ ra input image_url / image_urls[n]. Với tài sản private hoặc được bảo vệ bằng header, hãy upload trực tiếp file multipart image hoặc tạo tham chiếu /v1/files.