Create image edit

curl https://api.cometapi.com/v1/images/edits \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F image=@cat.jpg \ -F prompt="Add a small red bow tie on the cat" \ -F model=gpt-image-2 \ -F quality=low

{ "created": 1781075000, "background": "opaque", "output_format": "png", "quality": "low", "size": "1024x1024", "usage": { "input_tokens": 784, "input_tokens_details": { "image_tokens": 768, "text_tokens": 16 }, "output_tokens": 196, "output_tokens_details": { "image_tokens": 196, "text_tokens": 0 }, "total_tokens": 980 }, "data": [ { "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." } ] }

Bezpieczne pierwsze żądanie

Zacznij od jednego pliku PNG lub JPG

Pomiń maskę, dopóki podstawowy przepływ edycji nie zacznie działać

Użyj model: "gpt-image-2" dla żądań edycji obrazu GPT na tej ścieżce

Użyj jednej krótkiej instrukcji, która prosi o jedną widoczną zmianę

Odczytaj edytowany wynik z data[0].b64_json

Ustaw output_format: "jpeg", gdy chcesz otrzymać ładunek JPEG

Oczekuj większych opóźnień niż przy zwykłym generowaniu obrazów

Zachowanie modelu

Modele edycji obrazów GPT na tej ścieżce zwracają osadzone dane obrazu base64

output_format kontroluje zakodowany typ obrazu wewnątrz b64_json

response_format ma znaczenie tylko wtedy, gdy model obsługuje wyjście URL

qwen-image-edit stosuje specyficzne dla dostawcy zachowanie edycji za tą samą ścieżką CometAPI

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-2

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

mask

file

Optional PNG mask. Transparent areas mark the regions to edit. The mask dimensions must match the source image exactly.

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 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.

Dostępne opcje:

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.

Przykład:

"jpeg"

size

string

Requested output size when supported by the selected model.

Odpowiedź

200 - application/json

Edited image result.

created

integer

wymagane

usage

object

wymagane

Show child attributes

data

object[]

wymagane

Show child attributes

background

string

Background mode returned by models that expose it.

output_format

string

Encoded image type returned by GPT image models.

quality

string

Quality level returned by models that expose it.

size

string

Output size returned by models that expose it.

curl https://api.cometapi.com/v1/images/edits \ -H "Authorization: Bearer $COMETAPI_KEY" \ -F image=@cat.jpg \ -F prompt="Add a small red bow tie on the cat" \ -F model=gpt-image-2 \ -F quality=low

Moderacja treści

Klucze API

Użyj tej ścieżki, gdy

Bezpieczne pierwsze żądanie

Zachowanie modelu

Autoryzacje

Treść

Odpowiedź

​Użyj tej ścieżki, gdy

​Bezpieczne pierwsze żądanie

​Zachowanie modelu

Autoryzacje

Treść

Odpowiedź

Użyj tej ścieżki, gdy

Bezpieczne pierwsze żądanie

Zachowanie modelu