> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Chat Completion 4o Image API 申請及使用

> OpenAI generation 集成指南 - XHuoAPI

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://api.xhuoapi.ai/documents/1bcf3bba-102b-495d-9bba-47cd96717e45) 頁面點擊「Acquire」按鈕，獲取請求所需要的憑證：

![](https://cdn.xhuoapi.ai/nyq0xz.png)

如果你尚未登入或註冊，會自動跳轉到登入頁面邀請您來註冊和登入，登入註冊之後會自動返回當前頁面。

在首次申請時會有免費額度贈送，可以免費使用該 API。

## GPT-4o 繪圖模型

### 根據參考圖進行生圖

下面是根據一個圖片生成自定義風格的圖片的示例，首先讓我們看一下我們輸入的圖片，如下圖所示：

![](https://cdn.xhuoapi.ai/qzx2z1.png)

可以看到參考圖是一個真人的圖片，我們可以讓它變化一種風格，比如讓它變成動漫風格的圖像，具體的請求樣例：

```json theme={null}
{
  "model": "gpt-4o-image",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "生成動漫風格的圖片，並且帶上個帽子"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://cdn.xhuoapi.ai/qzx2z1.png"
          }
        }
      ]
    }
  ],
  "stream": false
}
```

樣例結果：

```json theme={null}
{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "> ❇️ 關鍵字：https://file.onechats.ai/tem/f7b8024b6f430a0a9d20174bcec1ad3a.png 生成動漫風格的圖片，並且帶上個帽子\n\n> ✨ Sora正在繪製圖片中...\n\n> 🏃 進度：8.4%\n\n> 🏃 進度：17.5%\n\n> 🏃 進度：25.9%\n\n> 🏃 進度：34.3%\n\n> 🏃 進度：43.4%\n\n> 🏃 進度：51.8%\n\n> 🏃 進度：60.9%\n\n> 🏃 進度：71.4%\n\n> 🏃 進度：76.3%\n\n> 🏃 進度：80.4%\n\n> 🏃 進度：83.8%\n\n> 🏃 進度：86.6%\n\n> 🏃 進度：88.9%\n\n> 🏃 進度：90.8%\n\n> 🏃 進度：92.4%\n\n> ✅ 圖片繪製成功，請注意查收~~~\n\n![](https://file.onechats.ai/tem/4abe605b362a9a59028bf7fafa5f2aff.png)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "created": 1745152859,
  "id": "chatcmpl-7c43d1dd-17e3-4513-9aec-899b21be3c2a",
  "model": "gpt-4o-image",
  "object": "chat.completion.chunk",
  "usage": {
    "prompt_tokens": 68,
    "completion_tokens": 19,
    "total_tokens": 87
  }
}
```

其中`choices`裡面的`message`就是生成完整的對話結果，圖片結果也包含在對話結果裡面，可以看出生成的圖片確實是動漫風格的，具體的如下圖所示：

<p>
  <img src="https://cdn.xhuoapi.ai/qmr391.jpg" width="400" className="m-auto" />
</p>

### 純文字生圖

我們可以通過一個提示詞讓它生成圖片，並且以對話式的結果返回給我們，下面我們以`創建一張未來城市日落的圖片`為示例，下面具體的示例：

```json theme={null}
{
  "model": "gpt-4o-image",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "生成動漫風格的圖片，並且帶上個帽子"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://cdn.xhuoapi.ai/qzx2z1.png"
          }
        }
      ]
    }
  ],
  "stream": false
}
```

樣例結果：

```json theme={null}
{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "> ❇️ 關鍵字：創建一張未來城市日落的圖片\n\n> ✨ Sora正在繪製圖片中...\n\n> 🏃 進度：9.8%\n\n> 🏃 進度：19.6%\n\n> 🏃 進度：30.1%\n\n> 🏃 進度：39.9%\n\n> 🏃 進度：50.4%\n\n> 🏃 進度：60.2%\n\n> 🏃 進度：69.3%\n\n> ✅ 圖片繪製成功，請注意查收~~~\n\n![](https://file.onechats.ai/tem/4ab6f3cd886aaa6fd575dd37327fae59.png)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "created": 1745153373,
  "id": "chatcmpl-29ed630a-c8fc-4a8a-a8e0-737fcc515192",
  "model": "gpt-4o-image",
  "object": "chat.completion.chunk",
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 11,
    "total_tokens": 43
  }
}
```

可以看到結果是符合提示詞的，具體的如下所示：

<p>
  <img src="https://cdn.xhuoapi.ai/q502uk.jpg" width="400" className="m-auto" />
</p>

### 多圖生一圖

我們還可以使用多張參考圖來生成一張圖，比如使用一張帥哥和咖啡圖，利用這兩張圖可以生成一張帥哥喝咖啡的圖，下面是具體的參考圖：

<p>
  <img src="https://cdn.xhuoapi.ai/pqquv3.jpg" width="400" className="m-auto" />
</p>

<p>
  <img src="https://cdn.xhuoapi.ai/h8j2i0.jpg" width="400" className="m-auto" />
</p>

下面我们以`生成男生举着咖啡，并且马上要喝的样子`为示例，下面具体的示例：

```json theme={null}
{
  "model": "gpt-4o-image",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "生成男生举着咖啡，并且马上要喝的样子"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://cdn.xhuoapi.ai/pqquv3.jpg"
          }
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://cdn.xhuoapi.ai/h8j2i0.jpg"
          }
        }
      ]
    }
  ],
  "stream": false
}
```

樣例結果：

```json theme={null}
{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "> ❇️ 关键字：https://file.onechats.ai/tem/b5e2049e82ef071a804d6769e580b702.png https://file.onechats.ai/tem/78e9aa8a0dbd529f3904a6629329ebbe.png 生成男生举着咖啡，并且马上要喝的样子\n\n> ✨ Sora正在绘制图片中...\n\n> 🏃 进度：11.2%\n\n> 🏃 进度：25.9%\n\n> 🏃 进度：39.9%\n\n> 🏃 进度：47.6%\n\n> 🏃 进度：55.3%\n\n> 🏃 进度：73.3%\n\n> 🏃 进度：78.0%\n\n> 🏃 进度：81.8%\n\n> ✅ 图片绘制成功，请注意查收~~~\n\n![](https://file.onechats.ai/tem/6aa9ad6c26b9d4500ea84ea9f56e331b.png)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "created": 1745154125,
  "id": "chatcmpl-d6e5fc71-4e33-4ad6-b259-357241d7c1ab",
  "model": "gpt-4o-image",
  "object": "chat.completion.chunk",
  "usage": {
    "prompt_tokens": 106,
    "completion_tokens": 12,
    "total_tokens": 118
  }
}
```

可以看到，生成的结果确实是结合了俩张图来生成的，下面是具体的结果：

<p>
  <img src="https://cdn.xhuoapi.ai/89vnpx.jpg" width="400" className="m-auto" />
</p>

## 錯誤處理

在調用 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。如有任何問題，請隨時聯繫我們的技術支持團隊。