Dokumentacja referencyjna API
Przewodniki integracji
Cennik i rozliczenia
OpenAI
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 --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>"
}
]
}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-miniigpt-image-1.5najlepiej traktować jako ścieżki edycji typu base64-firstdall-e-3może zwracać wynik w postaci URL, gdy ścieżka providera to obsługujeqwen-image-editdział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
Bearer token authentication. Use your CometAPI key.
Treść
multipart/form-data
Source image file. Start with one PNG or JPG input for the simplest flow.
Edit instruction describing the change you want.
Przykład:
"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.
Dostępne opcje:
high, medium, low Requested output format when supported by the selected model.
Dostępne opcje:
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>"
}
]
}