توليد النص
أرسل رسائل، واحصل على رد. من سؤالٍ واحد إلى محادثة طويلة بتعليمات نظام، ومن رد حر إلى 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": "اقترح ثلاثة أسماء لمقهى في الكرادة"} ] }'import osfrom openai import OpenAIclient = OpenAI(base_url="https://api.optes3.com/v1", api_key=os.environ["OPTES_API_KEY"])resp = client.chat.completions.create( model="optes-1.0-mini", messages=[ {"role": "system", "content": "أجب باختصار."}, {"role": "user", "content": "اقترح ثلاثة أسماء لمقهى في الكرادة"}, ],)print(resp.choices[0].message.content)import OpenAI from "openai";const client = new OpenAI({ baseURL: "https://api.optes3.com/v1", apiKey: process.env.OPTES_API_KEY });const resp = await client.chat.completions.create({ model: "optes-1.0-mini", messages: [ { role: "system", content: "أجب باختصار." }, { role: "user", content: "اقترح ثلاثة أسماء لمقهى في الكرادة" }, ],});console.log(resp.choices[0].message.content);الأدوار وتعليمات النظام
لكل رسالة دور: system يحدد السلوك والأسلوب، وuser ما يكتبه المستخدم، وassistant ردود النموذج السابقة. للمحادثة متعددة الأدوار، أرسل الرسائل كلها بالترتيب في كل طلب.
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"} }'resp = client.responses.create( model="optes-1.0", input="اكتب خطة اختبار لتطبيق حجوزات عيادة", reasoning={"effort": "high"}, # low | medium | high)print(resp.output_text)const resp = await client.responses.create({ model: "optes-1.0", input: "اكتب خطة اختبار لتطبيق حجوزات عيادة", reasoning: { effort: "high" },});console.log(resp.output_text);المخرجات المنظّمة
مع 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}const resp = await 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"], }, }, },});الكاش
يعمل تلقائياً. إذا بدأ طلبك بالنص نفسه الذي بدأ به طلبٌ قريب، يُقرأ هذا الجزء من الكاش ويُحسب بعُشر سعر الدخل، ويظهر عدده في usage.prompt_tokens_details.cached_tokens.
- ضع الثابت أولاً (تعليمات النظام، ملفات المشروع) والمتغيّر أخيراً.
- يبدأ الكاش من 1,024 رمزاً مشتركاً، ويبقى دقائق بعد آخر استعمال.
- الكاش منفصل لكل مشروع، ولا يراه غيرك، ولا يُحسب من حد الرموز في الدقيقة.
الأسعار بالدولار الأمريكي، وهي أوّلية حتى الإطلاق. الواجهة البرمجية والتسجيل والمفاتيح تُفتح يوم الإطلاق.