واجهة Orkas API

وثائق Orkas API

اربط إمكانات Orkas للدردشة والبحث والكلام والصور والفيديو بأدواتك الخاصة. ابدأ بالدردشة للعثور على عنوان URL الأساسي ومفتاح API وأسماء النماذج التي تستخدمها معظم تطبيقات الذكاء الاصطناعي.

إنشاء مفتاح API

الدردشة

استخدم تنسيق إكمالات الدردشة المتوافق مع OpenAI في تطبيقات الذكاء الاصطناعي أو أدوات سطر الأوامر أو خدمتك الخاصة.

إعدادات الاتصال

إذا طلب التطبيق عنوان URL أساسيًا ومفتاح API ونموذجًا، فأدخل القيم التالية.

الإعداد	القيمة	الوصف
`Base URL`	`https://orkas.ai/v1`	استخدم هذا عنوانًا للخدمة المتوافقة مع OpenAI.
`API Key`	أنشئ مفتاحًا في الحساب	الصق المفتاح في حقل مفتاح API داخل التطبيق.
`model`	`orkas-llm-1.5`موصى بها	الأنسب للأسئلة والأجوبة اليومية والكتابة والأعمال المكتبية. يشمل DeepSeek V4.1 Flash · GPT-6 Luna · Claude-Sonnet-5 · Gemini-3.8 Flash.
`model`	`orkas-llm-1.5-pro`	الأنسب للأبحاث والفيديو والبحث والتطوير والمهام المعقدة الأخرى. يشمل GPT-6 Sol · Claude Opus 5.5 · Kimi K3.

إنشاء إكمال دردشة

نقطة النهاية

POST

https://orkas.ai/v1/chat/completions

إنشاء إكمال دردشة

المصادقة

Authorization: Bearer $ORKAS_API_KEY

معلمات متن الطلب

المعلمة	النوع	مطلوب	الوصف
`model`	string	نعم	`orkas-llm-1.5` أو `orkas-llm-1.5-pro`.
`messages`	array	نعم	رسائل المحادثة. يحتوي كل عنصر على `role` و`content`.
`stream`	boolean	لا	إرجاع استجابة متدفقة عندما تكون القيمة `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`	المدخلات 20–280؛ قراءة التخزين المؤقت 2–28؛ إنشاء التخزين المؤقت 25–350؛ المخرجات 120–1,260	لكل مليون رمز؛ يعتمد السعر الدقيق على الطلب.
`orkas-llm-1.5-pro`	المدخلات 140–1,000؛ قراءة التخزين المؤقت 14–100؛ إنشاء التخزين المؤقت 175–1,250؛ المخرجات 840–4,500	لكل مليون رمز؛ يعتمد السعر الدقيق على الطلب.

بحث

ابحث في الويب وأعِد قائمة موجزة بالنتائج ذات الصلة لتطبيقك.

البحث في الويب

نقطة النهاية

POST

https://orkas.ai/v1/search

البحث في الويب

المصادقة

Authorization: Bearer $ORKAS_API_KEY

معلمات متن الطلب

المعلمة	النوع	مطلوب	الوصف
`query`	string	نعم	نص البحث، بحد أقصى 2,000 حرف.
`max_results`	integer	لا	عدد النتائج، من 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}'

استهلاك الأرصدة

بند الفوترة	الأرصدة المخصومة	وحدة الفوترة
البحث في الويب	5.6	لكل طلب، لما يصل إلى 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_bigtts`	vivi 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_bigtts`	Tim	الإنجليزية
`en_female_dacey_uranus_bigtts`	Dacey	الإنجليزية
`en_female_stokie_uranus_bigtts`	Stokie	الإنجليزية

توليد الكلام

نقطة النهاية

POST

https://orkas.ai/v1/audio/speech

توليد الكلام

المصادقة

Authorization: Bearer $ORKAS_API_KEY

معلمات متن الطلب

المعلمة	النوع	مطلوب	الوصف
`model`	string	نعم	استخدم `orkas-tts-1`.
`input`	string	نعم	النص المراد تحويله إلى كلام، بحد أقصى 16,384 بايت بترميز UTF-8.
`voice`	string	نعم	معرّف الصوت من القائمة أعلاه.
`language`	string	لا	لغة السرد، مثل `zh-CN` أو `en`. يجب أن يدعمها الصوت المحدد؛ وإلا فستُستخدم لغة الصوت الافتراضية.
`response_format`	string	لا	`mp3` أو `wav` أو `opus` أو `ogg`. الافتراضي: `mp3`.
`speed`	number	لا	سرعة الكلام من 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

معلمات متن الطلب

