هل يتم خصم الرصيد عند فشل توليد الصور في APIYI Nano Banana 2؟ تحليل شامل لـ 3 حالات

هل تفرض واجهة برمجة تطبيقات (API) Nano Banana 2 رسومًا في حال فشل توليد الصور؟ هذا هو "القلق المالي" الأول الذي يواجه العديد من المطورين عند البدء في استخدام Google Gemini 3.1 Flash Image (Nano Banana 2). خاصة عندما تظهر رسائل مثل finishReason: IMAGE_SAFETY أو blockReason: OTHER أو تنبيهات مثل "الصورة التي قدمتها تبدو وكأنها وثيقة هوية… لا يمكنني تعديلها" بسبب قيود أمان المحتوى. يتساءل الكثيرون: هل سأدفع ثمن الطلب رغم عدم الحصول على الصورة؟

إليك الإجابة المباشرة: في معظم سيناريوهات رفض المحتوى بسبب سياسات الأمان، لا تفرض واجهة Nano Banana 2 أي رسوم على المطورين مقابل مخرجات الصور. علاوة على ذلك، عندما تتضمن رسالة الـ finishMessage نصًا صريحًا يفيد بأن "You will not be charged for this request" (لن يتم تحصيل رسوم منك مقابل هذا الطلب)، فإن Google تقرر رسميًا إعفاء هذا الطلب من الرسوم. يستعرض هذا المقال، استنادًا إلى وثائق Gemini الرسمية وأحدث النقاشات في منتدى المطورين، قواعد الفوترة في 3 سيناريوهات فشل نموذجية، ويوضح كيفية عمل الفواتير الفعلية عند استدعاء Nano Banana 2 عبر منصة APIYI (apiyi.com).

المبادئ الأساسية لاحتساب رسوم Nano Banana 2 API عند فشل توليد الصور

3 حقائق رئيسية حول فوترة Nano Banana 2 API

قبل الإجابة على سؤال "هل يتم خصم الرسوم عند فشل توليد الصورة؟"، من الضروري فهم هيكل الفوترة الخاص بـ Nano Banana 2؛ فهو لا يعتمد على نموذج "كل استدعاء له ثمن ثابت"، بل يعتمد على الفوترة القائمة على الاستهلاك (Usage-based) بناءً على الرموز (Tokens) المدخلة والمخرجة.

يرجى ملاحظة الحقائق الثلاث التالية:

• رموز المخرجات هي التكلفة الرئيسية: تكلفة رموز المخرجات لصورة بدقة 1K تعادل تقريبًا 5-20 ضعف تكلفة رموز المدخلات، مما يعني أنه في حال عدم توليد الصورة، فإن التكلفة المقتطعة تكاد تكون مهملة.
• رموز المدخلات رخيصة للغاية: سعر $0.50 لكل مليون token يعني أن "موجه" (prompt) بطول 500 كلمة يكلف أقل من $0.0003 دولار.
• الفوترة على أساس المخرجات الفعلية: لا يتم احتساب تكاليف رموز المخرجات إلا للطلبات التي تولد صورًا بالفعل؛ فالطلبات الفاشلة التي لا تنتج صورة لا تتحمل أي رسوم تقريبًا.

موقف Google الرسمي بشأن فوترة الطلبات الفاشلة

أكدت Google في وثائق Gemini API ومنتديات المطورين مرارًا على مبدأ أساسي: عندما يحدد النظام بوضوح أن الطلب قد تم حظره بواسطة طبقة السياسات (Layer 2)، أو عند وجود رسالة finishMessage تنص بوضوح على "You will not be charged for this request"، لا يتم احتساب أي رسوم على هذا الطلب.

هذا المبدأ ينطبق تمامًا عند استدعاء Nano Banana 2 عبر منصة APIYI (apiyi.com). منطق الفوترة لدينا متوافق بدقة مع حقل usage الذي تعيده Google؛ حيث لا تفرض Google رسومًا، لا تفرض APIYI رسومًا أيضًا، ولا مجال لحدوث أي مواقف حيث تُعفي الجهة الرسمية المستخدم من الرسوم بينما تقوم الخدمة الوسيطة بخصمها خفية.

