> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.
# OpenAI Chat Completion 4o Image API 신청 및 사용
> OpenAI generation 集成指南 - Ace Data Cloud
OpenAI ChatGPT는 매우 강력한 AI 대화 시스템으로, 입력한 프롬프트에 따라 단 몇 초 만에 자연스럽고 유창한 답변을 생성할 수 있습니다. ChatGPT는 탁월한 언어 이해 및 생성 능력으로 업계에서 독보적인 위치를 차지하고 있으며, 현재 다양한 산업과 분야에서 널리 활용되고 그 영향력이 점점 커지고 있습니다. 일상 대화, 창의적 글쓰기, 전문 상담, 코드 프로그래밍 등 어디에서든 ChatGPT는 놀라운 지능형 지원을 제공하여 인간의 업무 효율성과 창의성을 크게 향상시킵니다.
이 문서는 OpenAI Chat Completion 4o Image API 사용 절차를 주로 소개하며, 이를 통해 공식 OpenAI ChatGPT의 멀티모달 대화 기능을 손쉽게 활용할 수 있습니다.
## 신청 절차
OpenAI Chat Completion 4o Image API를 사용하려면 먼저 [OpenAI Chat Completion 4o Image API](https://platform.acedata.cloud/documents/openai-chat-completions) 페이지에서 「Acquire」 버튼을 클릭하여 요청에 필요한 인증 정보를 획득하세요:
로그인 또는 회원가입이 되어 있지 않은 경우 자동으로 로그인 페이지로 이동하여 회원가입 및 로그인을 안내합니다. 로그인 및 회원가입 후 자동으로 현재 페이지로 돌아옵니다.
최초 신청 시 무료 할당량이 제공되어 해당 API를 무료로 사용할 수 있습니다.
## GPT-4o 그림 모델
### 참고 이미지를 기반으로 원본 이미지 생성
아래는 한 장의 이미지를 기반으로 커스텀 스타일의 이미지를 생성하는 예시입니다. 먼저 입력한 이미지를 확인해 보겠습니다:
참고 이미지는 실제 인물 사진이며, 이를 애니메이션 스타일 이미지로 변환할 수 있습니다. 구체적인 요청 예시는 다음과 같습니다:
```json theme={null}
{
"model": "gpt-4o-image",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "생성 애니메이션 스타일 이미지, 모자도 씌워주세요"
},
{
"type": "image_url",
"image_url": {
"url": "https://cdn.acedata.cloud/qzx2z1.png"
}
}
]
}
],
"stream": false
}
```
예시 결과:
```json theme={null}
{
"id": "chatcmpl-89DPQxbLuyRNzH5YLCPYM5WElV3dm",
"object": "chat.completion",
"created": 1781020664,
"model": "gpt-4o-image",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "\n\n> 🎨 생성 중...\n\n\n\n[다운로드 클릭](https://pro.filesystem.site/cdn/download/20260609/0f7b6cf1b14843b1bab8e261fe5765b3.png)"
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 100,
"completion_tokens": 122,
"total_tokens": 222,
"prompt_tokens_details": {
"text_tokens": 93,
"cached_tokens_details": {}
},
"completion_tokens_details": {}
}
}
```
`choices` 내 `message.content`가 생성된 전체 대화 결과이며, 이미지는 Markdown 형식으로 포함되어 있습니다(이미지 링크는 임시 주소이므로 빠르게 다운로드하여 저장하세요). 생성된 이미지는 확실히 애니메이션 스타일임을 아래 이미지에서 확인할 수 있습니다:
### 순수 텍스트로 이미지 생성
프롬프트 하나로 이미지를 생성하고 대화형 결과로 반환받을 수 있습니다. 예를 들어 `미래 도시 일몰 이미지 생성`을 요청하는 구체적인 예시는 다음과 같습니다:
```json theme={null}
{
"model": "gpt-4o-image",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "미래 도시 일몰 이미지 생성"
}
]
}
],
"stream": false
}
```
예시 결과:
```json theme={null}
{
"id": "chatcmpl-89DqkpQoPGkQqJ6kPKMKWejjLXVxQ",
"object": "chat.completion",
"created": 1781020587,
"model": "gpt-4o-image",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "\n\n> 🎨 생성 중...\n\n\n\n[다운로드 클릭](https://pro.filesystem.site/cdn/download/20260609/ed2cca68732540fc99162ddc10ddc153.png)"
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 17,
"completion_tokens": 104,
"total_tokens": 121,
"prompt_tokens_details": {
"text_tokens": 10,
"cached_tokens_details": {}
},
"completion_tokens_details": {}
}
}
```
결과가 프롬프트와 일치함을 아래 이미지에서 확인할 수 있습니다:
### 여러 이미지로 한 장의 이미지 생성
여러 참고 이미지를 사용해 한 장의 이미지를 생성할 수도 있습니다. 예를 들어 잘생긴 남성과 커피 이미지를 활용해 남성이 커피를 마시려는 모습을 생성할 수 있습니다. 참고 이미지들은 다음과 같습니다:
`남성이 커피를 들고 곧 마시려는 모습 생성` 요청 예시는 다음과 같습니다:
```json theme={null}
{
"model": "gpt-4o-image",
"messages": [
{
"role": "user",
"content": [
{
"type": "text",
"text": "남성이 커피를 들고 곧 마시려는 모습 생성"
},
{
"type": "image_url",
"image_url": {
"url": "https://cdn.acedata.cloud/pqquv3.jpg"
}
},
{
"type": "image_url",
"image_url": {
"url": "https://cdn.acedata.cloud/h8j2i0.jpg"
}
}
]
}
],
"stream": false
}
```
예시 결과:
```json theme={null}
{
"id": "chatcmpl-89DnHbbzOIQvU1VzJrNjzMU8BRUgG",
"object": "chat.completion",
"created": 1781021018,
"model": "gpt-4o-image",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "\n\n> 🎨 생성 중...\n\n\n\n[다운로드 클릭](https://pro.filesystem.site/cdn/download/20260610/f1d9ddee3c304230a9f92929f04b95be.png)"
},
"logprobs": null,
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 193,
"completion_tokens": 116,
"total_tokens": 309,
"prompt_tokens_details": {
"text_tokens": 186,
"cached_tokens_details": {}
},
"completion_tokens_details": {}
}
}
```
생성된 결과는 두 이미지를 결합하여 생성된 것이 확실하며, 아래에서 구체적인 결과를 확인할 수 있습니다:
## 오류 처리
API 호출 시 오류가 발생하면 API는 해당 오류 코드와 메시지를 반환합니다. 예를 들어:
* `400 token_mismatched`：잘못된 요청, 누락되었거나 유효하지 않은 매개변수 가능성.
* `400 api_not_implemented`：잘못된 요청, 누락되었거나 유효하지 않은 매개변수 가능성.
* `401 invalid_token`：권한 없음, 유효하지 않거나 누락된 인증 토큰.
* `429 too_many_requests`：요청 과다, 속도 제한 초과.
* `500 api_error`：서버 내부 오류, 서버 측 문제 발생.
### 오류 응답 예시
```
{
"success": false,
"error": {
"code": "api_error",
"message": "fetch failed"
},
"trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```
## 결론
이 문서를 통해 OpenAI Chat Completion 4o Image API를 사용하여 공식 OpenAI ChatGPT의 멀티모달 이미지 처리 기능을 손쉽게 구현하는 방법을 이해하셨습니다. 본 문서가 API 연동 및 사용에 도움이 되길 바라며, 궁금한 점이 있으면 언제든지 기술 지원팀에 문의해 주시기 바랍니다.