ماذا تفعل إذا لم يعد gpt-image-2 قادرًا على إنشاء خلفيات شفافة؟ انتقل إلى سلسلة 2.5 في 3 خطوات لاستعادة الخلفية الشفافة

ملاحظة المؤلف: أوقفت OpenAI رسميًا دعم الخلفية الشفافة في gpt-image-2. يشرح هذا المقال سبب ظهور الخطأ، ويعرض طريقة الانتقال إلى سلسلة 2.5 والحصول مجددًا على ملفات PNG بخلفية شفافة، وذلك بتغيير اسم النموذج فقط.

أفاد عدد من المطورين مؤخرًا بأن طلبات الخلفية الشفافة في gpt-image-2، التي كانت تعمل بشكل طبيعي، بدأت تُظهر فجأة الخطأ Transparent background is not supported for this model.. المشكلة ليست في إعداداتك ولا في واجهة API؛ فقد أوقفت OpenAI رسميًا إمكانية استخدام background: “transparent” في gpt-image-2 بتاريخ 2026-09-30.

هذا ليس تقييدًا مؤقتًا من المنصة، بل هو تعديل من OpenAI نفسها. أعدنا الاختبار في 15 أكتوبر: 14 طلبًا لتحويل النص إلى صورة و7 طلبات لتحرير الصور، ورُفضت جميع طلبات الخلفية الشفافة رسميًا. أما الحالات opaque وauto وعدم إرسال background، فتُنتج الصور بشكل طبيعي.

الفائدة الأساسية: بعد قراءة هذا المقال، ستفهم أسباب ظهور خطأ الخلفية الشفافة في gpt-image-2 وملابساته. وستتعرف أيضًا على طريقة الانتقال إلى gpt-image-2.5-flare وgpt-image-2.5-sunburst؛ إذ يكفي عادةً تغيير اسم النموذج في سطر واحد لاستعادة إمكانية إخراج الصور بخلفية شفافة.

أبرز النقاط حول خطأ الخلفية الشفافة في gpt-image-2

لنبدأ بطلب نموذجي يُظهر هذا الخطأ. أرسل المستخدم إلى gpt-image-2 المعلمات التالية، على أمل الحصول على صورة PNG بلا خلفية أو حواف أو توهج:

{
  "model": "gpt-image-2",
  "background": "transparent",
  "output_format": "png",
  "quality": "low",
  "size": "2048x2560",
  "n": "1",
  "prompt": "去掉背景，没有边缘，没有光晕"
}

وجاء رد الواجهة بالخطأ التالي. الحقلان الأساسيان فيه هما code: invalid_value وparam: background:

{
  "error": {
    "code": "invalid_value",
    "message": "Transparent background is not supported for this model.",
    "param": "background",
    "type": "shell_api_error"
  }
}

توضح رسالة الخطأ المعلمة المسببة للمشكلة. ويلخص الجدول التالي المعلومات الأساسية:

لماذا أُوقفت الخلفية الشفافة في gpt-image-2؟

يتضح من التسلسل الزمني أن الخلفية الشفافة في gpt-image-2 لم تكن ميزة رسمية منذ البداية. فقد أُتيحت منذ 2026-08-21 بصيغة preview، أي على سبيل التجربة. وفي 30 سبتمبر، أوقفت OpenAI هذه النسخة التجريبية رسميًا، وطلبت من المستخدمين الذين يحتاجون إلى خلفية شفافة الانتقال إلى النموذجين في سلسلة 2.5 اللذين يدعمانها أصليًا.

وهذا يفسر لماذا شعر بعض المطورين بأن «كل شيء كان يعمل جيدًا قبل شهرين». إذا أضفت دعم الخلفية الشفافة إلى مشروعك بين أواخر أغسطس وسبتمبر، فالأرجح أنك كنت تستخدم ميزة تجريبية، ومن الطبيعي أن تتوقف عن العمل بعد إيقافها. وبما أن الرفض صادر مباشرةً عن OpenAI، فلا تستطيع أي خدمة وكيل أو منصة تجميع تجاوز هذا القيد؛ والحل الصحيح هو الانتقال إلى نموذج آخر.

