Ciyo · GPT-6
دليل GPT-6 Astra API للتطبيقات الإبداعية
معرّف GPT-6 Astra الموثّق في API هو gpt-6-astra. توصي إرشادات OpenAI ببناء التطبيقات عليه عبر Responses API، وتذكر صفحة النموذج دعم Responses وChat Completions وBatch. وإذا كان منتجك يحوّل الموجزات إلى صور أو تخطيطات أو نصوص، فأبرز ما يهمك هو التحكم في الاستدلال وأداة الصور المدمجة وشرائح الأسعار.
يعكس هذا الدليل وثائق OpenAI للمطورين بتاريخ 7 سبتمبر 2026. وهو موجّه إلى من يبنون أدوات إبداعية، لذلك يتناول أداة توليد الصور والتكلفة لكل مادة إنتاجية بتفصيل أكبر من البنية العامة للوكلاء. راجع الصفحات المرتبطة قبل إطلاق المنتج؛ فالمعاملات والأسعار المذكورة تمثل حالة الخدمة في تاريخ محدد.
تحقّق من الوصول قبل كتابة الشفرة
الوصول إلى API منفصل عن اشتراك ChatGPT. لا تمنح خطة Plus أو Pro رصيد API، ولا يفتح مفتاح API الوصول إلى GPT-6 Pro في Chat. تأكد من ظهور gpt-6-astra للمؤسسة والمشروع اللذين سيتحملان تكلفة الطلبات، ثم أرسل طلبًا نصيًا صغيرًا قبل إضافة ملفات أو أدوات أو سياق كبير.
تزداد حدود المعدل بحسب مستوى الاستخدام. تذكر صفحة النموذج 500 طلب و500,000 رمز في الدقيقة عند Tier 1، وصولًا إلى 15,000 طلب و40,000,000 رمز في الدقيقة عند Tier 5. ينبغي ضبط حجم أي مهمة تولّد تنويعات لكتالوج كامل وفق هذه الأرقام، أو نقلها إلى نقطة نهاية Batch عندما لا تكون سرعة الاستجابة مهمة.
الطلب الأول
اضبط model على gpt-6-astra في طلب Responses API، ومرّر توجيهك عبر input. توصي الإرشادات باستخدام Responses API لأن Chat Completions لا يدعم استدعاء الأدوات مع هذا النموذج. يُضبط الاستدلال بواسطة reasoning.effort في Responses، أو reasoning_effort في Chat Completions إن كنت مضطرًا إلى الاستمرار في استخدامه.
يدعم Astra مستويات الجهد low وmedium وhigh وxhigh وmax. ولا يدعم none أو minimal؛ لذا ينبغي عند نقل إعداد من طلب GPT-5.6 كان يستخدم أحدهما البدء بمستوى low ثم مقارنة النتائج. احذف temperature وtop_p وtop_logprobs وlogprobs؛ فإرشادات النموذج تدرجها ضمن المعاملات الواجب إزالتها عند الانتقال إلى Astra.
| الحقل | القيمة | السبب |
|---|---|---|
| model | gpt-6-astra | الإصدار المحدد الوحيد الموثّق |
| input | موجزك نصيًا، مع صور عند الحاجة | إدخال النصوص والصور مدعوم |
| reasoning.effort | low أو medium أو high أو xhigh أو max | لا يدعم none أو minimal |
| tools | [{ type: "image_generation" }] عند الحاجة | يضيف أداة التصيير إلى الجولة |
| temperature, top_p, logprobs | احذفها | مدرجة ضمن المعاملات الواجب إزالتها |
اختر مستوى الجهد المناسب لكل مهمة إبداعية
يربط دليل الاستدلال من OpenAI مستوى low بكتابة المسودات والأعمال التنفيذية، وmedium بالبحث والعمل على جداول البيانات والعروض التقديمية، وhigh بالاستدلال الصعب والتخطيط المتعمق، وxhigh أو max بالمهام الطويلة التي تتقدم فيها الجودة على زمن الاستجابة. وهذا يتناسب مع التطبيقات الإبداعية: low للنصوص البديلة وتنويعات التعليقات المصاحبة، وmedium لموجز حملة، وhigh لخطة متعددة المواد ذات قيود متعارضة.
الجهد وسيلة للتحكم في التكلفة أيضًا. لا تظهر رموز الاستدلال في الرد، لكنها تُفوتر كرموز إخراج بسعر 50 دولارًا لكل مليون، وتشغل مساحة من نافذة السياق. يعرضها كائن الاستخدام ضمن output_tokens_details.reasoning_tokens. سجّل هذا الحقل لكل طلب؛ فهو يوضح لماذا قد تختلف تكلفة طلبين كثيرًا رغم تشابه الردين الظاهرين.
استدعِ أداة توليد الصور
أضف tools: [{ type: "image_generation" }] إلى الطلب وصف الصورة في input. يخطط Astra للصورة ويستدعي الأداة؛ ويتضمن الرد عنصر إخراج من النوع image_generation_call يحتوي حقل result فيه على الصورة بترميز base64. تقبل الأداة size وquality بالقيم low أو medium أو high، وformat وcompression وbackground، وحقل action بالقيم auto أو generate أو edit، وحقل partial_images من 1 إلى 3 لمعاينات متدفقة.
يتولى GPT Image 2 تصيير البكسلات، وليس Astra، وتُفوتر وفق أسعار نموذج الصور القياسية: 30 دولارًا لكل مليون رمز إخراج صور، و8 دولارات لكل مليون رمز إدخال صور، و5 دولارات لكل مليون رمز إدخال نصي. ولتعديل لاحق، مرّر previous_response_id أو أدرج استدعاء image_generation_call السابق في المدخلات حتى تحتفظ أداة التصيير بالصورة الأصلية مرجعًا.
الأدوات غير المتزامنة والتوجيه أثناء الجولة
يقدّم Astra استدعاءات دوال غير متزامنة. علّم الدالة بالقيمة async: true ليواصل النموذج العمل بينما تنفّذ شفرتك الأداة، ثم أعد النتيجة مع call_id الأصلي عندما تصبح جاهزة. يناسب ذلك في التطبيقات الإبداعية الخطوات البطيئة، مثل تصيير معاينة فيديو أو جلب مكتبة كبيرة من المواد.
يتيح التوجيه أثناء الجولة إرسال تحديث عبر WebSocket بينما تعمل المهمة؛ وتحافظ Responses API على العمل المكتمل وتطبّق التصحيح. ويغيّر عنصر الإدخال configuration_update جهد الاستدلال أثناء المحادثة دون إعادة كتابة التوجيه، فتظل مقدمته المخزنة مؤقتًا صالحة. توثّق الإرشادات الميزتين بوصفهما جديدتين مع Astra، وتتطلب كل منهما تنفيذًا داخل تطبيقك.
تعرّف على شرائح الأسعار الأربع
تكلف المعالجة القياسية 10 دولارات لكل مليون رمز إدخال، ودولارًا واحدًا للإدخال المخزن مؤقتًا، و12.50 دولارًا للكتابة إلى الذاكرة المؤقتة، و50 دولارًا للإخراج. وإذا تجاوزت المدخلات 272,000 رمز، يُفوتر الطلب وفق شريحة السياق الطويل: 20 دولارًا للإدخال، ودولاران للمخزن مؤقتًا، و25 دولارًا للكتابة إلى الذاكرة المؤقتة، و75 دولارًا للإخراج. أما الوضع السريع، الذي تصفه OpenAI بأنه أسرع بما يصل إلى الضعف، فيضاعف الأسعار القياسية إلى 20 دولارًا للإدخال و100 دولار للإخراج.
تخفض نقطة نهاية Batch الأسعار القياسية إلى النصف لطلبات السياق القصير: 5 دولارات للإدخال، و0.50 دولار للمخزن مؤقتًا، و6.25 دولارات للكتابة إلى الذاكرة المؤقتة، و25 دولارًا للإخراج. ويُعد توليد تنويعات النصوص ليلًا، أو النصوص البديلة لمكتبة صور، أو موجزات لمراجعة الغد، من الاستخدامات الملائمة ل Batch. لا يتوفر الوضع السريع مع إقامة البيانات في الاتحاد الأوروبي، حيث توصي الإرشادات باستخدام الوضع القياسي.
| الشريحة | الإدخال | الإدخال المخزن مؤقتًا | الإخراج |
|---|---|---|---|
| قياسي، حتى 272 ألف رمز إدخال | $10 | $1 | $50 |
| سياق طويل، أكثر من 272 ألف رمز إدخال | $20 | $2 | $75 |
| الوضع السريع | $20 | $2 | $100 |
| المعالجة الدفعية Batch | $5 | $0.50 | $25 |
خزّن الأجزاء المتكررة مؤقتًا
تعيد معظم الطلبات الإبداعية استخدام قسم خاص بالهوية التجارية، يشمل النبرة والادعاءات الممنوعة وقواعد الألوان وحقائق المنتج. ضع هذا القسم في بداية المدخلات حتى تتطابق المقدمة المخزنة مؤقتًا بين الطلبات. يستبدل Astra المعامل القديم prompt_cache_retention بالمعامل prompt_cache_options.ttl، وتستخدم الإرشادات القيمة 30m لنافذة تخزين مؤقت مدتها نصف ساعة.
يبلغ سعر الرموز المخزنة مؤقتًا دولارًا واحدًا بدلًا من 10 دولارات لكل مليون، لذا يكلف قسم هوية تجارية من 15,000 رمز مبلغ 0.015 دولار عند إعادة استخدامه بدلًا من 0.15 دولار. وتُفوتر الكتابة إلى الذاكرة المؤقتة بسعر 12.50 دولارًا لكل مليون، ولهذا ينبغي أن يكون القسم نصًا ثابتًا لا توجيهًا يتغير مع كل طلب. اعرض الرموز المخزنة مؤقتًا منفصلة في تحليلاتك؛ فهي الوسيلة الأقل تكلفة لتحسين الاتساق.
التكلفة لكل مادة معتمدة
يكلف طلب موجز يحتوي على 20,000 رمز إدخال غير مخزن مؤقتًا و4,000 رمز إخراج مبلغ 0.40 دولار بالأسعار القياسية. وإضافة 10,000 رمز استدلال تزيد بند الإخراج بمقدار 0.50 دولار. وإذا أضفت صورة واحدة عالية الجودة، تُضاف تكلفة رموز أداة التصيير نفسها. التكلفة لكل مادة معتمدة هي الرقم الذي يحدد جدوى سير العمل، وليس تكلفة الاستدعاء وحده.
تتبّع أربعة بنود لكل مادة: إدخال Astra، وإخراج Astra بما فيه الاستدلال، ورموز الصور، وعدد المحاولات حتى الاعتماد. فقد يتجاوز مستوى جهد أرخص يحتاج إلى ثلاث محاولات تكلفة مستوى أعلى يحتاج إلى محاولة واحدة. وهذا هو أسلوب الحساب نفسه الذي تطبقه Ciyo على أرصدتها، حيث يظهر سعر كل عملية توليد قبل تشغيلها.
ما لا تمنحه لك API
لا يخرج Astra صورًا مباشرة؛ فكل صورة تأتي عبر أداة الصور أو أداة تصيير أخرى. ولا يوجد مستوى جهد none أو تحكم في temperature أو انتقال تلقائي إلى بديل إذا أرسلت معاملًا غير مدعوم. أما GPT-6 Pro، وهو الخيار في ChatGPT، فليس نموذج API منفصلًا؛ إذ تدرج API إصدارًا محددًا واحدًا من gpt-6-astra.
قد توقف فحوص السلامة مهمة أيضًا. يذكر منشور الإطلاق من OpenAI أن المهمة الموقوفة في API تنتهي بدلًا من طلب مراجعتك، لذا ينبغي لتطبيق الإنتاج التعامل بسلاسة مع الرد المنقطع. اجعل حالة الفشل واضحة للمستخدمين، واحتفظ بسجل للطلب الذي أدى إليها.
تابع القراءة
أسئلة حول Astra API
هل تتضمن خطة ChatGPT Plus الوصول إلى Astra عبر API؟
لا. خطط ChatGPT وفوترة API منفصلتان. تتضمن Plus نموذج Astra في ChatGPT Work وCodex مع طرحه تدريجيًا؛ أما استخدام gpt-6-astra عبر API فيُفوتر لمؤسستك بحسب الرموز.
هل أستطيع استخدام Chat Completions بدلًا من Responses؟
تذكر صفحة النموذج دعم Chat Completions للطلبات النصية، لكن إرشادات OpenAI توضح أنه لا يدعم استدعاء الأدوات مع Astra، وتوصي باستخدام Responses API. أداة توليد الصور والدوال غير المتزامنة من ميزات Responses.
هل رموز الاستدلال مجانية؟
لا. تُفوتر رموز الاستدلال كرموز إخراج بسعر الإخراج الخاص بشريحتك، وتشغل مساحة من السياق. يعرضها كائن الاستخدام ضمن output_tokens_details.reasoning_tokens.
جرّب خطوة تصيير الصور دون مفتاح API
ولّد الصور باستخدام GPT Image 2 على لوحة Ciyo، واحتفظ بالمخرجات التي تعتمدها، واستخدم الموجز نفسه عند دمج Astra API في منتجك.