> ## 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，首先到 [Ace Data Cloud 控制台](https://platform.acedata.cloud/console/applications) 获取您的 API Token，留作备用。
如果你尚未登录或注册，会自动跳转到登录页面邀请你注册和登录，完成后会自动返回当前页面。
**一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。** 首次申请会赠送免费额度，可免费体验；额度不足时可在 [控制台](https://platform.acedata.cloud/console/coin) 充值通用余额。
> 📘 完整文档：[OpenAI Chat Completion 4o Image API →](https://platform.acedata.cloud/documents/openai-chat-completions)
## 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, 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。如有任何问题，请随时联系我们的技术支持团队。