> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gravitex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 이미지 편집 (Edits)

> OpenAI 호환 POST /v1/images/edits

## 소개

`POST /v1/images/edits`는 OpenAI 호환 이미지 편집 엔드포인트입니다. 지원 모델:

* **Qwen**: `qwen-image-edit-plus` — [Qwen Image](/ko/api-reference/endpoint/qwen-image) 참고
* **GPT-Image-2**: JSON 또는 `multipart/form-data`

텍스트-이미지는 `POST /v1/images/generations`를 사용합니다. GPT-Image-2는 `image` 필드를 포함한 generations로도 I2I가 가능합니다 — [GPT-Image-2](/ko/api-reference/endpoint/gpt-image-2) 참고.

## 인증

<ParamField header="Authorization" type="string" required>
  Bearer Token, 예: `Bearer sk-xxxxxxxxxx`
</ParamField>

## 요청 예제

<Tabs>
  <Tab title="GPT-Image-2 (JSON)">
    ```bash theme={null}
    curl -X POST "https://api.gravitex.ai/v1/images/edits" \
      -H "Authorization: Bearer sk-xxxxxxxxxx" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gpt-image-2",
        "prompt": "Change background to beach sunset",
        "image": "https://example.com/photo.png",
        "size": "1024x1024",
        "quality": "high"
      }'
    ```
  </Tab>

  <Tab title="GPT-Image-2 (multipart)">
    ```bash theme={null}
    curl -X POST "https://api.gravitex.ai/v1/images/edits" \
      -H "Authorization: Bearer sk-xxxxxxxxxx" \
      -F "model=gpt-image-2" \
      -F "prompt=Change background to beach sunset" \
      -F "image[]=@photo.png"
    ```
  </Tab>

  <Tab title="Qwen">
    ```bash theme={null}
    curl -X POST "https://api.gravitex.ai/v1/images/edits" \
      -H "Authorization: Bearer sk-xxxxxxxxxx" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "qwen-image-edit-plus",
        "input": {
          "messages": [{
            "role": "user",
            "content": [
              {"image": "https://example.com/input.webp"},
              {"text": "Change scene to winter snow"}
            ]
          }]
        }
      }'
    ```
  </Tab>
</Tabs>

모델별 세부 사항은 [이미지 생성](/ko/api-reference/endpoint/image-generation)을 참고하세요.
