메인 콘텐츠로 건너뛰기
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>"
    }
  ]
}
이 경로를 사용하면 CometAPI에서 OpenAI 호환 multipart 업로드를 통해 기존 이미지를 편집할 수 있습니다.

이 경로를 사용해야 하는 경우

  • 이미 원본 이미지가 있고 프롬프트 기반 편집을 원할 때
  • 특정 부분만 변경하기 위해 마스크가 필요할 수 있을 때
  • 일반 JSON 요청 대신 multipart 파일 업로드를 처리할 수 있을 때

첫 번째 검증 경로

  • PNG 또는 JPG 파일 1개로 시작하세요
  • 기본 편집 흐름이 동작할 때까지 마스크는 생략하세요
  • 눈에 보이는 변경 사항 1가지를 요청하는 짧은 지시문 1개를 사용하세요
  • 일반 이미지 생성보다 지연 시간이 더 길 수 있음을 예상하세요

모델 동작

  • gpt-image-1, gpt-image-1-mini, gpt-image-1.5는 base64 우선 편집 경로로 다루는 것이 가장 좋습니다
  • dall-e-3는 provider 경로에서 지원하는 경우 URL 출력을 반환할 수 있습니다
  • qwen-image-edit는 동일한 CometAPI 경로 뒤에서 provider별 편집 동작을 따릅니다
2026-03-13의 실시간 검증에서 더 긴 timeout을 허용했을 때 PNG 기반 gpt-image-1 요청이 성공한 것이 확인되었습니다. 응답에는 usage.input_tokens, usage.output_tokens, usage.total_tokens, 그리고 data[0].b64_json 페이로드가 반환되었습니다.

인증

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-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
기본값: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 output format when supported by the selected model.

사용 가능한 옵션:
url,
b64_json
size
string

Requested output size when supported by the selected model.

응답

200 - application/json

Edited image result.

created
integer
필수
data
object[]
필수
usage
object