> ## 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 早已在各個行業和領域廣泛應用，其影響力愈發顯著。無論是日常對話、創意寫作，還是專業諮詢、程式碼編程，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`：Bad request，可能是因為缺少或無效的參數。
* `400 api_not_implemented`：Bad request，可能是因為缺少或無效的參數。
* `401 invalid_token`：Unauthorized，無效或缺少授權令牌。
* `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。如有任何問題，請隨時聯繫我們的技術支援團隊。