إليك ترجمة المحتوى إلى العربية:

3 حالات نموذجية لفشل توليد الصور عبر Nano Banana 2 API

الحالة 1: تم حظر الموجه بعد تقديمه بواسطة الطبقة الأولى (Layer 1) (بسبب blockReason: SAFETY)

هذا هو أكثر أنواع الحظر "نظافةً" — حيث يتم إيقاف الطلب قبل أن يصل إلى نموذج توليد الصور الفعلي. في هذه الحالة، ستظهر في استجابة الـ API البيانات التالية:

{
  "promptFeedback": {
    "blockReason": "SAFETY",
    "safetyRatings": [
      {"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "probability": "HIGH"}
    ]
  }
}

وضع الرسوم: لا توجد رسوم أو يتم خصم مبلغ زهيد جداً من رموز الإدخال (tokens). لأن النموذج لم يقم بعملية الاستدلال الفعلية، ولم يتم إنتاج أي جزء من المخرجات، كما أن تكلفة رموز الإدخال بحد ذاتها منخفضة للغاية (0.5 دولار لكل مليون).

شروط التحفيز: عندما يطابق الموجه عتبة فئة الأمان القابلة للضبط، مثل وجود كلمات حساسة تتعلق بالعنف، الكراهية، أو المحتوى الجنسي الصريح.

الإجراء المقابل: يمكنك تجاوز الطبقة الأولى عن طريق ضبط المعامل safety_settings على BLOCK_NONE أو OFF، ولكن هذا لن يتجاوز الطبقة الثانية التي سنشرحها أدناه.

الحالة 2: الحظر بواسطة سياسات الطبقة الثانية (Layer 2) بعد توليد الصورة (finishReason: IMAGE_SAFETY)

هذا هو نوع الفشل الأكثر شيوعاً بين المطورين، ويطابق حالة "لا يمكنني تعديل هذه الصورة لأنها تبدو كوثيقة هوية (مثل رخصة القيادة)" التي ذكرها المستخدمون في أسئلتهم. مثال على الاستجابة:

{
  "candidates": [{
    "finishReason": "IMAGE_SAFETY",
    "finishMessage": "لا يمكنني إكمال طلب تعديل هذه الصورة. نظرًا لأن الصورة التي قدمتها تبدو كوثيقة هوية شخصية (مثل رخصة القيادة)، لا يمكنني تعديلها أو إعادة توليدها أو تحرير ميزات أمنية محددة فيها (مثل الشعارات، العلامات المائية، أو التوقيعات) بناءً على طلبك."
  }]
}

وضع الرسوم: يتم خصم رموز الإدخال بشكل طبيعي، بينما تكون رموز الإخراج للصور صفراً تقريباً. لأن النموذج قد أكمل عملية الاستدلال، ولكن لم يتم إخراج بيانات الصورة في النهاية، ولن تظهر في فاتورتك سوى تكلفة إدخال صغيرة جداً (عادةً أقل من 0.001 دولار).

شروط التحفيز: مطابقة السياسات غير القابلة للضبط في الطبقة الثانية، وتتضمن الحالات النموذجية:

• طلبات تعديل وثائق الهوية (رخص القيادة، جوازات السفر، بطاقات الهوية، إلخ).
• توليد صور واقعية لشخصيات معروفة.
• استخدام محتوى محمي بحقوق الطبع والنشر (شخصيات/شعارات/علامات تجارية).
• المحتوى الحساس المتعلق بسلامة الأطفال.

الإجراء المقابل: الطبقة الثانية لا يمكن تجاوزها عبر معاملات الـ API، والحل الوحيد هو إعادة كتابة الموجه لإزالة العناصر المحمية.

الحالة 3: قرر النموذج عدم التوليد (رسالة finishMessage توضح بوضوح عدم وجود رسوم)

هذه هي الطريقة الأكثر "لطفاً" من Google في الرفض — حيث تظهر في الاستجابة جملة إنجليزية مميزة جداً:

{
  "candidates": [{
    "finishMessage": "Unable to show the generated image. The model could not generate the image based on the prompt provided. You will not be charged for this request. Try rephrasing the prompt. If you think this was an error, send feedback"
  }]
}

وضع الرسوم: الطلب مجاني بالكامل. هذا التزام صريح من Google ضمن نص الاستجابة، وسواء كنت تستخدم الـ API الرسمي أو منصات التجميع المتوافقة مثل APIYI (apiyi.com)، سيتم التعامل مع هذه الطلبات بصفر تكلفة.

شروط التحفيز:

• حدد النموذج أن الموجه غامض جداً أو لا يمكن استخلاص نتيجة واضحة منه.
• قام النموذج بتشغيل الاستدلال ولكنه فشل في توليد مخرجات صور صالحة.
• تسبب الموجه في تفعيل تقييم أمان داخلي خاص بـ Google لم يتم الإفصاح عنه.

الإجراء المقابل: قم بإعادة صياغة الموجه والمحاولة مجدداً، ولا داعي للقلق بشأن تكلفة إعادة المحاولة.

جدول مقارنة تكاليف حالات فشل Nano Banana 2 API

مقارنة تكاليف استدعاء النموذج بين حالات الفشل والنجاح

🎯 ملخص النقاط الرئيسية: في جميع حالات الفشل المعروفة لنموذج Nano Banana 2، لا يتحمل المطور أبداً "التكلفة الكاملة لتوليد الصورة". فحتى أغلى سيناريو للفشل (المستوى 2) لا يصل إلى 1% من تكلفة الطلب الناجح. عند استدعاء الخدمة عبر APIYI (apiyi.com)، تقوم المنصة بتمرير حقول الاستخدام (usage) الخاصة بـ Google بالكامل، وتكون قواعد الخصم متطابقة مع الرسمية.

لماذا يشعر المطورون أحياناً بـ "خصم مبالغ غير مبرر"؟

يرى بعض المطورين أن رصيدهم ينقص رغم فشل العملية، ويرجع ذلك غالباً إلى سوء فهم لهذه النقاط الثلاث:

• تأخر الفوترة: عادةً ما يكون هناك نافذة تأخير في تجميع الفواتير من Google تتراوح بين 24-48 ساعة، لذا فإن الخصم الذي تراه قد يكون ناتجاً عن طلبات ناجحة سابقة.
• تراكم الطلبات المتعددة: قد تكلف عملية فاشلة واحدة مبلغ 0.0003 دولار فقط، ولكن إذا فشلت 1000 عملية في وقت قصير، سيظهر خصم مرئي قدره 0.3 دولار.
• طول الموجه (Prompt) المدخل: عند إدخال صور مرجعية كبيرة (مثل صورة أساسية بدقة 4K)، قد تتضخم رموز الإدخال للطلب الواحد لتصل إلى عشرات الآلاف، مما يجعل تكلفة الإدخال أعلى من المعتاد حتى في حالة الفشل.

💡 نصيحة لمراقبة التكاليف: ننصح بتحليل حقل usageMetadata في الرد برمجياً، وتسجيل promptTokenCount و candidatesTokenCount و totalTokenCount لكل طلب في قاعدة بياناتك. كما توفر لوحة تحكم APIYI (apiyi.com) تفاصيل استهلاك الرموز لكل استدعاء، مما يساعدك على تحديد "أي طلب فاشل تسبب في خصم غير متوقع" بسرعة.

طريقة التحقق برمجياً من تكاليف الفشل في Nano Banana 2 API

الحصول على بيانات دقيقة للخصم عبر Python SDK

from openai import OpenAI

# إعداد العميل باستخدام APIYI
client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.apiyi.com/v1"
)

