مرجع الواجهة
كل نقطة في واجهة OPTES: ما تفعله، ومعاملاتها، ومثال الطلب والرد. للشرح خطوةً خطوة، ابدأ من البدء السريع.
api.optes3.com كما سيعمل يوم الإطلاق. التسجيل وإنشاء المفاتيح والطلبات الحقيقية تُفتح يومها، والتفاصيل قد تتغيّر قبله.العنوان الأساسي
https://api.optes3.com/v1كل الطلبات عبر HTTPS، والأجسام JSON بترميز UTF-8، ما عدا رفع الملفات (multipart/form-data). الواجهة متوافقة مع صيغة المحادثة الشائعة، فتعمل معها الحزمة openai بتغيير العنوان فقط.
المصادقة
أرسل مفتاحك في كل طلب: Authorization: Bearer $OPTES_API_KEY. المفتاح يعود إلى مشروع، وعلى المشروع تُحسب الحدود والإنفاق. التفاصيل في المصادقة والمفاتيح.
النقاط
| النقطة | ما تفعله |
|---|---|
POST /v1/chat/completions | إنشاء ردّ محادثة |
POST /v1/responses | إنشاء ردّ |
POST /v1/images/generations | توليد صورة |
POST /v1/audio/speech | توليد كلام |
POST /v1/audio/transcriptions | تفريغ كلام |
POST /v1/videos | إنشاء فيديو |
POST /v1/music | إنشاء موسيقى |
POST /v1/embeddings | إنشاء تضمين |
POST /v1/rerank | إعادة ترتيب |
POST /v1/moderations | فحص المحتوى |
الفيديو والموسيقى مهام غير متزامنة: ترجع فوراً بمعرّف، ثم تتابع حالتها وتنزّل الملف. والمجسّمات ثلاثية الأبعاد قريباً بلا نقطة حتى الآن.
رؤوس الرد
| الرأس | المعنى |
|---|---|
x-request-id | معرّف فريد للطلب، أرسله مع أي سؤال للدعم. |
x-ratelimit-remaining-requests | الطلبات الباقية في الدقيقة. |
x-ratelimit-remaining-tokens | الرموز الباقية في الدقيقة. |
retry-after | الثواني قبل المحاولة التالية، مع 429. |
الأخطاء
400 للطلب الخاطئ وللمحتوى المحجوب، و401 للمفتاح، و429 للسرعة والحصّة، و5xx من جهتنا. القائمة الكاملة في الأخطاء.
الأسعار بالدولار الأمريكي، وهي أوّلية حتى الإطلاق. الواجهة البرمجية والتسجيل والمفاتيح تُفتح يوم الإطلاق.