الانتقال إلى المحتوى الرئيسي
أنشئ مفتاح API، وأرسل طلبًا واحدًا إلى POST /v1/responses، واقرأ الرد من output_text.

ابدأ مع وكيل البرمجة

انسخ هذا الموجّه إلى وكيل البرمجة. يحدد لغة مشروعك، ويثبّت حزمة SDK، ويوجّه الوكيل إلى وثائق Phaseo، ويُبقي مفتاحك خارج الشيفرة، ويرسل أول طلب. يعمل إذا كان مشروعك يستخدم Phaseo بالفعل، فإنه يراجع ذلك الإعداد بدلًا من البدء من جديد. phaseo/free من دون رصيد، ويمكنك استبداله بأي معرّف نموذج نصي من النماذج.

موجّه الإعداد لوكيل البرمجة. انسخه أو افتحه في Cursor.

فتح في Cursor
للإعداد يدويًا، اتبع الخطوات أدناه.

1. أنشئ مفتاح API

أنشئ مفتاحًا من لوحة التحكم ضمن الإعدادات -> مفاتيح API، ثم صدّره:
يظهر المفتاح مرة واحدة فقط. يُرسَل في كل طلب بوصفه رمز bearer:
تعامل مع مفتاح API كما تتعامل مع كلمة المرور. أبقِه في شيفرة الخادم ولا تضمّنه أبدًا في متصفح أو تطبيق جوال.

أضف رصيدًا للنماذج المدفوعة

يعمل phaseo/free دون رصيد. أما النماذج المدفوعة مثل openai/gpt-6-astra فتحتاج إلى رصيد في المحفظة:
مع بطاقة محفوظة، يؤكد مالك مساحة العمل أو أحد مسؤوليها عملية الدفع من رابط يصله بالبريد الإلكتروني. ومن دون بطاقة محفوظة، يعيد الأمر رابط دفع يفتحه المالك أو المسؤول ليدفع، ثم تُحفظ البطاقة لعمليات الشحن اللاحقة.

2. أرسل طلبًا نصيًا

POST /v1/responses هي نقطة النهاية الموصى بها لأعمال النصوص الجديدة. تستخدم الأمثلة openai/gpt-6-astra، وهو نموذج مدفوع. للتجربة دون رصيد، استبدله بـ phaseo/free، الذي يختار نموذجًا مجانيًا متاحًا؛ راجع ابدأ باستخدام الموجّه المجاني. لا يحتاج cURL وfetch إلى تثبيت أي شيء. لاستخدام حزمة SDK، ثبّتها أولًا:
راجع صفحة تثبيت TypeScript وPython لمعرفة متطلبات التشغيل وحزم SDK الأخرى.

3. اقرأ الرد

بثّ الرد

استخدم البث لطباعة الرد أثناء توليده. يحتوي الحقل text في كل حدث response.output_text.delta على النص الجديد فقط، لذلك تطبع هذه الحلقة الإجابة مرة واحدة. أما أحداث الإغلاق مثل response.output_text.done فتكرّر نصًا سبق بثّه. راجع البث للاطلاع على قائمة الأحداث الكاملة.

4. استكشف أخطاء الطلب الأول وأصلحها

يسرد مرجع الأخطاء كل رمز خطأ وما يجب فعله حياله.

احصل على إجابات ذات أنواع محددة بدل النص

عندما تحتاج شيفرتك إلى قيمة لا إلى نص نثري، أرسل الأسئلة إلى POST /v1/decisions (تجريبي). تعود كل إجابة بنوع محدد مع الاحتمالات، وبترتيب الأسئلة نفسه. أنواع الأسئلة هي predicate (نعم/لا)، وchoice (أحد خياراتك)، وscore (مستوى على مقياسك).
الاستجابة (القيم توضيحية):
اقرأ answers[0].choice أو answers[1].probability، واستخدم confidence أو probabilities لتحديد عتبتك الخاصة. يسرد مرجع Decisions كل نماذج القرارات وحدودها وأسعارها، وإدخال الصور، والتنسيق الأقدم state مع خرائط الأسئلة المسمّاة (noul وcriteria)، الذي لا يزال يعمل وتتطلبه بعض النماذج.

ولّد فيديو

توليد الفيديو غير متزامن: أنشئ مهمة، واستعلم عن حالتها، ثم نزّل الملف.
لتلقّي webhook بدل الاستعلام المتكرر، راجع المهام غير المتزامنة وWebhooks.

تابع البناء

التكامل مع Gateway

اختر نقطة نهاية وجهّز تكاملًا للإنتاج.

مرجع API

كل حقول الطلب والاستجابة لكل نقطة نهاية.

أمثلة

تطبيقات مبدئية لسير العمل الشائع.

الدعم

احصل على مساعدة في تصحيح الأخطاء والتوجيه وسلوك النماذج.
آخر تعديل في ١٦ نوفمبر ٢٠٢٦