واجهة Orkas API وثائق Orkas API اربط إمكانات Orkas للدردشة والبحث والكلام والصور والفيديو بأدواتك الخاصة. ابدأ بالدردشة للعثور على عنوان URL الأساسي ومفتاح API وأسماء النماذج التي تستخدمها معظم تطبيقات الذكاء الاصطناعي.
الدردشة يوفر Chat وResponses ردود النموذج واستدعاءات الدوال المخصصة التي يعالجها تطبيقك؛ وتنتج نقاط نهاية الصور والفيديو الوسائط. لا تبدأ استدعاءات API هذه مهمة Commander في تطبيق سطح المكتب ولا تشغّل وكلاءه تلقائيًا. يعتمد أي تنسيق إضافي بين الوكلاء على سير عمل تطبيقك.
إعدادات الاتصال إذا طلب التطبيق عنوان URL أساسيًا ومفتاح API ونموذجًا، فأدخل القيم التالية.
الإعداد القيمة الوصف Base URLhttps://orkas.ai/v1نسخ
استخدم هذا عنوانًا للخدمة المتوافقة مع OpenAI. API Keyأنشئ مفتاحًا في الحساب الصق المفتاح في حقل مفتاح API داخل التطبيق. modelorkas-llm-1.5نسخ موصى بها
الأنسب للأسئلة والأجوبة اليومية والكتابة والأعمال المكتبية. يشمل DeepSeek V4.1 Flash · GPT-6 Luna · Claude Sonnet 5 · Gemini-3.8 Flash. orkas-llm-1.5-proنسخ
الأنسب للأبحاث والفيديو والبحث والتطوير والمهام المعقدة الأخرى. يشمل GPT-6 Sol · Claude Opus 5.5 · Kimi K3.
Responses موصى بها نقطة النهاية POST https://orkas.ai/v1/responsesنسخ
Responses المصادقة Authorization: Bearer $ORKAS_API_KEYنسخ
معلمات متن الطلب المعلمة النوع مطلوب الوصف modelstring نعم orkas-llm-1.5 أو orkas-llm-1.5-pro.inputstring / array نعم نص أو عناصر المحادثة. reasoningobject لا مستوى استدلال اختياري: low أو medium أو high. toolsarray لا تعريفات دوال الأدوات التي ينفذها تطبيقك. streamboolean لا إرجاع استجابة متدفقة عندما تكون القيمة true. الافتراضي: false.
مثال على الطلب curl https://orkas.ai/v1/responses \
-H "Authorization: Bearer $ORKAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "orkas-llm-1.5",
"input": "Hello",
"reasoning": {"effort": "medium"}
}'Chat نقطة النهاية POST https://orkas.ai/v1/chat/completionsنسخ
Chat المصادقة Authorization: Bearer $ORKAS_API_KEYنسخ
معلمات متن الطلب المعلمة النوع مطلوب الوصف modelstring نعم orkas-llm-1.5 أو orkas-llm-1.5-pro.messagesarray نعم رسائل المحادثة. يحتوي كل عنصر على role وcontent. streamboolean لا إرجاع استجابة متدفقة عندما تكون القيمة true. الافتراضي: false.
مثال على الطلب curl https://orkas.ai/v1/chat/completions \
-H "Authorization: Bearer $ORKAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "orkas-llm-1.5",
"messages": [{"role": "user", "content": "Hello"}]
}'استهلاك الأرصدة بند الفوترة الأرصدة المخصومة وحدة الفوترة orkas-llm-1.5المدخلات 50–100؛ قراءة التخزين المؤقت 5–10؛ إنشاء التخزين المؤقت 62.5–125؛ المخرجات 250–375 لكل مليون رمز للنموذج الأساسي. orkas-llm-1.5-proالمدخلات 200–400؛ قراءة التخزين المؤقت 10–20؛ إنشاء التخزين المؤقت 250–500؛ المخرجات 1,000–1,500 لكل مليون رمز للنموذج الأساسي.
بحث ابحث في الويب وأعِد قائمة موجزة بالنتائج ذات الصلة لتطبيقك.
البحث في الويب نقطة النهاية POST https://orkas.ai/v1/searchنسخ
البحث في الويب المصادقة Authorization: Bearer $ORKAS_API_KEYنسخ
معلمات متن الطلب المعلمة النوع مطلوب الوصف querystring نعم نص البحث، بحد أقصى 128 حرف. max_resultsinteger لا عدد النتائج، من 1 إلى 20. الافتراضي: 8.
مثال على الطلب curl https://orkas.ai/v1/search \
-H "Authorization: Bearer $ORKAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"latest battery research","max_results":8}'استهلاك الأرصدة بند الفوترة الأرصدة المخصومة وحدة الفوترة البحث في الويب 0.5 لكل طلب، لما يصل إلى 20 نتيجة.
الكلام حوّل النص إلى ملف صوتي. اختر معرّف صوت من القائمة أدناه وحدد تنسيق الصوت الذي تحتاج إليه.
عرض قائمة الأصوات نقطة النهاية GET https://orkas.ai/v1/audio/voicesنسخ
عرض قائمة الأصوات المصادقة Authorization: Bearer $ORKAS_API_KEYنسخ
معلمات الطلب لا تتضمن نقطة النهاية هذه معلمات طلب.
مثال على الطلب curl https://orkas.ai/v1/audio/voices \
-H "Authorization: Bearer $ORKAS_API_KEY"معرّفات الأصوات المتاحة معرّف الصوت الاسم اللغة zh_female_vv_uranus_bigttsvivi 2.0 الصينية / الإنجليزية saturn_zh_female_cancan_tob知性灿灿 الصينية saturn_zh_female_keainvsheng_tob可爱女生 الصينية saturn_zh_female_tiaopigongzhu_tob调皮公主 الصينية saturn_zh_male_shuanglangshaonian_tob爽朗少年 الصينية saturn_zh_male_tiancaitongzhuo_tob天才同桌 الصينية zh_female_xiaohe_uranus_bigtts小何 الصينية zh_male_m191_uranus_bigtts云舟 الصينية zh_male_taocheng_uranus_bigtts小天 الصينية en_male_tim_uranus_bigttsTim الإنجليزية en_female_dacey_uranus_bigttsDacey الإنجليزية en_female_stokie_uranus_bigttsStokie الإنجليزية
توليد الكلام نقطة النهاية POST https://orkas.ai/v1/audio/speechنسخ
توليد الكلام المصادقة Authorization: Bearer $ORKAS_API_KEYنسخ
معلمات متن الطلب المعلمة النوع مطلوب الوصف modelstring نعم استخدم orkas-tts-1. inputstring نعم النص المراد تحويله إلى كلام، بحد أقصى 16,384 بايت بترميز UTF-8. voicestring نعم معرّف الصوت من القائمة أعلاه. languagestring لا لغة السرد، مثل zh-CN أو en. يجب أن يدعمها الصوت المحدد؛ وإلا فستُستخدم لغة الصوت الافتراضية. response_formatstring لا mp3 أو wav أو opus أو ogg. الافتراضي: mp3.speednumber لا سرعة الكلام من 0.5 إلى 2.0. الافتراضي: 1.0.
مثال على الطلب curl https://orkas.ai/v1/audio/speech \
-H "Authorization: Bearer $ORKAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model":"orkas-tts-1",
"input":"你好,欢迎使用 Orkas。",
"voice":"zh_female_vv_uranus_bigtts",
"language":"zh-CN",
"response_format":"mp3",
"speed":1.0
}' --output speech.mp3استهلاك الأرصدة بند الفوترة الأرصدة المخصومة وحدة الفوترة عرض قائمة الأصوات 0 لكل طلب توليد الكلام 0.125 لكل ثانية مقدّرة من المخرجات، مع التقريب إلى الأعلى وبحد أدنى ثانية واحدة.
الصور ولّد صورة من وصف، أو قدّم صورًا مرجعية للتحرير. تُعاد صورة واحدة لكل طلب.
توليد صورة نقطة النهاية POST https://orkas.ai/v1/images/generationsنسخ
توليد صورة المصادقة Authorization: Bearer $ORKAS_API_KEYنسخ
معلمات متن الطلب المعلمة النوع مطلوب الوصف promptstring نعم وصف الصورة، بحد أقصى 20,000 حرف. sizestring لا 1k / 1.5k / 2k أو قيمة مدعومة للعرض×الارتفاع. الافتراضي: 1.5k.response_formatstring لا url أو b64_json. الافتراضي: b64_json.reference_imagesarray لا ما يصل إلى أربعة عناوين HTTPS أو عناوين بيانات صور مدعومة للتحرير. asyncboolean لا إرجاع معرّف مهمة عندما تكون القيمة true. يُوصى به لتجنب انتهاء مهلة الطلبات. الافتراضي: false.
مثال على الطلب curl https://orkas.ai/v1/images/generations \
-H "Authorization: Bearer $ORKAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt":"A product photo on a clean studio background",
"size":"1.5k",
"response_format":"url",
"async":true
}'للطلبات الأطول: اضبط "async": true. تعيد واجهة API معرّف مهمة id؛ استخدم عنوان URL للحالة حتى تصبح النتيجة جاهزة.
التحقق من حالة التوليد نقطة النهاية GET https://orkas.ai/v1/images/generations/{id}نسخ
التحقق من حالة التوليد المصادقة Authorization: Bearer $ORKAS_API_KEYنسخ
معلمات المسار المعلمة النوع مطلوب الوصف idstring نعم معرّف المهمة الذي يعيده طلب الإنشاء.
مثال على الطلب curl https://orkas.ai/v1/images/generations/$TASK_ID \
-H "Authorization: Bearer $ORKAS_API_KEY"استهلاك الأرصدة بند الفوترة الأرصدة المخصومة وحدة الفوترة توليد صورة 13–23 رصيدًا / صورة ناتجة + 5 / صورة إدخال 13–23 رصيدًا / صورة ناتجة + 5 / صورة إدخال (≤2.61 MP: 13; >2.61 MP: 23) التحقق من حالة التوليد 0 لكل طلب
الفيديوهات أنشئ فيديو من نص أو وسائط مرجعية. تعمل طلبات الفيديو بصورة غير متزامنة، لذا استخدم معرّف المهمة المُعاد للتحقق من التقدم.
إنشاء فيديو نقطة النهاية POST https://orkas.ai/v1/videosنسخ
إنشاء فيديو المصادقة Authorization: Bearer $ORKAS_API_KEYنسخ
معلمات متن الطلب المعلمة النوع مطلوب الوصف promptstring نعم وصف الفيديو المراد توليده أو تحريره. durationinteger لا 4–15 ثانية. الافتراضي: 5. resolutionstring لا 480p أو 720p أو 1080p. الافتراضي: 720p.qualitystring لا يوازن balanced بين السرعة واستهلاك الأرصدة؛ ويعطي quality الأولوية لجودة التوليد واستقراره. الافتراضي: balanced. يظل Orkas يختار نموذج الفيديو المتوافق تلقائيًا. ratiostring لا 16:9 أو 9:16 أو 1:1 أو 4:3 أو 3:4 أو 21:9. الافتراضي: 16:9.generate_audioboolean لا توليد صوت الفيديو. الافتراضي: true. reference_image_urlsarray لا ما يصل إلى تسعة عناوين HTTPS عامة للصور. reference_video_urlsarray لا ما يصل إلى ثلاثة عناوين HTTPS عامة للفيديوهات. operationstring لا generate أو edit. يتطلب التحرير فيديو مرجعيًا واحدًا على الأقل. الافتراضي: generate.seedinteger لا قيمة ابتدائية اختيارية لتوليد قابل للتكرار.
مثال على الطلب curl https://orkas.ai/v1/videos \
-H "Authorization: Bearer $ORKAS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt":"Camera circles a ceramic lamp in a dark studio",
"duration":5,
"resolution":"720p",
"quality":"balanced",
"ratio":"16:9",
"generate_audio":true
}'التحقق من حالة الفيديو نقطة النهاية GET https://orkas.ai/v1/videos/{id}نسخ
التحقق من حالة الفيديو المصادقة Authorization: Bearer $ORKAS_API_KEYنسخ
معلمات المسار المعلمة النوع مطلوب الوصف idstring نعم معرّف المهمة الذي يعيده طلب الإنشاء.
مثال على الطلب curl https://orkas.ai/v1/videos/$TASK_ID \
-H "Authorization: Bearer $ORKAS_API_KEY"استهلاك الأرصدة بند الفوترة الأرصدة المخصومة وحدة الفوترة balanced · تحويل نص أو صورة إلى فيديو · 480p37 لكل ثانية من المخرجات balanced · تحويل نص أو صورة إلى فيديو · 720p80 لكل ثانية من المخرجات balanced · تحويل نص أو صورة إلى فيديو · 1080p248 لكل ثانية من المخرجات quality · تحويل نص أو صورة إلى فيديو · 480p46 لكل ثانية من المخرجات quality · تحويل نص أو صورة إلى فيديو · 720p100 لكل ثانية من المخرجات quality · تحويل نص أو صورة إلى فيديو · 1080p248 لكل ثانية من المخرجات balanced / quality · تحرير الفيديو أو التوليد باستخدام فيديو مرجعي · 480p2800 1M tokensالفيديو المرجعي: الرموز المفوترة الفعلية تشمل فيديو الإدخال والإخراج والحد الأدنى للاستخدام؛ لا رسوم منفصلة للصور المرجعية balanced / quality · تحرير الفيديو أو التوليد باستخدام فيديو مرجعي · 720p2800 1M tokensالفيديو المرجعي: الرموز المفوترة الفعلية تشمل فيديو الإدخال والإخراج والحد الأدنى للاستخدام؛ لا رسوم منفصلة للصور المرجعية balanced / quality · تحرير الفيديو أو التوليد باستخدام فيديو مرجعي · 1080p3100 1M tokensالفيديو المرجعي: الرموز المفوترة الفعلية تشمل فيديو الإدخال والإخراج والحد الأدنى للاستخدام؛ لا رسوم منفصلة للصور المرجعية التحقق من حالة الفيديو 0 لكل طلب
الأمان والحدود حافظ على سرية مفاتيح API، واستخدم مفاتيح منفصلة للتطبيقات المختلفة، واحذف المفتاح فورًا إذا احتُمل تسرّبه.
أرسل المفتاح في ترويسة الطلب Authorization: Bearer sk-orkas-…. لتجميع استهلاك الأرصدة لمحادثة واحدة، أرسل المعرّف المعتم نفسه في X-Orkas-Conversation-Id ضمن طلباتها. استخدم فقط الحروف والأرقام و- أو _ (بحد أقصى 64 حرفًا)؛ ولا ترسل عنوانًا أو محتوى رسالة. لا تضع مفتاحًا في شيفرة المتصفح أو تطبيق الهاتف، أو عناوين URL، أو السجلات، أو نظام التحكم بالمصادر. أنشئ مفتاحًا منفصلًا لكل تطبيق بحيث يمكن استبداله دون التأثير في الخدمات الأخرى. الحدود لكل مفتاح: 120 طلبًا/دقيقة للدردشة والبحث، و60 للكلام، و30 طلب صور، و10 طلبات فيديو. تسمح عمليات التحقق من الحالة بـ120 طلبًا/دقيقة. إذا كانت الطلبات متكررة أكثر من اللازم، تعيد واجهة API الرمز HTTP 429. انتظر قليلًا قبل المحاولة مجددًا. سجل الأرصدة يُميَّز استخدام API بصورة منفصلة في سجل الأرصدة على موقع Orkas، لتتمكن من تمييزه عن الاستخدام داخل Orkas.