> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI Chat Completion 4o Image API 申請及び使用

> OpenAI generation 集成指南 - XHuoAPI

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://api.xhuoapi.ai/documents/1bcf3bba-102b-495d-9bba-47cd96717e45)ページにアクセスし、「Acquire」ボタンをクリックして、リクエストに必要な資格情報を取得します：

![](https://cdn.xhuoapi.ai/nyq0xz.png)

まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後は、自動的に現在のページに戻ります。

初回申請時には無料のクレジットが付与され、このAPIを無料で使用できます。

## GPT-4o 描画モデル

### 参考画像に基づく生成画像

以下は、1つの画像に基づいてカスタムスタイルの画像を生成する例です。まず、入力した画像を見てみましょう。以下の図のようになります：

![](https://cdn.xhuoapi.ai/qzx2z1.png)

参考画像は実際の人物の画像であり、これをアニメスタイルの画像に変えることができます。具体的なリクエストの例は以下の通りです：

```json theme={null}
{
  "model": "gpt-4o-image",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "アニメスタイルの画像を生成し、帽子をかぶせてください"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://cdn.xhuoapi.ai/qzx2z1.png"
          }
        }
      ]
    }
  ],
  "stream": false
}
```

サンプル結果：

```json theme={null}
{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "> ❇️ キーワード：https://file.onechats.ai/tem/f7b8024b6f430a0a9d20174bcec1ad3a.png アニメスタイルの画像を生成し、帽子をかぶせてください\n\n> ✨ Soraが画像を描いています...\n\n> 🏃 進捗：8.4%\n\n> 🏃 進捗：17.5%\n\n> 🏃 進捗：25.9%\n\n> 🏃 進捗：34.3%\n\n> 🏃 進捗：43.4%\n\n> 🏃 進捗：51.8%\n\n> 🏃 進捗：60.9%\n\n> 🏃 進捗：71.4%\n\n> 🏃 進捗：76.3%\n\n> 🏃 進捗：80.4%\n\n> 🏃 進捗：83.8%\n\n> 🏃 進捗：86.6%\n\n> 🏃 進捗：88.9%\n\n> 🏃 進捗：90.8%\n\n> 🏃 進捗：92.4%\n\n> ✅ 画像の描画に成功しました。ご確認ください~~~\n\n![](https://file.onechats.ai/tem/4abe605b362a9a59028bf7fafa5f2aff.png)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "created": 1745152859,
  "id": "chatcmpl-7c43d1dd-17e3-4513-9aec-899b21be3c2a",
  "model": "gpt-4o-image",
  "object": "chat.completion.chunk",
  "usage": {
    "prompt_tokens": 68,
    "completion_tokens": 19,
    "total_tokens": 87
  }
}
```

`choices`内の`message`が生成された完全な対話結果であり、画像結果も対話結果に含まれています。生成された画像が確かにアニメスタイルであることがわかります。具体的には以下の図のようになります：

<p>
  <img src="https://cdn.xhuoapi.ai/qmr391.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.xhuoapi.ai/qzx2z1.png"
          }
        }
      ]
    }
  ],
  "stream": false
}
```

サンプル結果：

```json theme={null}
{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "> ❇️ キーワード：未来の都市の日没の画像を作成する\n\n> ✨ Soraが画像を描いています...\n\n> 🏃 進捗：9.8%\n\n> 🏃 進捗：19.6%\n\n> 🏃 進捗：30.1%\n\n> 🏃 進捗：39.9%\n\n> 🏃 進捗：50.4%\n\n> 🏃 進捗：60.2%\n\n> 🏃 進捗：69.3%\n\n> ✅ 画像の描画に成功しました。ご確認ください~~~\n\n![](https://file.onechats.ai/tem/4ab6f3cd886aaa6fd575dd37327fae59.png)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "created": 1745153373,
  "id": "chatcmpl-29ed630a-c8fc-4a8a-a8e0-737fcc515192",
  "model": "gpt-4o-image",
  "object": "chat.completion.chunk",
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 11,
    "total_tokens": 43
  }
}
```

結果がプロンプトに合致していることが確認できます。具体的には以下のようになります：

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

### 複数画像から1つの画像を生成

複数の参考画像を使用して1つの画像を生成することもできます。例えば、イケメンとコーヒーの画像を使用して、これら2つの画像を利用してイケメンがコーヒーを飲んでいる画像を生成することができます。以下は具体的な参考画像です：

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

<p>
  <img src="https://cdn.xhuoapi.ai/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.xhuoapi.ai/pqquv3.jpg"
          }
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://cdn.xhuoapi.ai/h8j2i0.jpg"
          }
        }
      ]
    }
  ],
  "stream": false
}
```

样例结果：

```json theme={null}
{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "> ❇️ 关键字：https://file.onechats.ai/tem/b5e2049e82ef071a804d6769e580b702.png https://file.onechats.ai/tem/78e9aa8a0dbd529f3904a6629329ebbe.png 生成男生举着咖啡，并且马上要喝的样子\n\n> ✨ Sora正在绘制图片中...\n\n> 🏃 进度：11.2%\n\n> 🏃 进度：25.9%\n\n> 🏃 进度：39.9%\n\n> 🏃 进度：47.6%\n\n> 🏃 进度：55.3%\n\n> 🏃 进度：73.3%\n\n> 🏃 进度：78.0%\n\n> 🏃 进度：81.8%\n\n> ✅ 图片绘制成功，请注意查收~~~\n\n![](https://file.onechats.ai/tem/6aa9ad6c26b9d4500ea84ea9f56e331b.png)\n\n"
      },
      "finish_reason": "stop"
    }
  ],
  "created": 1745154125,
  "id": "chatcmpl-d6e5fc71-4e33-4ad6-b259-357241d7c1ab",
  "model": "gpt-4o-image",
  "object": "chat.completion.chunk",
  "usage": {
    "prompt_tokens": 106,
    "completion_tokens": 12,
    "total_tokens": 118
  }
}
```

可以看到，生成的结果确实是结合了俩张图来生成的，下面是具体的结果：

<p>
  <img src="https://cdn.xhuoapi.ai/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の接続と使用に役立つことを願っています。ご不明な点がございましたら、いつでも技術サポートチームにお問い合わせください。
