جرّب OPTES
منصّة المطوّرين التوثيق

توليد النص

أرسل رسائل، واحصل على رد. من سؤالٍ واحد إلى محادثة طويلة بتعليمات نظام، ومن رد حر إلى JSON يلتزم بمخطط.

أبسط طلب

curl https://api.optes3.com/v1/chat/completions \  -H "Authorization: Bearer $OPTES_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "optes-1.0-mini",    "messages": [      {"role": "system", "content": "أجب باختصار."},      {"role": "user", "content": "اقترح ثلاثة أسماء لمقهى في الكرادة"}    ]  }'

الأدوار وتعليمات النظام

لكل رسالة دور: system يحدد السلوك والأسلوب، وuser ما يكتبه المستخدم، وassistant ردود النموذج السابقة. للمحادثة متعددة الأدوار، أرسل الرسائل كلها بالترتيب في كل طلب.

Python
resp = client.chat.completions.create(    model="optes-1.0",    messages=[        {"role": "system", "content": "أنت مساعد لعيادة أسنان في بغداد. أجب باختصار وبلهجة مهذّبة."},        {"role": "user", "content": "هل تفتحون يوم الجمعة؟"},        {"role": "assistant", "content": "نفتح الجمعة من 4 إلى 9 مساءً."},        {"role": "user", "content": "وأقدر أحجز أونلاين؟"},    ],    temperature=0.4,    max_tokens=400,)

اختيار النموذج

النموذجمتى تستعمله
OPTES 1.0المهام الصعبة والطويلة والوكلاء.
OPTES 1.0 Miniالمحادثة والتصنيف والتلخيص بكميات كبيرة وبسرعة.
OPTES Code 1البرمجة على مستودع كامل ومراجعة الكود.

عمق الاستدلال

مع OPTES 1.0 وCode 1 يحدد reasoning.effort كم يفكّر النموذج قبل أن يجيب. الأعلى أدقّ في المهام الصعبة، وأبطأ، ويستهلك رموز استدلال تُحسب ضمن الخرج.

curl https://api.optes3.com/v1/responses \  -H "Authorization: Bearer $OPTES_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "optes-1.0",    "input": "اكتب خطة اختبار لتطبيق حجوزات عيادة",    "reasoning": {"effort": "high"}  }'

المخرجات المنظّمة

مع response_format ومخطط JSON Schema يلتزم الرد بالمخطط، فتقرؤه برمجياً دون تنظيف.

resp = client.chat.completions.create(    model="optes-1.0-mini",    messages=[{"role": "user", "content": "استخرج الاسم والمبلغ: فاتورة باسم علي حسن بمبلغ 250 ألف دينار"}],    response_format={        "type": "json_schema",        "json_schema": {            "name": "invoice",            "schema": {                "type": "object",                "properties": {"name": {"type": "string"}, "amount_iqd": {"type": "number"}},                "required": ["name", "amount_iqd"],            },        },    },)# -> {"name": "علي حسن", "amount_iqd": 250000}

الكاش

يعمل تلقائياً. إذا بدأ طلبك بالنص نفسه الذي بدأ به طلبٌ قريب، يُقرأ هذا الجزء من الكاش ويُحسب بعُشر سعر الدخل، ويظهر عدده في usage.prompt_tokens_details.cached_tokens.

  • ضع الثابت أولاً (تعليمات النظام، ملفات المشروع) والمتغيّر أخيراً.
  • يبدأ الكاش من 1,024 رمزاً مشتركاً، ويبقى دقائق بعد آخر استعمال.
  • الكاش منفصل لكل مشروع، ولا يراه غيرك، ولا يُحسب من حد الرموز في الدقيقة.

الأسعار بالدولار الأمريكي، وهي أوّلية حتى الإطلاق. الواجهة البرمجية والتسجيل والمفاتيح تُفتح يوم الإطلاق.