> ## 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», щоб отримати необхідні для запиту облікові дані:

![](https://cdn.acedata.cloud/nyq0xz.png)

Якщо ви ще не увійшли або не зареєструвалися, вас автоматично перенаправлять на сторінку входу, де ви зможете зареєструватися та увійти. Після входу або реєстрації ви автоматично повернетесь на цю сторінку.

При першій заявці надається безкоштовний ліміт, що дозволяє безкоштовно користуватися API.

## Модель малювання GPT-4o

### Генерація зображення за зразком

Нижче наведено приклад створення зображення в кастомному стилі на основі одного зображення. Спочатку подивимось на вхідне зображення:

![](https://cdn.acedata.cloud/qzx2z1.png)

Як бачимо, зразок — це фото реальної людини. Ми можемо змінити стиль, наприклад, зробити його аніме-стилем. Приклад запиту:

```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![https://pro.filesystem.site/cdn/20260609/0f7b6cf1b14843b1bab8e261fe5765b3.png](https://pro.filesystem.site/cdn/20260609/0f7b6cf1b14843b1bab8e261fe5765b3.png)\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 (посилання тимчасове, тому рекомендується завантажити та зберегти). Як видно, створене зображення дійсно виконане в аніме-стилі, приклад нижче:

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

### Генерація зображення за текстом

Можна створити зображення лише за текстовою підказкою, отримавши результат у вигляді діалогу. Наприклад, створимо зображення «майбутнього міста на заході сонця». Приклад запиту:

```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![https://pro.filesystem.site/cdn/20260609/ed2cca68732540fc99162ddc10ddc153.png](https://pro.filesystem.site/cdn/20260609/ed2cca68732540fc99162ddc10ddc153.png)\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": {}
  }
}
```

Як бачимо, результат відповідає підказці, приклад нижче:

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

### Генерація одного зображення з кількох

Можна використовувати кілька зразків для створення одного зображення. Наприклад, використаємо фото чоловіка та кави, щоб створити зображення чоловіка, який п’є каву. Ось зразки:

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

<p>
  <img src="https://cdn.acedata.cloud/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.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![https://pro.filesystem.site/cdn/20260610/f1d9ddee3c304230a9f92929f04b95be.png](https://pro.filesystem.site/cdn/20260610/f1d9ddee3c304230a9f92929f04b95be.png)\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": {}
  }
}
```

Як видно, результат дійсно поєднує обидва зображення, приклад нижче:

<p>
  <img src="https://cdn.acedata.cloud/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. Якщо у вас виникнуть питання, будь ласка, звертайтеся до нашої технічної підтримки.