response = client.images.generate(
    model="gemini-3.1-flash-image",
    prompt="يرجى تعديل حقل الجنس في صورة بطاقة الهوية هذه",
    n=1,
    size="1024x1024"
)

# التحقق من بيانات الاستخدام
if hasattr(response, "usage"):
    print("رموز الإدخال:", response.usage.prompt_tokens)
    print("رموز الإخراج:", response.usage.completion_tokens)
    print("إجمالي الرموز:", response.usage.total_tokens)

# التحقق من سبب الفشل
for item in response.data:
    if getattr(item, "finish_reason", None) == "IMAGE_SAFETY":
        print("تم الاعتراض في المستوى 2، لا يوجد خصم على الإخراج")
    elif "not be charged" in (getattr(item, "finish_message", "") or ""):
        print("أكدت Google عدم وجود خصم على هذا الطلب")

import time
from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.apiyi.com/v1"
)

NO_CHARGE_PHRASES = ["You will not be charged", "not be charged for this request"]
LAYER2_FINISH_REASONS = {"IMAGE_SAFETY", "IMAGE_PROHIBITED_CONTENT", "OTHER"}

def generate_with_retry(prompt: str, max_retry: int = 3):
    for attempt in range(1, max_retry + 1):
        try:
            response = client.images.generate(
                model="gemini-3.1-flash-image",
                prompt=prompt,
                size="1024x1024"
            )

            item = response.data[0]
            finish_reason = getattr(item, "finish_reason", "")
            finish_message = getattr(item, "finish_message", "") or ""

            # التحقق من شروط عدم الخصم
            if any(p in finish_message for p in NO_CHARGE_PHRASES):
                print(f"[المحاولة {attempt}] Google صرحت بعدم الخصم، جارٍ تغيير الموجه وإعادة المحاولة")
                return None
            if finish_reason in LAYER2_FINISH_REASONS:
                print(f"[المحاولة {attempt}] تم الاعتراض عبر سياسة المستوى 2، لم يتم خصم تكلفة الإخراج")
                return None

            return item.url

        except Exception as e:
            print(f"[المحاولة {attempt}] خطأ: {e}")
            time.sleep(2 ** attempt)

    return None