ما قيم background التي ما زالت متاحة في gpt-image-2؟

يخشى كثيرون أن يكون gpt-image-2 قد أصبح غير متاح بالكامل، لكن هذا غير صحيح. القيمة الوحيدة التي أُوقفت هي transparent، أما أوضاع الخلفية الأخرى فما زالت تعمل كالمعتاد. يوضح الجدول التالي نتائج إعادة الاختبار التي أجريناها في 15 أكتوبر:

لذلك، إذا كانت بعض حالات الاستخدام في نشاطك فقط تتطلب خلفية شفافة، فلا داعي إلى الانتقال إلى نموذج آخر بالكامل. والأفضل أن تواصل استخدام gpt-image-2 لإنشاء الصور العادية، وأن توجّه الطلبات التي تحتاج إلى خلفية شفافة فقط إلى سلسلة 2.5.

نقل دعم الخلفية الشفافة إلى gpt-image-2: ابدأ في 3 خطوات

المبدأ الأساسي للنقل بسيط: غيّر اسم النموذج حسب الاستخدام، واترك بقية المعلمات كما هي. النماذج الثلاثة متساوية في السعر والمعلمات، لذا لا حاجة إلى تعديل size أو quality أو output_format أو prompt التي أعددتها مسبقًا.

يمكنك تنفيذ ذلك باتباع الخطوات الثلاث التالية:

1. حدّد الطلبات: ابحث في الشفرة عن background="transparent" أو "background": "transparent" للعثور على جميع الاستدعاءات التي تستخدم خلفية شفافة.
2. استبدل النموذج حسب الاستخدام: غيّر النموذج في استدعاءات images.generate إلى gpt-image-2.5-flare، وفي استدعاءات images.edit إلى gpt-image-2.5-sunburst.
3. تحقّق من تنسيق الإخراج: تأكّد من أن قيمة output_format هي png أو webp. فتنسيق JPEG لا يدعم قناة ألفا، لذلك لن يحفظ معلومات الشفافية حتى لو كان النموذج يدعمها.

مثال مبسط على الخلفية الشفافة باستخدام gpt-image-2.5-flare

إليك أبسط طريقة لتوليد صورة بخلفية شفافة انطلاقًا من نص، باستخدام حزمة OpenAI الرسمية لـ Python:

import base64
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # APIYI OpenAI 兼容接口
)

result = client.images.generate(
    model="gpt-image-2.5-flare",       # 原 gpt-image-2 改为 flare
    prompt="一只卡通风格的橙色小狐狸贴纸，干净边缘，无光晕",
    background="transparent",
    output_format="png",
    quality="low",
    size="1024x1024",
    n=1,
)

with open("fox.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

وتنبيه صغير: في الطلب المرجعي، أُرسلت قيمة n كسلسلة نصية "1". يُفضّل تغييرها إلى عدد صحيح 1 لتجنب مشكلات الأنواع في بعض حزم SDK أو عند استخدام عمليات تحقق أكثر صرامة.

مثال على تعديل الصور باستخدام gpt-image-2.5-sunburst مع الرجوع التلقائي

إذا كان المطلوب إزالة خلفية صورة موجودة، فهذا يُعدّ تعديلًا للصورة، ومن الأفضل استخدام واجهة التحرير مع gpt-image-2.5-sunburst. فهذا أنسب لاستخدام النموذج من كتابة «أزل الخلفية» في موجه تحويل النص إلى صورة.

يضمّ الكود الكامل أدناه دالتين لتوليد الصور وتعديلها. كما يتضمن آلية احتياطية: إذا أرسل جزء قديم من الكود طلبًا بخلفية شفافة إلى gpt-image-2، فسيعيد المحاولة تلقائيًا باستخدام نموذج 2.5 المناسب، بعد التقاط خطأ 400 الذي يحتوي على param=background.

import base64
from typing import Optional
from openai import OpenAI, BadRequestError

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # APIYI 统一接口，一个 Key 调用三款模型
)

# 透明背景场景的模型映射
TRANSPARENT_MODEL = {
    "generate": "gpt-image-2.5-flare",     # 文生图
    "edit": "gpt-image-2.5-sunburst",      # 改图 / 编辑
}


