1. API Key 가져오기
Ace Data Cloud 애플리케이션 목록을 열고, 사용 가능한 애플리케이션에 들어가 API Key를 복사합니다.
2. 첫 번째 요청 보내기
data[].url에 있습니다. 아래는 2026년 9월 8일 Ace Data Cloud를 통해 실제 요청으로 얻은 1024×1536 결과입니다(작업 d56455e2-e7f7-4bcd-b935-475b0a1e0948, trace eb938601-8192-407f-b539-1e0554b697ec):
3. 자주 사용하는 매개변수
자주 사용하는 크기:
size: "auto"는 프롬프트의 비율, 픽셀 및 레이아웃 의도에 따라 캔버스를 선택합니다. 정확한 픽셀이 필요할 때는 크기를 직접 입력합니다.
모델 및 과금 방식
공식 API 채널의 페이지 가격은 요청 전 추정치이며, 최종적으로는 응답의 실제 Token 사용량과 사용 기록을 기준으로 합니다.
4. 여러 장 생성
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을 기준으로 정산됩니다. 페이지 가격은 요청 전 추정치이며, 최종적으로는 사용 기록을 기준으로 합니다.
5. 비동기 콜백
요청 본문에callback_url을 추가하면, 인터페이스는 먼저 {"task_id": "..."}를 반환하고 완료 시 해당 URL로 최종 결과를 POST합니다. 동기 요청은 여전히 created와 data를 반환합니다:
task_id를 사용하여 중복을 제거하고, 요청 출처와 데이터 형식을 검증해야 합니다.
6. 문제 해결
오류 응답에는
error.code, error.message 및 trace_id가 포함됩니다. 문제를 피드백할 때는 trace_id를 제공하고, API Key는 제공하지 마세요.
전체 필드 및 실시간 열거형은 OpenAI Images Generations API 페이지를 기준으로 합니다. 이미지 편집은 GPT Image 2 / 2.5 이미지 편집을 확인하세요.