url = generate_with_retry("قطة برتقالية تتجول في حديقة يابانية، بأسلوب أوكييو-إيه")
print("النتيجة النهائية:", url)

كيفية التحقق من الفاتورة الفعلية "صفرية التكلفة"

نوصي باستخدام ميزة سجلات الطلبات (Request Logs) في لوحة تحكم APIYI (apiyi.com) للتحقق المزدوج:

1. قم بتسجيل request_id و finishReason و usage لكل طلب فاشل في سجلاتك المحلية.
2. استخدم request_id في لوحة تحكم APIYI لعرض المبلغ الذي خصمته المنصة فعلياً مقابل هذا الطلب.
3. قارن بينهما – إذا وجدت أي تباين، يمكنك التواصل مباشرة مع خدمة العملاء للمراجعة.

نظراً لأن منصة APIYI تمرر بيانات الاستخدام الأصلية من Google، فإن احتمالية حدوث تباين ضئيلة جداً، ولكن آلية التحقق المزدوج عبر السجلات هذه تضمن تلبية متطلبات التدقيق المالي للمستخدمين من فئة المؤسسات.

مقارنة قواعد فرض الرسوم عند فشل استدعاء API بين Nano Banana 2 والمنصات الأخرى

مقارنة قواعد فرض الرسوم عند فشل استدعاء API الصور

تكمن الميزة الفريدة لـ Nano Banana 2 في إشارات الفشل الواضحة، حيث تتيح حقول finishReason و finishMessage للمطورين تحديد ما إذا كان الطلب قد تسبب في فرض رسوم برمجياً، وهو أمر يتطلب عادةً في المنصات الأخرى إجراء تجارب إعادة محاولة يدوية للوصول إلى استنتاج.