def pick_model(task: str, background: Optional[str], model: str) -> str:
    """需要透明背景时，自动选择 2.5 系列模型"""
    if background == "transparent" and model == "gpt-image-2":
        return TRANSPARENT_MODEL[task]
    return model


def is_transparent_rejected(err: BadRequestError) -> bool:
    """识别 gpt-image-2 透明背景被拒的 400 错误"""
    msg = str(err)
    return "Transparent background is not supported" in msg or "background" in msg


def save_b64(b64_data: str, path: str) -> str:
    with open(path, "wb") as f:
        f.write(base64.b64decode(b64_data))
    return path


def generate_image(
    prompt: str,
    out_path: str,
    model: str = "gpt-image-2",
    background: Optional[str] = "transparent",
    size: str = "1024x1024",
    quality: str = "low",
    output_format: str = "png",
) -> str:
    params = dict(
        prompt=prompt,
        size=size,
        quality=quality,
        output_format=output_format,
        n=1,
    )
    if background:
        params["background"] = background

    target = pick_model("generate", background, model)
    try:
        result = client.images.generate(model=target, **params)
    except BadRequestError as e:
        if is_transparent_rejected(e) and target == "gpt-image-2":
            result = client.images.generate(
                model=TRANSPARENT_MODEL["generate"], **params
            )
        else:
            raise
    return save_b64(result.data[0].b64_json, out_path)


def edit_image(
    image_path: str,
    prompt: str,
    out_path: str,
    model: str = "gpt-image-2",
    background: Optional[str] = "transparent",
    output_format: str = "png",
) -> str:
    target = pick_model("edit", background, model)
    with open(image_path, "rb") as img:
        kwargs = dict(
            image=img,
            prompt=prompt,
            output_format=output_format,
            n=1,
        )
        if background:
            kwargs["background"] = background
        result = client.images.edit(model=target, **kwargs)
    return save_b64(result.data[0].b64_json, out_path)


if __name__ == "__main__":
    # 文生图透明底：自动走 gpt-image-2.5-flare
    generate_image("极简风格的咖啡杯图标，扁平设计", "cup.png")

    # 改图去背景：自动走 gpt-image-2.5-sunburst
    edit_image("product.jpg", "去掉背景，保留主体，没有边缘，没有光晕", "product_cut.png")

نصيحة للبدء بسرعة: إذا كان مشروعك يستخدم gpt-image-2 وسلسلة 2.5 معًا، فننصحك بالربط عبر APIYI apiyi.com لتوحيد الوصول. باستخدام مفتاح API واحد، يمكنك استدعاء النماذج الثلاثة. ويحصل المستخدمون الجدد على رصيد مجاني للاختبار، ما يتيح لهم تجربة النتائج بخلفية شفافة قبل الترحيل.

مقارنة بدائل الخلفية الشفافة في gpt-image-2

إلى جانب الانتقال مباشرةً إلى سلسلة 2.5، يفكر بعض المستخدمين في إنشاء صورة بخلفية بيضاء باستخدام gpt-image-2، ثم إزالة الخلفية بأداة مخصصة. لكل خيار استخداماته المناسبة، ويوضح الجدول التالي مقارنة بينهما:

قراءة لاختيار حل الخلفية الشفافة في gpt-image-2

تحليل مقارن لحل إزالة الخلفية بعد التوليد: تكمن ميزة استخدام «خلفية بيضاء + إزالة الخلفية» في أنه يحافظ بالكامل على أسلوب الصور التي يولّدها gpt-image-2. لكنه يضيف خطوة معالجة، وقد تظهر حواف بيضاء أو هالات حول المناطق التي تضم خصلات شعر دقيقة أو زجاجًا شبه شفاف أو ظلالًا مسقطة. وهذه تحديدًا من المشكلات التي أراد المستخدم استبعادها في الموجه الوارد في الطلب المرجعي. في المقابل، تُخرج سلسلة 2.5 قناة شفافية أصلية، ما يجعل مسار العمل أقصر ويلائم أكثر الإنتاج الآلي على نطاق واسع.

