> ## 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.

# Solicitud y Uso de la API OpenAI Chat Completion 4o Image

> OpenAI generation 集成指南 - Ace Data Cloud

OpenAI ChatGPT es un sistema de diálogo de IA muy potente que, con solo ingresar una indicación, puede generar respuestas fluidas y naturales en cuestión de segundos. ChatGPT se destaca en la industria por su excelente capacidad de comprensión y generación de lenguaje. Hoy en día, ChatGPT se ha aplicado ampliamente en diversos sectores y campos, y su influencia es cada vez más significativa. Ya sea para conversaciones cotidianas, escritura creativa, consultas profesionales o programación de código, ChatGPT puede ofrecer una asistencia inteligente sorprendente, mejorando enormemente la eficiencia laboral y la creatividad humana.

Este documento describe principalmente el proceso de uso de la API OpenAI Chat Completion 4o Image, con la cual podemos utilizar fácilmente la función multimodal de diálogo oficial de OpenAI ChatGPT.

## Proceso de Solicitud

Para usar la API OpenAI Chat Completion 4o Image, primero puede ir a la página [OpenAI Chat Completion 4o Image API](https://platform.acedata.cloud/documents/openai-chat-completions) y hacer clic en el botón "Acquire" para obtener las credenciales necesarias para las solicitudes:

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

Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la página de inicio de sesión para registrarse e iniciar sesión, y después de hacerlo, volverá automáticamente a esta página.

Al solicitar por primera vez, se otorgará un crédito gratuito para usar esta API sin costo.

## Modelo de Dibujo GPT-4o

### Generación de imagen basada en imagen de referencia

A continuación se muestra un ejemplo de generación de una imagen con estilo personalizado basada en una imagen de entrada. Primero, veamos la imagen que ingresamos, como se muestra a continuación:

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

Se puede observar que la imagen de referencia es una foto real de una persona. Podemos cambiar su estilo, por ejemplo, convertirla en una imagen con estilo anime. El ejemplo específico de la solicitud es:

```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
}
```

Ejemplo de resultado:

```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": {}
  }
}
```

Dentro de `choices`, el campo `message.content` contiene el resultado completo del diálogo generado, la imagen está incluida en formato Markdown (el enlace de la imagen es temporal, por favor descárguela y guárdela a tiempo). Se puede observar que la imagen generada es efectivamente de estilo anime, como se muestra a continuación:

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

### Generación de imagen solo con texto

Podemos generar una imagen solo con una indicación de texto y recibir el resultado en formato de diálogo. A continuación, tomamos como ejemplo "Crear una imagen de una ciudad futurista al atardecer". El ejemplo específico es:

```json theme={null}
{
  "model": "gpt-4o-image",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "创建一张未来城市日落的图片"
        }
      ]
    }
  ],
  "stream": false
}
```

Ejemplo de resultado:

```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": {}
  }
}
```

Se puede ver que el resultado coincide con la indicación, como se muestra a continuación:

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

### Generar una imagen a partir de múltiples imágenes

También podemos usar varias imágenes de referencia para generar una sola imagen. Por ejemplo, usando una imagen de un hombre guapo y otra de café, podemos generar una imagen de un hombre guapo bebiendo café. A continuación, las imágenes de referencia:

<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>

Tomamos como ejemplo la indicación "Generar un hombre sosteniendo un café y a punto de beberlo", el ejemplo específico es:

```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
}
```

Ejemplo de resultado:

```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": {}
  }
}
```

Se puede ver que el resultado generado combina efectivamente las dos imágenes para crear una nueva, como se muestra a continuación:

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

## Manejo de Errores

Al llamar a la API, si se encuentra un error, la API devolverá un código y mensaje de error correspondiente. Por ejemplo:

* `400 token_mismatched`: Solicitud incorrecta, posiblemente por parámetros faltantes o inválidos.
* `400 api_not_implemented`: Solicitud incorrecta, posiblemente por parámetros faltantes o inválidos.
* `401 invalid_token`: No autorizado, token de autorización inválido o faltante.
* `429 too_many_requests`: Demasiadas solicitudes, ha excedido el límite de tasa.
* `500 api_error`: Error interno del servidor, algo salió mal en el servidor.

### Ejemplo de respuesta de error

```
{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```

## Conclusión

Con este documento, ya ha aprendido cómo usar la API OpenAI Chat Completion 4o Image para implementar fácilmente la función multimodal de procesamiento de imágenes oficial de OpenAI ChatGPT. Esperamos que este documento le ayude a integrar y utilizar mejor esta API. Si tiene alguna pregunta, no dude en contactar a nuestro equipo de soporte técnico.
