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

# Demande et utilisation de l’API OpenAI Chat Completion 4o Image

> OpenAI generation 集成指南 - Ace Data Cloud

OpenAI ChatGPT est un système de dialogue IA très puissant qui, dès qu’on saisit un prompt, peut générer en quelques secondes une réponse fluide et naturelle. ChatGPT se distingue dans l’industrie par ses capacités exceptionnelles de compréhension et de génération de langage. Aujourd’hui, ChatGPT est largement utilisé dans divers secteurs et domaines, et son influence est de plus en plus marquée. Que ce soit pour des conversations quotidiennes, l’écriture créative, des consultations professionnelles ou la programmation, ChatGPT offre une assistance intelligente impressionnante, améliorant grandement l’efficacité et la créativité humaines.

Ce document présente principalement le processus d’utilisation de l’API OpenAI Chat Completion 4o Image, qui permet d’utiliser facilement la fonctionnalité de dialogue multimodal officielle d’OpenAI ChatGPT.

## Processus de demande

Pour utiliser l’API OpenAI Chat Completion 4o Image, vous pouvez d’abord vous rendre sur la page [OpenAI Chat Completion 4o Image API](https://platform.acedata.cloud/documents/openai-chat-completions) et cliquer sur le bouton « Acquire » pour obtenir les identifiants nécessaires à la requête :

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

Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion pour vous inscrire et vous connecter. Après connexion ou inscription, vous reviendrez automatiquement à cette page.

Lors de la première demande, un quota gratuit est offert, vous permettant d’utiliser cette API gratuitement.

## Modèle de dessin GPT-4o

### Génération d’image à partir d’une image de référence

Voici un exemple de génération d’une image personnalisée à partir d’une image, commençons par regarder l’image d’entrée, comme illustré ci-dessous :

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

On peut voir que l’image de référence est une photo d’une personne réelle. Nous pouvons la transformer en un style différent, par exemple en style anime. Voici un exemple de requête :

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

Exemple de résultat :

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

Dans `choices`, le champ `message.content` contient le résultat complet de la conversation générée, l’image est incluse au format Markdown (le lien de l’image est temporaire, veuillez la télécharger rapidement). On constate que l’image générée est bien dans le style anime, comme illustré ci-dessous :

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

### Génération d’image uniquement à partir de texte

Nous pouvons générer une image à partir d’un prompt textuel et recevoir le résultat sous forme de dialogue. Prenons l’exemple de « créer une image d’une ville futuriste au coucher du soleil », voici un exemple précis :

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

Exemple de résultat :

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

Le résultat correspond bien au prompt, comme illustré ci-dessous :

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

### Fusion de plusieurs images en une seule

Nous pouvons également utiliser plusieurs images de référence pour générer une seule image. Par exemple, en utilisant une photo d’un bel homme et une photo de café, on peut générer une image d’un homme tenant un café. Voici les images de référence :

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

Prenons comme exemple le prompt « générer un homme tenant un café prêt à le boire », voici la requête correspondante :

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

Exemple de résultat :

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

On voit que le résultat généré combine bien les deux images de référence, voici le résultat final :

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

## Gestion des erreurs

Lors de l’appel de l’API, en cas d’erreur, l’API renvoie un code d’erreur et un message correspondant. Par exemple :

* `400 token_mismatched` : Requête incorrecte, probablement à cause de paramètres manquants ou invalides.
* `400 api_not_implemented` : Requête incorrecte, probablement à cause de paramètres manquants ou invalides.
* `401 invalid_token` : Non autorisé, jeton d’autorisation invalide ou manquant.
* `429 too_many_requests` : Trop de requêtes, vous avez dépassé la limite de fréquence.
* `500 api_error` : Erreur interne du serveur, un problème est survenu côté serveur.

### Exemple de réponse d’erreur

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

## Conclusion

Grâce à ce document, vous avez appris comment utiliser l’API OpenAI Chat Completion 4o Image pour exploiter facilement la fonctionnalité multimodale officielle d’OpenAI ChatGPT pour le traitement d’images. Nous espérons que ce guide vous aidera à mieux intégrer et utiliser cette API. Pour toute question, n’hésitez pas à contacter notre équipe de support technique.