تحليل مقارن لسلسلة 2.5: يُعدّ gpt-image-2.5-flare وgpt-image-2.5-sunburst النموذجين البديلين اللذين حددتهما OpenAI رسميًا للخلفيات الشفافة. وهما بالسعر نفسه وبالمعلمات نفسها، لذا فإن الانتقال إليهما يكاد لا يكلّف شيئًا. بالنسبة إلى المشاريع الجديدة أو الفرق التي لا تملك مسار عمل جاهزًا لإزالة الخلفية، فإن استخدام سلسلة 2.5 مباشرةً خيار أكثر موثوقية.

ملاحظة حول المقارنة: ترتبط النتائج الفعلية لكل حل ارتباطًا وثيقًا بنوع المواد التي تستخدمها. ننصح بتجربة المجموعة نفسها من الموجهات على APIYI apiyi.com، ثم مقارنة جودة الحواف قبل اختيار الحل المناسب للإنتاج.

الأسئلة الشائعة

النقاط الأساسية للانتقال من gpt-image-2 عند استخدام خلفية شفافة

• حقيقة الإيقاف: أوقفت OpenAI في 2026-09-30 ميزة الخلفية الشفافة التجريبية في gpt-image-2.
• خصائص الخطأ: HTTP 400، وinvalid_value، وparam: background، ولا تُحتسب رسوم على الطلبات المرفوضة.
• ما يزال متاحًا: يعمل gpt-image-2 بصورة طبيعية مع الخلفية المعتمة، أو auto، أو عند عدم تمرير background.
• بديل تحويل النص إلى صورة: استخدم gpt-image-2.5-flare لإنشاء صور بخلفية شفافة من النص؛ يكفي تغيير اسم النموذج.
• بديل تعديل الصور: استخدم gpt-image-2.5-sunburst لتحرير الصور بخلفية شفافة؛ النماذج الثلاثة لها السعر والمعلمات نفسها.
• تنبيه بشأن التنسيق: احرص على استخدام PNG أو WebP عند إخراج صورة شفافة، إذ لا يمكن لملفات JPEG حفظ قناة الشفافية.
• طريقة البدء: استخدم APIYI عبر apiyi.com لاستدعاء النماذج الثلاثة بمفتاح واحد، وتحقق منها مجانًا قبل الترحيل.

الخلاصة

لا يستطيع gpt-image-2 إنشاء صور بخلفية شفافة، والسبب ليس في شيفرتك، بل إن OpenAI أوقفت رسميًا هذه الإمكانية التجريبية. إليك الحل باختصار:

1. تحقّق من السبب: ظهور الرسالة Transparent background is not supported for this model. يعني أن OpenAI أوقفت هذه الإمكانية. لن تُحتسب رسوم، ولا حاجة إلى تكرار المحاولة.
2. اختر النموذج المناسب لحالة الاستخدام: لتحويل النص إلى صورة، انتقل إلى gpt-image-2.5-flare؛ ولتعديل الصور، انتقل إلى gpt-image-2.5-sunburst، مع الإبقاء على بقية المعلمات كما هي.
3. أضف آلية احتياطية: أضف تعيينًا للنماذج ومنطقًا للانتقال إلى نموذج بديل عند تلقي خطأ 400 في طبقة الاستدعاء، وتأكد من أن تنسيق الإخراج هو png أو webp.

بالنسبة إلى معظم المشاريع، لا يتطلب هذا الانتقال سوى تغيير اسم النموذج في سطر واحد. ننصحك بالتحقق سريعًا من أداء سلسلة 2.5 في إنشاء الصور بخلفية شفافة عبر APIYI apiyi.com. توفر المنصة واجهة متوافقة مع OpenAI ورصيدًا مجانيًا للاختبار، ما يسهّل التبديل بين gpt-image-2 وسلسلة 2.5.

📚 المراجع

1. مركز مساعدة APIYI: الأسئلة الشائعة حول خلفية الصور الشفافة: توضيح إيقاف دعم الخلفية الشفافة في gpt-image-2 وإرشادات الانتقال
2. الرابط: docs.apiyi.com/faq/image-transparent-background

