> ## 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」按钮，获取请求所需要的凭证：
如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。
在首次申请时会有免费额度赠送，可以免费使用该 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.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\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`就是生成完整的对话结果，图片结果也包含在对话结果里面，可以看出生成的图片确实是动漫风格的，具体的如下图所示：
### 纯文字生图
我们可以通过一个提示词让它生成图片，并且以对话式的结果返回给我们，下面我们以`创建一张未来城市日落的图片`为示例，下面具体的示例：
```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\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
}
}
```
可以看到结果是符合提示词的，具体的如下所示：
### 多图生一图
我们还可以使用使用多张参考图来生成一张图，比如使用一张帅哥和咖啡图，利用这俩张图可以生成一张帅哥喝咖啡的图，下面是具体的参考图：
下面我们以`生成男生举着咖啡，并且马上要喝的样子`为示例，下面具体的示例：
```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\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
}
}
```
可以看到，生成的结果确实是结合了俩张图来生成的，下面是具体的结果：
## 错误处理
在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：
* `400 token_mismatched`：Bad request, possibly due to missing or invalid parameters.
* `400 api_not_implemented`：Bad request, possibly due to missing or invalid parameters.
* `401 invalid_token`：Unauthorized, invalid or missing authorization token.
* `429 too_many_requests`：Too many requests, you have exceeded the rate limit.
* `500 api_error`：Internal server error, something went wrong on the server.
### 错误响应示例
```
{
"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。如有任何问题，请随时联系我们的技术支持团队。