> ## 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» для получения необходимых учетных данных:

![](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. Если у вас возникнут вопросы, пожалуйста, обращайтесь в нашу техническую поддержку.