🎯 نصيحة للاختيار: إذا كان عملك يتطلب "قدرة عالية على توقع الفشل" (مثل سيناريوهات التوليد عالي التردد أو مشاريع محتوى المستخدمين UGC)، فإننا نوصي باختيار Nano Banana 2 كأولوية. ومن خلال الربط الموحد عبر APIYI (apiyi.com)، يمكنك الحصول على نفس ميزة عدم الخصم عند الفشل الموجودة لدى الجهة الرسمية، مع تجنب الحاجة إلى صيانة منطق محاسبي منفصل لكل منصة على حدة.

أفضل الممارسات لسيناريوهات فشل استدعاء Nano Banana 2 API

3 نصائح لتحسين الموجه (Prompt) لتقليل حالات الفشل غير الضرورية

على الرغم من أن حالات الفشل لا تستهلك رصيداً مالياً في الغالب، إلا أن معدل الفشل المرتفع يؤدي إلى تراجع تجربة المستخدم وزيادة زمن الاستجابة. إليك 3 نصائح مُثبتة عملياً لتقليل ذلك:

تصنيف حالات الفشل وتتبع التكاليف

بالنسبة لبيئات الإنتاج، نوصي ببناء نظام سجل لتصنيف حالات الفشل:

• اعتراض الطبقة 1 (Layer 1): يُصنف كـ "مخاطر الموجه"، لا يتم إعادة المحاولة، ويُطلب من المستخدم التعديل.
• اعتراض الطبقة 2 (Layer 2): يُصنف كـ "تعارض في السياسات"، لا يتم إعادة المحاولة، ويُطلب من المستخدم تغيير المحتوى.
• رسالة الإنهاء (finishMessage) بدون تكلفة: يُصنف كـ "حدود قدرات النموذج"، تتم إعادة الكتابة تلقائياً ثم إعادة المحاولة مرة واحدة.
• مشاكل الشبكة/انتهاء المهلة: يُصنف كـ "فشل في البنية التحتية"، مع إعادة المحاولة باستخدام التراجع الأسي.

بالإضافة إلى تقارير تفاصيل الاستدعاء واستهلاك الرموز (Tokens) في لوحة تحكم APIYI (apiyi.com)، يمكنك تشخيص ما إذا كانت المشكلة في الموجه أم في قيود النموذج بسرعة، مما يساعد في الحفاظ على متوسط تكلفة الصورة الواحدة ضمن نطاق معقول.

ضمان شفافية التكاليف للسيناريوهات المؤسسية

بالنسبة للمستخدمين من المؤسسات، نوصي باتباع الممارسات الثلاث التالية لضمان شفافية التكاليف:

• مطابقة السجلات المزدوجة: التحقق المتبادل بين سجلات الاستخدام المحلية وسجلات منصة APIYI.
• تنبيهات الميزانية: تعيين سقف للميزانية اليومية في لوحة تحكم APIYI (apiyi.com)، مع إيقاف مفتاح الـ API تلقائياً عند تجاوزه.
• عزل المفاتيح حسب الأقسام: استخدام مفاتيح API مستقلة لكل خط عمل لتقدير التكاليف بشكل منفصل.
• التدقيق الشهري: فحص عينة تتراوح بين 10-20 سجل فشل شهرياً للتأكد من توافق الخصم مع القواعد الرسمية.

الأسئلة الشائعة حول خصم الرسوم عند فشل طلبات API لنموذج Nano Banana 2

س1: عند رفض طلب توليد صور بطاقات الهوية بواسطة Nano Banana 2، كم سيتم خصمه من الرصيد؟

لا يتم خصم أي شيء تقريباً. عادةً ما يأتي رد الرفض مع finishReason: IMAGE_SAFETY؛ في هذه الحالة، يتم احتساب تكلفة ضئيلة جداً لرموز (tokens) الإدخال فقط (عادةً < 0.001 دولار)، بينما لا يتم احتساب أي تكلفة على رموز إخراج الصور. عند الاستدعاء عبر خدمة وكيل API من APIYI (apiyi.com)، تقوم المنصة بنقل بيانات الاستخدام الرسمية كما هي، وتكون مبالغ الخصم مطابقة تماماً لما تعتمده Google رسمياً.

