Edycja obrazów z GPT-Image-1

Użyj POST /v1/images/edits z gpt-image-1 w CometAPI, aby edytować obrazy za pomocą masek, Promptów i opcji rozmiaru, zgodnie z zachowaniem edycji obrazów OpenAI.

POST /v1/images/edits

Edit images

cURL

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'

200

{
  "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>"
    }
  ]
}

Użyj tej ścieżki, aby edytować istniejące obrazy za pomocą zgodnych z OpenAI wieloczęściowych uploadów w CometAPI.

​

Użyj tej ścieżki, gdy

• Masz już obraz źródłowy i chcesz wykonać edycję sterowaną Promptem
• Możesz potrzebować maski do ukierunkowanych zmian
• Potrafisz obsłużyć wieloczęściowy upload plików zamiast zwykłego żądania JSON

​

Pierwsza ścieżka walidacji

• Zacznij od jednego pliku PNG lub JPG
• Pomiń maskę, dopóki podstawowy przepływ edycji nie zacznie działać
• Użyj jednej krótkiej instrukcji, która prosi o jedną widoczną zmianę
• Spodziewaj się dłuższego opóźnienia niż w przypadku zwykłego generowania obrazów

​

Zachowanie modelu

• gpt-image-1, gpt-image-1-mini i gpt-image-1.5 najlepiej traktować jako ścieżki edycji typu base64-first
• dall-e-3 może zwracać wynik w postaci URL, gdy ścieżka providera to obsługuje
• qwen-image-edit działa zgodnie z zachowaniem edycji specyficznym dla providera za tą samą ścieżką CometAPI

Walidacja na żywo z 2026-03-13 potwierdziła, że żądanie gpt-image-1 oparte na PNG zakończyło się powodzeniem, gdy dopuszczono dłuższy timeout. Odpowiedź zawierała usage.input_tokens, usage.output_tokens, usage.total_tokens oraz payload data[0].b64_json.

Autoryzacje

Authorization · string · header · wymagane

Bearer token authentication. Use your CometAPI key.

Treść

multipart/form-data

image · file · wymagane

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

prompt · string · wymagane

Edit instruction describing the change you want.

Przykład:

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

model · string · domyślnie: gpt-image-1

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

mask · file

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

n · string · domyślnie: 1

Number of edited images to return.

quality · enum<string>

Quality setting for models that support it.

Dostępne opcje: high, medium, low

response_format · enum<string>

Requested output format when supported by the selected model.

Dostępne opcje: url, b64_json

size · string

Requested output size when supported by the selected model.

Odpowiedź

200 - application/json

Edited image result.

created · integer · wymagane

data · object[] · wymagane

Show child attributes

usage · object

Show child attributes