Chuyển đến nội dung chính
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": 1776836647,
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 981,
    "prompt_tokens_details": {
      "cached_tokens_details": {}
    },
    "completion_tokens_details": {},
    "input_tokens": 785,
    "output_tokens": 196,
    "input_tokens_details": {
      "image_tokens": 768,
      "text_tokens": 17,
      "cached_tokens_details": {}
    },
    "claude_cache_creation_5_m_tokens": 0,
    "claude_cache_creation_1_h_tokens": 0
  },
  "data": [
    {
      "b64_json": "<base64-image-data>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

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

Sử dụng route này để chỉnh sửa các hình ảnh hiện có bằng multipart uploads tương thích OpenAI trên CometAPI.

​
Sử dụng route này khi

  • Bạn đã có một hình ảnh nguồn và muốn chỉnh sửa dựa trên Prompt
  • Bạn có thể cần một mask để thực hiện các thay đổi có mục tiêu
  • Bạn có thể xử lý tải tệp multipart thay vì một yêu cầu JSON thuần

​
Yêu cầu đầu tiên an toà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 model: "gpt-image-2" cho các yêu cầu chỉnh sửa ảnh GPT trên route này
  • Sử dụng một hướng dẫn ngắn yêu cầu một thay đổi hiển thị duy nhất
  • Đọc kết quả đã chỉnh sửa từ data[0].b64_json
  • Đặt output_format: "jpeg" khi bạn muốn payload JPEG
  • Dự kiến độ trễ dài hơn so với tạo hình ảnh thông thường

​
Hành vi của model

  • Các model chỉnh sửa ảnh GPT trên route này trả về dữ liệu hình ảnh base64 nội tuyến
  • output_format điều khiển loại hình ảnh được mã hóa bên trong b64_json
  • response_format chỉ quan trọng khi một model hỗ trợ đầu ra URL
  • qwen-image-edit tuân theo hành vi chỉnh sửa dành riêng cho provider phía sau cùng một route CometAPI

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

multipart/form-data
​
image
file
bắt buộc

Source image file. Start with one PNG or JPG input for the simplest flow.

​
prompt
string
bắt buộc

Edit instruction describing the change you want.

Ví dụ:

"Add a small red ribbon to the paper boat."

​
model
string
mặc định:gpt-image-2

The image editing model to use. Choose a supported model from the Models page.

​
mask
file

Optional PNG mask. Transparent areas indicate regions that should be edited.

​
n
string
mặc định:1

Number of edited images to return.

​
quality
enum<string>

Quality setting for models that support it.

Tùy chọn có sẵn:
high,
medium,
low
​
response_format
enum<string>

Requested response container when supported by the selected model. GPT image edit models return data[].b64_json; use output_format to choose the encoded image type.

Tùy chọn có sẵn:
url,
b64_json
​
output_format
string

Encoded image type for GPT image edit results returned in data[].b64_json. For example, use jpeg for a JPEG payload.

Ví dụ:

"jpeg"

​
size
string

Requested output size when supported by the selected model.

Phản hồi

200 - application/json

Edited image result.

​
created
integer
bắt buộc
​
usage
object
bắt buộc
​
data
object[]
bắt buộc