س2: ماذا يعني ظهور عبارة "You will not be charged for this request" في الرد؟

هذا هو إقرار بعدم المحاسبة صادر مباشرة من Google ضمن finishMessage. عندما يحتوي نص الرد على هذه العبارة، فإن الطلب بأكمله مجاني تماماً، بغض النظر عن طول المدخلات أو ما إذا كان قد تم إجراء استنتاج بواسطة النموذج. تقوم منصة APIYI بالتعرف على هذه العلامة وتسجيلها كعملية بصفر تكلفة، ولن تواجه مشكلة "تقول Google أنها مجانية بينما يتم خصمها سراً".

س3: هل تؤدي إعادة المحاولة عند فشل طلبات Nano Banana 2 إلى تراكم التكاليف؟

تُحاسب كل محاولة إعادة كطلب مستقل، ولكن نظراً لأن الفشل بحد ذاته لا يخصم شيئاً أو يخصم مبلغاً ضئيلاً جداً، فإن التكلفة التراكمية لـ 3 محاولات إعادة غالباً ما تكون أقل من 10% من تكلفة استدعاء ناجح واحد. يُنصح بإضافة خوارزمية "التراجع الأسي" (Exponential Backoff) لمنطق إعادة المحاولة لتجنب تجاوز حدود المعدل (429) بسبب الفشل المتكرر.

س4: ما الفرق بين اعتراضات الطبقة الأولى (Layer 1) والطبقة الثانية (Layer 2) من حيث التكلفة؟

يحدث اعتراض الطبقة الأولى قبل استنتاج النموذج، وعادة لا يتم خصم أي رسوم؛ بينما يحدث اعتراض الطبقة الثانية بعد استنتاج النموذج ولكن قبل الإخراج، حيث يتم خصم تكلفة ضئيلة لرموز الإدخال فقط دون رموز الإخراج. كلاهما يقع ضمن فئة "التكاليف المهملة".

س5: لماذا يذكر بعض المطورين أن "Gemini 3.1 Pro لا يزال يخصم رسوماً عند الرفض الأمني"؟

هذه حالة خاصة: بعض نماذج النصوص من Gemini 3.1 Pro (لاحظ أنه ليس نموذج الصور Nano Banana 2) تقوم عند رفض الموجه (prompt) غير الآمن بإدراج موجه أمني خفي وإكمال عملية الاستنتاج بالكامل، مما يؤدي إلى احتساب الرموز. نموذج Nano Banana 2 (Gemini 3.1 Flash Image) لا يقوم بهذا السلوك حالياً، وتظل تكلفة الفشل في سيناريوهات الصور "صفراً تقريباً".

س6: هل الاستدعاء عبر APIYI (apiyi.com) أغلى من الاستدعاء المباشر من Google؟

لا. تعتمد المنصة نظام تسعير الرموز المعتمد رسمياً، وغالباً ما نقدم خصومات على الكميات لنماذج الطلب العالي مثل Nano Banana 2، مما يجعل السعر الفعلي غالباً أقل من الاستدعاء المباشر. والأهم من ذلك: توفر المنصة الدفع المباشر بالعملة المحلية وفواتير متوافقة، مما يغني الشركات المحلية عن عناء التعامل مع أسعار الصرف، بطاقات الائتمان، أو الكيانات الخارجية.

س7: كيف يمكنني تحديد ما إذا كان الفشل "يخصم رسوم إدخال" أم "مجاني تماماً"؟

يمكنك تحليل الحقول الثلاثة في الرد:

• إذا كان finishMessage يحتوي على "You will not be charged" ← مجاني تماماً.
• إذا ظهر blockReason: SAFETY في promptFeedback ← خصم ضئيل جداً أو مجاني.
• إذا كان finishReason: IMAGE_SAFETY / OTHER ← يتم خصم تكلفة ضئيلة جداً لرموز الإدخال فقط.

