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

> OpenAI generation 集成指南 - Ace Data Cloud

يُعد OpenAI ChatGPT نظام حوار ذكي قوي للغاية، حيث يمكنه توليد ردود طبيعية وسلسة في غضون ثوانٍ فقط بمجرد إدخال الكلمات المفتاحية. يتميز ChatGPT بقدراته الممتازة في فهم اللغة وتوليدها، مما يجعله فريدًا في المجال. اليوم، يُستخدم ChatGPT على نطاق واسع في مختلف الصناعات والمجالات، وتأثيره أصبح أكثر وضوحًا. سواء في المحادثات اليومية، أو الكتابة الإبداعية، أو الاستشارات المهنية، أو برمجة الأكواد، يمكن لـ ChatGPT تقديم مساعدة ذكية مذهلة، مما يعزز بشكل كبير كفاءة الإنسان وإبداعه.

تتناول هذه الوثيقة بشكل رئيسي خطوات استخدام واجهة برمجة تطبيقات OpenAI Chat Completion 4o Image، والتي تتيح لنا بسهولة استخدام وظيفة الحوار متعددة الوسائط الرسمية لـ OpenAI ChatGPT.

## خطوات الطلب

لاستخدام واجهة برمجة تطبيقات OpenAI Chat Completion 4o Image، يمكنك أولاً الذهاب إلى صفحة [OpenAI Chat Completion 4o Image API](https://platform.acedata.cloud/documents/openai-chat-completions) والنقر على زر "Acquire" للحصول على بيانات الاعتماد المطلوبة للطلب:

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

إذا لم تكن قد سجلت الدخول أو أنشأت حسابًا بعد، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لتسجيل حساب جديد أو تسجيل الدخول، وبعد ذلك ستعود تلقائيًا إلى الصفحة الحالية.

عند الطلب لأول مرة، ستحصل على حصة مجانية لاستخدام هذه الواجهة مجانًا.

## نموذج الرسم 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، إذا حدث خطأ، ستعيد الواجهة رمز الخطأ والمعلومات ذات الصلة. على سبيل المثال:

* `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 بسهولة لتحقيق وظيفة معالجة الصور متعددة الوسائط الرسمية لـ OpenAI ChatGPT. نأمل أن تساعدك هذه الوثيقة في التكامل والاستخدام الأفضل لهذه الواجهة. إذا كان لديك أي استفسار، لا تتردد في الاتصال بفريق الدعم الفني لدينا.