إنشاء ردّ محادثة
يولّد رداً على قائمة رسائل. يعمل مع النماذج النصية ومع optes-vision-1، وهو الشكل الذي تعرفه أغلب الحِزم والأدوات.
النماذج: optes-1.0، optes-1.0-mini، optes-code-1، optes-vision-1
معاملات الطلب
application/jsonmodelstringمطلوبمعرّف النموذج، مثل
optes-1.0أوoptes-1.0-mini.messagesarrayمطلوبالرسائل بالترتيب. لكل رسالة
role(systemأوuserأوassistantأوtool) وcontent: نصٌ، أو أجزاء نص وصورة.max_tokensintegerاختياريأقصى عدد رموز في الرد. الافتراضي أقصى ما يسمح به النموذج.
temperaturenumberاختياريمن 0 إلى 2. الأقل أكثر ثباتاً. الافتراضي 1.
streambooleanاختياريإن كانت
trueيصل الرد قطعاً بصيغة Server-Sent Events.toolsarrayاختياريالدوال التي يمكن للنموذج استدعاؤها، بمخطط JSON Schema لمعاملاتها.
tool_choicestring | objectاختياريautoأوnoneأوrequired، أو دالة بعينها.response_formatobjectاختياري{"type": "json_schema", ...}لرد يلتزم بمخطط.reasoning_effortstringاختياريلـ
optes-1.0وoptes-code-1:lowأوmediumأوhigh.
يرجع
كائن chat.completion، أو سلسلة قطع chat.completion.chunk مع stream. وقيمة finish_reason واحدة من stop وlength وtool_calls وcontent_filter.
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);{ "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} }}الأسعار بالدولار الأمريكي، وهي أوّلية حتى الإطلاق. الواجهة البرمجية والتسجيل والمفاتيح تُفتح يوم الإطلاق.