في صفحة تفاصيل الاستدعاء داخل لوحة تحكم APIYI (apiyi.com)، يتم تحديد ما إذا كان كل استدعاء قد أدى إلى خصم فعلي، دون الحاجة للتحليل اليدوي.

س8: ما هو معدل فشل Nano Banana 2 تقريباً؟

وفقاً لبيانات المجتمع المتاحة للربع الأول من 2026، يبلغ معدل الفشل الإجمالي للموجهات (prompts) المختلطة بين العربية والإنجليزية حوالي 5%-8%، حيث تمثل "إخفاقات السياسات" في الطبقة الثانية حوالي 2%-3%، بينما تعود معظم الحالات الأخرى إلى مشاكل في جودة الموجه تؤدي إلى رفض finishMessage المجاني. هذا يعني أن أكثر من 99% من تكاليف الطلبات الفاشلة هي صفر أو قريبة من الصفر، ولا تؤثر على سير العمل.

س9: هل تُحتسب الطلبات الفاشلة ضمن حدود المعدل (RPM / TPM)؟

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

الخلاصة: فشل API لنموذج Nano Banana 2 لا يكلفك شيئاً، جرب بثقة

بالعودة إلى السؤال الأساسي—هل يخصم API لنموذج Nano Banana 2 رسوماً عند فشل توليد الصور؟ الإجابة واضحة: في جميع سيناريوهات الفشل تقريباً، لا يتم خصم أي رسوم أو يتم خصم مبلغ ضئيل جداً لرموز الإدخال، خاصة عند ظهور finishReason: IMAGE_SAFETY أو احتواء finishMessage على عبارة "You will not be charged for this request"، وهما حالتان تلتزم فيهما Google رسمياً بـ صفر تكلفة.

هذا يعني للمطورين 3 أمور:

1. إمكانية التجربة بثقة: سواء كنت تستكشف تقنيات كتابة الموجهات، أو تتحقق من جودة الأنماط، أو تجرب سيناريوهات معقدة، فإن تكلفة الفشل تكاد تكون صفراً.
2. لا حاجة لآليات طوارئ معقدة: لا داعي لتصميم منطق خاص للتعامل مع "تكاليف الفشل"، يكفي استخدام نمط try/retry القياسي.
3. الفواتير قابلة للتنبؤ: المصاريف الشهرية تعادل تقريباً عدد الصور الناجحة × تكلفة الصورة الواحدة، ويمكن اعتبار جزء الفشل خطأ تقريبياً لا يُذكر.

بالطبع، عدم الخصم عند الفشل لا يعني "إعادة المحاولة بلا حدود"—فإعادة المحاولة تستهلك من حصة حدود المعدل وتزيد من وقت انتظار المستخدم. النهج الأفضل هو: تصنيف الفشل، ثم اتخاذ الإجراء المناسب—اعتراضات الطبقة الأولى/الثانية تتطلب تنبيه المستخدم لتعديل الموجه، بينما الرفض المجاني (finishMessage) يمكن التعامل معه بإعادة صياغة الموجه تلقائياً. من خلال سجلات الاستدعاء وتنبيهات الميزانية في APIYI (apiyi.com)، يمكنك جعل تكاليف خدمة توليد الصور شفافة ومرئية بدقة تصل إلى مستوى الدقيقة.

إذا كنت تقيم استخدام Nano Banana 2 أو Nano Banana Pro في بيئة الإنتاج، ننصحك بفتح حساب تجريبي عبر منصة APIYI (apiyi.com) وتجربة سيناريوهات الفشل الثلاثة المذكورة أعلاه باستخدام الموجهات الخاصة بك، فبيانات الفواتير الفعلية هي الدليل الأكثر إقناعاً.

الكاتب: فريق APIYI — متخصصون في خدمات وكيل API لنماذج الذكاء الاصطناعي الكبيرة وخدمات توليد الصور من سلسلة Nano Banana.