메인 콘텐츠로 건너뛰기

1. API Key 가져오기

Ace Data Cloud 애플리케이션 목록을 열고, 사용 가능한 애플리케이션으로 들어가 API Key를 복사합니다. Ace Data Cloud API Key 가져오기

2. 이미지 URL을 사용한 편집

원본 이미지: GPT Image 2 편집 원본 이미지
성공 응답:
이는 2026년 9월 8일 Ace Data Cloud를 통해 실제로 완료된 편집 결과이며, 컵은 주황색으로, 배경은 짙은 네이비 블루로 변경되었고 원본 구도와 1024×1536 크기는 유지되었습니다: GPT Image 2 주황색 머그컵 편집 결과

3. 로컬 이미지 업로드

multipart/form-data를 사용합니다:
image는 반복하여 전달할 수 있으며, GPT Image 시리즈는 최대 16장의 참조 이미지를 지원합니다. JSON 요청의 image는 단일 URL 또는 URL 배열일 수 있으며, 로컬 파일은 multipart로 업로드합니다.

모델 및 과금 방식

공식 API 채널의 페이지 가격은 요청 전 추정치이며, 최종적으로는 응답의 실제 Token 사용량과 사용 기록을 기준으로 합니다.

4. 마스크를 사용한 부분 편집

공식 Images Edit 인터페이스는 mask를 통해 수정이 허용되는 영역을 지정합니다. Ace Data Cloud의 :official 모델은 동일한 multipart 계약을 따릅니다:
  • mask는 Alpha 채널이 있는 PNG여야 하며, 크기는 4MB를 초과할 수 없습니다;
  • 마스크 크기는 첫 번째 image와 완전히 일치해야 합니다;
  • Alpha가 0인 투명 픽셀은 편집 허용을 나타내며, 불투명 픽셀은 유지해야 함을 나타냅니다;
  • 색상만 흑백이고 투명 채널이 없는 RGB 이미지는 유효한 마스크로 사용할 수 없습니다;
  • 프롬프트는 원하는 완성 화면을 설명하는 동시에, 부분 수정과 변경되지 않아야 하는 내용을 명확히 해야 합니다.
아래에서는 먼저 원본 이미지로부터 마스크를 생성합니다. 예시는 중앙 사각형을 투명하게 설정하여 모델이 해당 영역만 수정하도록 허용합니다:
그런 다음 원본 이미지와 마스크를 함께 업로드합니다:
OpenAI 공식 Python SDK의 images.edit 호출 방식을 그대로 사용할 수도 있으며, base_url만 Ace Data Cloud로 지정하면 됩니다:
mask를 사용할 때 원본 이미지와 마스크는 동일한 multipart 요청에서 각각 image=@input.png 및 mask=@mask.png를 통해 업로드해야 합니다. URL 원본 이미지와 로컬 마스크 파일을 혼합하여 전달하지 마십시오. 순수 URL 편집 요청은 로컬 mask 파일을 추가로 첨부하는 것을 지원하지 않습니다. 마스크는 편집 영역을 제한하지만, 생성 모델은 여전히 가장자리를 자연스럽게 혼합할 수 있습니다. 엄격한 경계가 필요한 경우 명확한 Alpha 가장자리를 사용하고, 프롬프트에서 어떤 내용을 반드시 변경하지 않고 유지해야 하는지 반복하여 설명해야 합니다. 위 호출 방식은 OpenAI Image Edit API 및 GPT Image 공식 Cookbook의 마스크 예시와 일치합니다.

5. 일반 매개변수

크기 규칙은 생성 인터페이스와 동일합니다. 너비와 높이는 16의 배수여야 하고, 긴 변은 3840을 초과할 수 없으며, 총 픽셀 수는 655,360–8,294,400이고, 가로세로 비율은 3:1을 초과할 수 없습니다. size를 생략하거나 auto를 사용할 경우, 모델은 프롬프트와 첫 번째 참조 이미지를 결합하여 화면 비율을 선택합니다. gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst 및 gpt-image-2:reverse는 성공한 이미지 수를 기준으로 과금됩니다. gpt-image-2:official, gpt-image-2.5-flare:official 및 gpt-image-2.5-sunburst:official은 텍스트 입력, 참조 이미지 입력 및 이미지 출력의 실제 Token을 기준으로 정산되며, 최종적으로 사용 기록을 기준으로 합니다.

6. 비동기 콜백 및 문제 해결

장시간 작업은 요청에 다음을 추가할 수 있습니다:
비동기 200 응답은 {"task_id": "..."}입니다. 완료 후 최종 결과를 콜백합니다. 동기 요청은 created와 data를 반환합니다. 오류 응답에는 trace_id가 포함됩니다. 문제를 피드백할 때 해당 ID를 제공하고, API Key는 제공하지 마십시오. 전체 필드와 실시간 열거값은 OpenAI Images Edits API 페이지를 기준으로 합니다. 순수 텍스트로 이미지를 생성하려면 GPT Image 2 / 2.5 이미지 생성을 확인하십시오.