البدء السريع
من المفتاح إلى أول رد في خمس خطوات. إن كنت استعملت واجهة ذكاء اصطناعي من قبل، فغيّر العنوان والمفتاح واسم النموذج، والباقي كما هو.
الواجهة مقفلة حتى الإطلاق. هذه الصفحات تصف
api.optes3.com كما سيعمل يوم الإطلاق. التسجيل وإنشاء المفاتيح والطلبات الحقيقية تُفتح يومها، والتفاصيل قد تتغيّر قبله.أنشئ مفتاحاً يُفتح عند الإطلاق
من لوحة التحكم: أنشئ مشروعاً، ثم مفتاحاً له. يظهر المفتاح كاملاً مرة واحدة، فاحفظه في مدير أسرار. مفاتيح الإنتاج تبدأ بـ
optes-sk-live-ومفاتيح التجربة بـoptes-sk-test-.ضعه في متغيّر بيئة
الأمثلة كلها تقرأ المفتاح من
OPTES_API_KEY، فلا يظهر في الكود.export OPTES_API_KEY="optes-sk-live-..."setx OPTES_API_KEY "optes-sk-live-..."ثبّت المكتبة
الواجهة متوافقة مع الحزمة مفتوحة المصدر
openai، فاستعملها كما هي مع عنواننا الأساسي. ومع curl لا تحتاج شيئاً.pip install openainpm install openai# curl is already on macOS, Linux and Windows 10+أرسل أول طلب
طلب واحد إلى
/v1/chat/completionsبـoptes-1.0:curl https://api.optes3.com/v1/chat/completions \ -H "Authorization: Bearer $OPTES_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "optes-1.0", "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", 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", messages: [ { role: "system", content: "أجب باختصار." }, { role: "user", content: "اقترح ثلاثة أسماء لمقهى في الكرادة" }, ],});console.log(resp.choices[0].message.content);اقرأ الرد
يرجع الرد بصيغة JSON، ومعه عدد الرموز التي تُحسب عليها الفاتورة في
usage:Response{ "id": "chatcmpl_8Qe1", "object": "chat.completion", "created": 1790640000, "model": "optes-1.0", "choices": [{ "index": 0, "message": {"role": "assistant", "content": "1. فنجان الكرادة\n2. ..."}, "finish_reason": "stop" }], "usage": { "prompt_tokens": 24, "completion_tokens": 41, "total_tokens": 65, "prompt_tokens_details": {"cached_tokens": 0} }}
الخطوات التالية
الأسعار بالدولار الأمريكي، وهي أوّلية حتى الإطلاق. الواجهة البرمجية والتسجيل والمفاتيح تُفتح يوم الإطلاق.