المعلمة	النوع	مطلوب	الوصف
`prompt`	string	نعم	وصف الصورة، بحد أقصى 20,000 حرف.
`size`	string	لا	`2k` أو `3k` أو `4k` أو قيمة مدعومة للعرض×الارتفاع. الافتراضي: `2k`.
`response_format`	string	لا	`url` أو `b64_json`. الافتراضي: `b64_json`.
`reference_images`	array	لا	ما يصل إلى أربعة عناوين HTTPS أو عناوين بيانات صور مدعومة للتحرير.
`async`	boolean	لا	إرجاع معرّف مهمة عندما تكون القيمة `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":"2k",
    "response_format":"url",
    "async":true
  }'

للطلبات الأطول: اضبط "async": true. تعيد واجهة API معرّف مهمة id؛ استخدم عنوان URL للحالة حتى تصبح النتيجة جاهزة.

التحقق من حالة التوليد

نقطة النهاية

GET

https://orkas.ai/v1/images/generations/{id}

التحقق من حالة التوليد

المصادقة

Authorization: Bearer $ORKAS_API_KEY

معلمات المسار

المعلمة	النوع	مطلوب	الوصف
`id`	string	نعم	معرّف المهمة الذي يعيده طلب الإنشاء.

مثال على الطلب

curl https://orkas.ai/v1/images/generations/$TASK_ID \
  -H "Authorization: Bearer $ORKAS_API_KEY"

استهلاك الأرصدة

بند الفوترة	الأرصدة المخصومة	وحدة الفوترة
توليد صورة	22	لكل صورة مولّدة
التحقق من حالة التوليد	0	لكل طلب

الفيديوهات

أنشئ فيديو من نص أو وسائط مرجعية. تعمل طلبات الفيديو بصورة غير متزامنة، لذا استخدم معرّف المهمة المُعاد للتحقق من التقدم.

إنشاء فيديو

نقطة النهاية

POST

https://orkas.ai/v1/videos

إنشاء فيديو

المصادقة

Authorization: Bearer $ORKAS_API_KEY

معلمات متن الطلب

المعلمة	النوع	مطلوب	الوصف
`prompt`	string	نعم	وصف الفيديو المراد توليده أو تحريره.
`duration`	integer	لا	4–15 ثانية. الافتراضي: `5`.
`resolution`	string	لا	`480p` أو `720p` أو `1080p`. الافتراضي: `720p`.
`quality`	string	لا	يوازن `balanced` بين السرعة واستهلاك الأرصدة؛ ويعطي `quality` الأولوية لجودة التوليد واستقراره. الافتراضي: `balanced`. يظل Orkas يختار نموذج الفيديو المتوافق تلقائيًا.
`ratio`	string	لا	`16:9` أو `9:16` أو `1:1` أو `4:3` أو `3:4` أو `21:9`. الافتراضي: `16:9`.
`generate_audio`	boolean	لا	توليد صوت الفيديو. الافتراضي: `true`.
`reference_image_urls`	array	لا	ما يصل إلى تسعة عناوين HTTPS عامة للصور.
`reference_video_urls`	array	لا	ما يصل إلى ثلاثة عناوين HTTPS عامة للفيديوهات.
`operation`	string	لا	`generate` أو `edit`. يتطلب التحرير فيديو مرجعيًا واحدًا على الأقل. الافتراضي: `generate`.
`seed`	integer	لا	قيمة ابتدائية اختيارية لتوليد قابل للتكرار.

مثال على الطلب

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

معلمات المسار

المعلمة	النوع	مطلوب	الوصف
`id`	string	نعم	معرّف المهمة الذي يعيده طلب الإنشاء.

مثال على الطلب

curl https://orkas.ai/v1/videos/$TASK_ID \
  -H "Authorization: Bearer $ORKAS_API_KEY"

استهلاك الأرصدة

بند الفوترة	الأرصدة المخصومة	وحدة الفوترة
`balanced` · تحويل نص أو صورة إلى فيديو · 480p	37	لكل ثانية من المخرجات
`balanced` · تحويل نص أو صورة إلى فيديو · 720p	80	لكل ثانية من المخرجات
`balanced` · تحويل نص أو صورة إلى فيديو · 1080p	248	لكل ثانية من المخرجات
`quality` · تحويل نص أو صورة إلى فيديو · 480p	46	لكل ثانية من المخرجات
`quality` · تحويل نص أو صورة إلى فيديو · 720p	100	لكل ثانية من المخرجات
`quality` · تحويل نص أو صورة إلى فيديو · 1080p	248	لكل ثانية من المخرجات
`balanced` / `quality` · تحرير الفيديو أو التوليد باستخدام فيديو مرجعي · 480p	51	لكل ثانية من المخرجات
`balanced` / `quality` · تحرير الفيديو أو التوليد باستخدام فيديو مرجعي · 720p	109	لكل ثانية من المخرجات
`balanced` / `quality` · تحرير الفيديو أو التوليد باستخدام فيديو مرجعي · 1080p	271	لكل ثانية من المخرجات
التحقق من حالة الفيديو	0	لكل طلب

الأمان والحدود

حافظ على سرية مفاتيح API، واستخدم مفاتيح منفصلة للتطبيقات المختلفة، واحذف المفتاح فورًا إذا احتُمل تسرّبه.

أرسل المفتاح في ترويسة الطلب Authorization: Bearer sk-orkas-….
لتجميع استهلاك الأرصدة لمحادثة واحدة، أرسل المعرّف المعتم نفسه في X-Orkas-Conversation-Id ضمن طلباتها. استخدم فقط الحروف والأرقام و- أو _ (بحد أقصى 64 حرفًا)؛ ولا ترسل عنوانًا أو محتوى رسالة.
لا تضع مفتاحًا في شيفرة المتصفح أو تطبيق الهاتف، أو عناوين URL، أو السجلات، أو نظام التحكم بالمصادر.
أنشئ مفتاحًا منفصلًا لكل تطبيق بحيث يمكن استبداله دون التأثير في الخدمات الأخرى.
الحدود لكل مفتاح: 120 طلبًا/دقيقة للدردشة والبحث، و60 للكلام، و30 طلب صور، و10 طلبات فيديو. تسمح عمليات التحقق من الحالة بـ120 طلبًا/دقيقة.
إذا كانت الطلبات متكررة أكثر من اللازم، تعيد واجهة API الرمز HTTP 429. انتظر قليلًا قبل المحاولة مجددًا.

سجل الأرصدة

يُميَّز استخدام API بصورة منفصلة في سجل الأرصدة على موقع Orkas، لتتمكن من تمييزه عن الاستخدام داخل Orkas.