مفتاح GPT Image 2 API: كيف تحصل عليه وترسل طلبك الأول

نعم، لدى GPT Image 2 واجهة API، وعلى SeedRouter يمنحك مفتاح API واحد الوصول إليها. سجّل الدخول، وأنشئ مفتاحًا في صفحة مفاتيح API، وأضف رصيدًا في صفحة الفوترة، ثم أرسل المفتاح في ترويسة Authorization: Bearer إلى https://api.seedrouter.ai/v1/images/generations. لا يظهر المفتاح كاملًا إلا مرة واحدة عند إنشائه، لذا انسخه مباشرة إلى متغيرات البيئة على خادمك.

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

كيف تحصل على مفتاح GPT Image 2 API؟

1. سجّل الدخول إلى SeedRouter بحساب Google الخاص بك.
2. افتح مفاتيح API وأنشئ مفتاحًا. أعطه اسمًا يدل على مكان تشغيله، مثل production-server.
3. انسخ المفتاح فورًا. بعد هذه الشاشة لن ترى إلا نسخة مخفية منه، والمفتاح المفقود لا يمكن استرجاعه. ألغِه وأنشئ مفتاحًا جديدًا بدلًا منه.
4. أضف رصيدًا في صفحة الفوترة. يعمل المفتاح بمجرد إنشائه، لكن الطلب يحتاج إلى رصيد كي يُنفَّذ.

مفتاح واحد يصل إلى كل النماذج على SeedRouter، فلا تحتاج إلى مفتاح منفصل لـ GPT Image 2 وآخر لـ GPT Image 2.5. أنشئ بدلًا من ذلك مفتاحًا منفصلًا لكل بيئة، وعندها لن يؤدي إلغاء مفتاح بيئة الاختبار إلى تعطيل بيئة الإنتاج.

أين يجب أن يُحفظ مفتاح API؟

على خادمك، في متغير بيئة، ولا مكان غير ذلك:

export SEEDROUTER_API_KEY="your-key"

لا تضع المفتاح أبدًا في JavaScript الخاصة بالمتصفح، ولا في حزمة تطبيق جوال، ولا في مستودع عام. فأي شخص يقرؤه يستطيع إنفاق رصيدك. وإذا كان لمنتجك واجهة أمامية، فاجعلها تستدعي الواجهة الخلفية الخاصة بك، ودع الواجهة الخلفية تستدعي API بالمفتاح.

وإذا تسرّب مفتاح، فألغِه فورًا في صفحة مفاتيح API. يتوقف المفتاح الملغى عن العمل، وتُرفض الطلبات التي تستخدمه.

كيف ترسل أول طلب بالمفتاح؟

أرسل المفتاح بصفته bearer token. الاستجابة مرجع لمهمة، لا الصورة نفسها:

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

احفظ قيمة id من الاستجابة، واستعلم عن GET https://api.seedrouter.ai/v1/tasks/{id} بالترويسة نفسها حتى تصبح قيمة status هي completed. تسرد المهمة المكتملة روابط الصور. ولحلقة كاملة بالشفرة، راجع GPT Image 2 API بلغة Python.

يقدّم معرّفا نموذج GPT Image 2 بالحقول نفسها: يحتسب gpt-image-2 سعرًا ثابتًا واحدًا لكل صورة تُسلَّم، ويحتسب gpt-image-2-official التوكنات التي تبلّغ عنها كل عملية توليد. ويعمل المفتاح مع كليهما. والأسعار الحالية في صفحة النموذج.

ما الأخطاء التي يواجهها مفتاح API الجديد عادةً؟

خطآن بسيطان يسبّبان معظم إخفاقات الطلب الأول. الأول مفتاح لُصق وينقصه حرف أو فيه مسافة زائدة، فيعيد 10001. والثاني نسخ اسم النموذج من عنوان، مثل gpt-image-2.0 أو GPT Image 2، بدلًا من معرّف النموذج، فيعيد 20002. وكلاهما يُرفض قبل بدء أي عمل، فلا يُحتسب شيء.

هل يوجد مفتاح GPT Image 2 API مجاني؟

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

هل يمكن استخدام مفتاح واحد من Python وJavaScript؟

نعم. المفتاح سلسلة نصية في ترويسة HTTP، لذا تستطيع أي لغة ترسل طلب HTTP أن تستخدمه. اقرأه من البيئة في كل بيئة تشغيل: os.environ["SEEDROUTER_API_KEY"] في Python وprocess.env.SEEDROUTER_API_KEY في Node.js. وأبقِ شفرة JavaScript على جانب الخادم؛ فالمفتاح نفسه في شفرة المتصفح مكشوف لكل زائر.

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

هل أحتاج إلى مفتاح OpenAI API لاستخدام GPT Image 2 هنا؟

لا. مفتاح SeedRouter هو بيانات الاعتماد الوحيدة التي ترسلها. ولا تنشئ حسابًا منفصلًا في مكان آخر ولا تديره لاستدعاء GPT Image 2 عبر هذه الـ API.

كم عدد مفاتيح API التي يمكنني إنشاؤها؟

ما يكفي لمفتاح لكل خادم أو خدمة؛ فالحد لكل حساب أعلى بكثير مما يحتاجه أي تكامل. ويمكن إلغاء كل مفتاح على حدة.

أين أرى ما أنفقه المفتاح؟

في سجل الاستخدام. يسرد كل طلب نموذجه وتكلفته، ما يسهّل مقارنة تكامل جديد بتقديرك.

أبقِ المفتاح على الخادم وانطلق

أنشئ مفتاحًا لكل بيئة، واحفظه في متغير بيئة، وأرسله بصفته bearer token من الواجهة الخلفية فقط. وحين يعيد الطلب الأول معرّف مهمة id، يكون جزء الوصول قد اكتمل؛ وكل ما يأتي بعد ذلك تجده في مرجع GPT Image 2 API.