Tài liệu tham khảo API
Hướng dẫn tích hợp
Giá & Thanh toán
OpenAI
Chỉnh sửa hình ảnh với GPT-Image-1
Sử dụng POST /v1/images/edits với gpt-image-1 trong CometAPI để chỉnh sửa hình ảnh thông qua mask, prompt và các tùy chọn kích thước, phù hợp với hành vi chỉnh sửa ảnh của OpenAI.
POST
/
v1
/
images
/
edits
Edit images
curl --request POST \
--url https://api.cometapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=Add a small red ribbon to the paper boat.' \
--form image='@example-file' \
--form mask='@example-file'{
"created": 1773381100,
"usage": {
"input_tokens": 226,
"input_tokens_details": {
"image_tokens": 194,
"text_tokens": 32
},
"output_tokens": 4160,
"total_tokens": 4386
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}Sử dụng route này để chỉnh sửa hình ảnh hiện có bằng multipart upload tương thích OpenAI trên CometAPI.
Sử dụng route này khi
- Bạn đã có hình ảnh nguồn và muốn chỉnh sửa dựa trên prompt
- Bạn có thể cần mask để thay đổi có mục tiêu
- Bạn có thể xử lý multipart file upload thay vì một request JSON thuần
Quy trình xác thực đầu tiên
- Bắt đầu với một tệp PNG hoặc JPG
- Bỏ qua mask cho đến khi luồng chỉnh sửa cơ bản hoạt động
- Sử dụng một chỉ dẫn ngắn yêu cầu một thay đổi dễ thấy
- Dự kiến độ trễ lâu hơn so với tạo ảnh thông thường
Hành vi của model
gpt-image-1,gpt-image-1-mini, vàgpt-image-1.5phù hợp nhất khi được dùng như các route chỉnh sửa ưu tiên base64dall-e-3có thể trả về đầu ra URL khi đường dẫn provider hỗ trợqwen-image-edittuân theo hành vi chỉnh sửa riêng của provider phía sau cùng một route CometAPI
Xác thực thực tế vào ngày 2026-03-13 đã xác nhận rằng một request
gpt-image-1 dựa trên PNG đã thành công khi được cho phép timeout dài hơn. Phản hồi trả về usage.input_tokens, usage.output_tokens, usage.total_tokens và payload data[0].b64_json.Ủy quyền
Bearer token authentication. Use your CometAPI key.
Nội dung
multipart/form-data
Source image file. Start with one PNG or JPG input for the simplest flow.
Edit instruction describing the change you want.
Ví dụ:
"Add a small red ribbon to the paper boat."
The image editing model to use. Choose a current model from the Models page.
Optional PNG mask. Transparent areas indicate regions that should be edited.
Number of edited images to return.
Quality setting for models that support it.
Tùy chọn có sẵn:
high, medium, low Requested output format when supported by the selected model.
Tùy chọn có sẵn:
url, b64_json Requested output size when supported by the selected model.
⌘I
Edit images
curl --request POST \
--url https://api.cometapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=Add a small red ribbon to the paper boat.' \
--form image='@example-file' \
--form mask='@example-file'{
"created": 1773381100,
"usage": {
"input_tokens": 226,
"input_tokens_details": {
"image_tokens": 194,
"text_tokens": 32
},
"output_tokens": 4160,
"total_tokens": 4386
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}