3. توضيح: يتضمن شرح رسالة الخطأ والنماذج البديلة ومقارنة المعلمات، ويمكن الاستعانة به للتحقق أثناء الانتقال

4. وثائق واجهة OpenAI لتوليد الصور: شرح معلمات واجهتي images.generate وimages.edit

5. الرابط: platform.openai.com/docs/guides/image-generation

6. توضيح: للاطّلاع على التعريفات الرسمية لمعلَمات background وoutput_format وquality وغيرها

7. حزمة OpenAI الرسمية لـ Python: الشيفرة المصدرية للعميل الرسمي وأمثلة الاستخدام

8. الرابط: github.com/openai/openai-python
9. توضيح: أمثلة الشيفرة في هذه المقالة مبنية على هذه الحزمة، ويمكنك الرجوع إليها لمعرفة أنواع الاستثناءات وطريقة استخدام واجهات الصور

الكاتب: فريق APIYI التقني
للتواصل التقني: يسعدنا تواصلك معنا عبر الصفحة الرئيسية لموقع APIYI الرسمي. وللاطّلاع على مزيد من المعلومات حول دمج نماذج الصور، تفضّل بزيارة مركز الوثائق على docs.apiyi.com

مقالات ذات صلة

• حل مشكلة الشرائط الملونة في الصور المُولَّدة باستخدام GPT image 2.5: تشخيص 5 أنواع من الشرائط الملونة ودليل اختيار مَعلمة الجودة: حلّل خمسة أنواع وأسباب ظهور الأشرطة والضوضاء الملوّنة عند توليد الصور بـgpt-image-2.5-sunburst، واشرح علاقة مستويات الجودة بميزانية القدرة الحاسوبية، وقدّم تحويلًا للمستويات وفق «2.5 high ≈ 2 medium» ومقارنة للتكلفة وحلولًا لإزالتها دون زيادة كبيرة في الميزانية.
• gpt-image-2 لتوليد مجموعات صور التجارة الإلكترونية بطريقتين: صورة مفردة متعددة الأبعاد مقابل تفكيك النص + استدعاء متزامن (مع الكود الكامل): تقبل واجهة gpt-image-2 موجهًا واحدًا لكل طلب، وn ينتج تنويعات للموجه نفسه؛ وتشرح المقالة حلين لصور المتاجر الإلكترونية: صورة تفاصيل طويلة متعددة المعلومات، أو تقسيم المشاهد بنموذج نصي مثل gpt-6.1-sol ثم استدعاء gpt-image-2 بالتوازي لتوليد المجموعة، مع الكود ونصائح الاتساق والتوسع.
• رفيق سطح مكتب بالذكاء الاصطناعي يملأ الشاشة: حدّد الشخصية باستخدام Nano Banana، وأنشئ حركات بخلفية خضراء باستخدام Seedance، وحوّله في 3 خطوات إلى رفيق سطح مكتب متحرك بخلفية شفافة: دليل لصنع حيوان أليف مكتبي بالذكاء الاصطناعي عبر واجهة رسومية أساسًا: صمّم شخصيتك باستخدام Nano Banana، وأنشئ فيديو حركات بخلفية خضراء باستخدام Seedance، ثم أزل الخلفية عبر سلسلة مواد dsh-pet لتحويله إلى WebM شفاف، وأضفه إلى DSH ليصبح حيوانًا أليفًا متحركًا على سطح المكتب.
• ماذا تفعل إذا انخفض ذكاء gpt-6-astra؟ دليل عملي من 5 خطوات لاستكشاف الأخطاء وإصلاحها + استخدام مفتاح API كبديل مؤقت عند نفاد الرصيد: لمعالجة مشكلتي تراجع ذكاء gpt-6-astra ونفاد حصة ChatGPT/Codex، قمنا بتلخيص منهجية فحص من 5 خطوات لأسباب تراجع الأداء، مع تقديم حل متكامل يتضمن استخدام مفتاح API الرسمي كبديل مؤقت، والتحكم في كثافة الاستنتاج، وتحسين معدل نجاح التخزين المؤقت.