Перейти до основного вмісту
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.

Використовуйте цей маршрут, щоб редагувати наявні зображення за допомогою сумісних з OpenAI multipart uploads у CometAPI.

​
Використовуйте цей маршрут, коли

  • У вас уже є вихідне зображення, і ви хочете редагування на основі Prompt
  • Вам може знадобитися маска для цільових змін
  • Ви можете працювати з multipart file upload замість звичайного JSON-запиту

​
Безпечний перший запит

  • Почніть з одного файлу PNG або JPG
  • Пропустіть маску, доки не запрацює базовий процес редагування
  • Використовуйте model: "gpt-image-2" для запитів на редагування зображень GPT на цьому маршруті
  • Використовуйте одну коротку інструкцію, яка просить про одну видиму зміну
  • Зчитуйте відредагований результат із data[0].b64_json
  • Установіть output_format: "jpeg", якщо вам потрібен payload JPEG
  • Очікуйте більшої затримки, ніж під час звичайної генерації зображень

​
Поведінка моделі

  • Моделі GPT для редагування зображень на цьому маршруті повертають вбудовані зображення у форматі base64
  • output_format керує типом закодованого зображення всередині b64_json
  • response_format має значення лише тоді, коли модель підтримує виведення URL
  • qwen-image-edit дотримується специфічної для провайдера поведінки редагування за тим самим маршрутом CometAPI

Авторизації

​
Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Тіло

multipart/form-data
​
image
file
обов'язково

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

​
prompt
string
обов'язково

Edit instruction describing the change you want.

Приклад:

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

​
model
string
за замовчуванням: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
за замовчуванням:1

Number of edited images to return.

​
quality
enum<string>

Quality setting for models that support it.

Доступні опції:
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.

Доступні опції:
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.

Приклад:

"jpeg"

​
size
string

Requested output size when supported by the selected model.

Відповідь

200 - application/json

Edited image result.

​
created
integer
обов'язково
​
usage
object
обов'язково
​
data
object[]
обов'язково