OpenAI Images API 설정 가이드
이미지 생성은 일반적인 채팅 인터페이스와 다릅니다. AI 제공업체(중계 사이트)가 텍스트 모델을 지원한다고 해서 OpenAI 이미지 인터페이스까지 지원한다는 의미는 아닙니다. 설정하기 전에 해당 제공업체에서 'Images API', '이미지 생성' 또는 해당 모델을 명시적으로 지원하는지 확인하세요.
공식 정보 다운로드 및 문서는 공식 사이트를 기준으로 합니다.
먼저 제공업체가 이미지 인터페이스를 지원하는지 확인
| 확인 항목 | 확인 방법 | 이유 |
|---|---|---|
| 인터페이스 유형 | 관리자 페이지나 문서에 Images API, 이미지 생성, 이미지 편집 등이 명시되어 있는지 확인 | OpenAI 호환 채팅 인터페이스만 명시되어 있는 경우 이미지 인터페이스는 지원하지 않을 수 있음 |
| 모델 권한 | 모델 목록에 이미지 모델이 포함되어 있는지, 계정 또는 Key에 권한이 있는지 확인 | 이미지 모델은 텍스트 모델과 별도로 과금되고 활성화되는 경우가 많음 |
| 요청 경로 | 제공업체에서 이미지 인터페이스용 예시를 제공하는지 확인 | 일부 제공업체는 채팅 인터페이스만 프록시하므로, 이미지 경로로 직접 요청 시 404 오류 발생 |
| 가격 | 이미지는 장당, 크기별, 품질별로 과금됨 | 대량 생성 전에 소량으로 테스트하여 과도한 비용 소모 방지 |
채팅 인터페이스와의 차이점
| 유형 | 주요 인터페이스 | 필요한 준비 사항 |
|---|---|---|
| 텍스트 대화 | /v1/chat/completions Or Responses | Key, Base URL, 모델명, 메시지 내용 |
| 이미지 생성 | /v1/images/generations | Key, 이미지 모델, 프롬프트, 크기, 출력 형식 |
| 이미지 편집 | 이미지 편집 인터페이스 | 프롬프트 외에도 원본 이미지 또는 마스크 파일 업로드 필요 |
필드 입력 방법
| 설정 항목 | 입력 방법 |
|---|---|
| 엔드포인트 | https://api.openai.com/v1/images/generations |
| 모델 | 공식 예시: <code>gpt-image-2</code>; 중계 사이트의 경우 제공업체 목록에 맞춰 입력 |
| 프롬프트 | 생성하려는 이미지 설명 |
| 크기 | 이미지 크기 |
| 형식 | URL 또는 base64 |
중계 사이트를 사용하는 경우 공식 도메인 부분을 제공업체가 제공한 이미지 API 주소로 변경하세요. 제공업체가 이미지 인터페이스 지원을 명시하지 않았다면 기본 지원으로 간주하지 마세요. Base URL에 /v1이 포함되는지 여부도 관리자 페이지의 예시를 따르고 임의로 추측하지 마세요.
요청 예시
OpenAI 이미지 생성 예시
curl https://api.openai.com/v1/images/generations \ -H "Authorization: Bearer YOUR_OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-2", "prompt": "A clean product photo of a white ceramic mug on a solid-color background", "size": "1024x1024" }'이미지 인터페이스의 비용은 일반적으로 텍스트 인터페이스와 다릅니다. 대량 생성 전에 요금을 확인하세요.
| 오류 | 일반적인 원인 | 해결 방법 |
|---|---|---|
| 404 / endpoint not found | 제공업체에 이미지 프록시 인터페이스가 없거나 경로의 /v1 표기가 잘못됨 | 관리자 페이지에서 이미지 전용 인터페이스 예시를 확인하고, 채팅 인터페이스 주소를 그대로 사용하지 마세요 |
| model not found | 현재 제공업체 목록에 해당 이미지 모델명이 없음 | 텍스트 모델이 아닌 이미지 모델의 정확한 모델 ID/모델명을 복사하여 사용하세요 |
| unsupported content type | 이미지 편집 인터페이스는 파일 업로드가 필요하며, 단순 JSON만 전송할 수 없음 | 생성 인터페이스와 편집 인터페이스 중 어떤 것을 호출하고 있는지 먼저 확인하세요 |