البدء السريع لخطوط أنابيب Sora 2
أنشئ نصًا غير خاضع للرقابة لخطوط أنابيب الفيديو الخاصة بـ Sora 2 باستخدام واجهة برمجة التطبيقات المتوافقة مع OpenAI. يغطي هذا الدليل المقتضب المصادقة، والطلبات الأساسية، والبث المتدفق، واستدعاء الأدوات لتشغيل محرك النص الخاص بك فورًا.
المصادقة وURL الأساسي
تستخدم واجهة برمجة التطبيقات الخاصة بنا مصادقة قياسية متوافقة مع OpenAI. ستحتاج إلى مفتاح API من لوحة التحكم الخاصة بك وURL الأساسي https://api.sora2apis.com/v1. مرر مفتاحك في رأس Authorization كرمز Bearer. يعمل هذا الإعداد مع أي SDK يدعم التوافق مع OpenAI.
سجّل للحصول على حساب للحصول على مفتاحك. تحصل الحسابات الجديدة على رصيد تجريبي مجاني بقيمة $0.50 لمدة 7 أيام، دون الحاجة إلى بطاقة ائتمان. للاستخدام المدفوع، يبدأ شحن الرصيد من $10. يتم إنشاء المفتاح فورًا بعد التسجيل ويمكن تجديده في أي وقت.
curl https://api.sora2apis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
نقطة نهاية إكمال الدردشة
نقطة النهاية الأساسية هي POST /v1/chat/completions. تقبل حقل model مضبوطًا على uncensored، وهو نموذج مفتوح الأوزان مضبوط للإجابة دون رفض المحتوى للاستخدام القانوني للكبار. إنه ليس GPT أو Claude أو أي نموذج آخر من البائعين. يمتلك النموذج نافذة سياق بحجم 100,000 رمز لكل من الموجّه والإكمال.
أرسل مدخلاتك النصية عبر مصفوفة messages. تُعيد الـ API مخرجات نصية جاهزة لخط إنتاج توليد الفيديو الخاص بك. لا توجد قدرات للتضمينات أو توليد الصوت أو توليد الفيديو في نقطة هذه النهاية. إنها تعمل حصرياً على النص مدخلاً ومخرجا.
from openai import OpenAI
client = OpenAI(base_url="https://api.sora2apis.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
استجابات البث المتدفق (SSE)
للحصول على توليد نص في الوقت الفعلي، اضبط stream: true في طلبك. تُرجع واجهة برمجة التطبيقات أحداثًا مرسلة من الخادم (SSE) مما يتيح لك معالجة الرموز بمجرد توليدها. هذا مفيد للسيناريوهات الطويلة أو التسميات حيث تريد عرض التقدم أو تغذية البيانات تدريجيًا.
يحتوي كل حدث SSE على جزء جزئي من الاستجابة. اجمع هذه الأجزاء الجزئية لإعادة بناء النص الكامل. تتبع استجابة البث المتدفق تنسيق SSE القياسي الخاص بـ OpenAI، مما يضمن التوافق مع معظم الـ SDKs الحديثة. هذا مثالي لتوليد المحتوى الديناميكي في سير عمل Sora 2 الخاص بك.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
استدعاء الأدوات والدوال
تدعم واجهة برمجة التطبيقات استدعاء الأدوات والدوال، مما يتيح لك تعريف دوال مخصصة لاستخدامها بواسطة النموذج الخاص بك. هذا قيم لاستخراج البيانات المهيكلة أو اتخاذ القرارات الآلية داخل خط أنابيب النص الخاص بك. عرّف أدواتك في مصفوفة tools وحدد كيفية استجابة النموذج.
سيرجع النموذج استدعاءات الأدوات عند الاقتضاء، والتي يمكنك بعدها تنفيذها وإعادتها إلى المحادثة. يتيح ذلك سير عمل معقد حيث يمكن لمحرك النص التفاعل مع الأنظمة الخارجية أو تنسيق البيانات بدقة لاحتياجات توليد الفيديو الخاصة بك. إنها ميزة قوية لخطوط أنابيب Sora 2 المتقدمة.
حدود المعدل والاستخدام
أنت مقيد بـ 300 طلب في الدقيقة لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 ميجابايت. إذا تجاوزت حدّ المعدل، ستتلقى خطأ 429. تأكد من معالجة إعادة المحاولة بشكل مناسب. يحصل كل حساب على مفتاح API واحد، يمكن تجديده في أي وقت، مما يؤدي إلى إلغاء صلاحية المفتاح القديم.
التسعير هو $0.25 لكل مليون رمز إدخال و$1.00 لكل مليون رمز مخرجات. الرصيد مسبق الدفع ولا ينتهي. إذا نفد رصيدك، ستتلقى خطأ 402. المفاتيح غير الصالحة تؤدي إلى خطأ 401. تبدأ الشحنات من $10، مع مكافآت للمبالغ الأكبر.
إعدادات النموذج
معرف النموذج هو دائماً uncensored. إنه نموذج مفتوح الأوزان يعمل على خوادم GPU الخاصة بنا، ومُضبط للمحتوى البالغ القانوني بدون رفض. إنه ليس GPT، Claude، Gemini، Grok، أو DeepSeek. لا يولد النموذج الصوت، الصور، أو الفيديو. هو مخصص لتوليد النصوص فقط.
يمكنك ضبط المعلمات القياسية مثل temperature وmax_tokens للتحكم في المخرجات. حجم نافذة السياق هو 100,000 رمز. يتيح لك هذا المرونة ضبط مخرجات النص بدقة لاحتياجات توليد الفيديو الخاصة بـ Sora 2. صُمم النموذج ليكون محرك نص موثوق لخط الأنابيب الخاص بك.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.sora2apis.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);المواصفات التقنية
كل الحدود والميزات الفعلية للـ API في مكان واحد — راجعها قبل شحن الرصيد.
| البند | القيمة |
|---|---|
| صيغة API | متوافق مع OpenAI: يعمل أي SDK من OpenAI بتغيير base URL والمفتاح فقط |
| معرّف النموذج | uncensored |
| نقاط النهاية | POST /v1/chat/completions · GET /v1/models |
| المصادقة | Authorization: Bearer YOUR_KEY |
| Base URL | https://api.sora2apis.com/v1 |
| البث المتدفق | نعم — server-sent events؛ آخر جزء يتضمن استهلاك الرموز |
| نافذة السياق | 100,000 رمز (المدخلات والمخرجات معاً) |
| أقصى مخرجات | حتى ما تبقى من نافذة 100,000 رمزًا؛ max_tokens اختياري (بلا حد منفصل) |
| المعاملات | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| وضع JSON | response_format: {"type": "json_object"} |
| استدعاء الدوال | نعم — tools و tool_choice؛ الرد يتضمن tool_calls حتى أثناء البث؛ تُرسل النتائج كرسالة role: tool |
| حجم الطلب | حتى 8 MB |
| ترويسات الرد | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| الطلبات المتزامنة | حتى 8 في الوقت نفسه لكل مفتاح |
| حدّ المعدل | 300 طلب في الدقيقة لكل مفتاح |
| الفوترة | رصيد مسبق الدفع حسب الاستهلاك الفعلي؛ الأخطاء والرفض مجانية |
| مكافأة | +5% من $50، +10% من $100 |
| الصلاحية | الرصيد المدفوع لا تنتهي صلاحيته، بدون اشتراك |
| شحن الرصيد | USDT (TRC20) أو USDC (Base)، أي مبلغ صحيح من $10 إلى $500 |
| السعر | $0.25 لكل مليون رمز مدخلات · $1.00 لكل مليون رمز مخرجات |
| رصيد تجريبي مجاني | $0.50 لمدة 7 أيام، بدون بطاقة · مفتاح تجريبي: طلبان متوازيان، 60 طلبًا في الدقيقة؛ الحدود الكاملة (8 و300) بعد أول شحن |
| المفاتيح | مفتاح نشط واحد لكل حساب؛ المفتاح الجديد يحل محل القديم |
| المحتوى | محتوى البالغين مسموح؛ يُرفض أي محتوى جنسي يتعلق بالقاصرين |
| تسجيل الدخول | Google أو البريد الإلكتروني وكلمة المرور |
رموز الأخطاء
تصل الأخطاء بصيغة JSON مع type ثابت؛ الطلبات الفاشلة أو المرفوضة لا تُحتسب.
| الرمز | النوع | المعنى |
|---|---|---|
400 | bad_request | JSON غير صالح أو رسائل فارغة أو معامل خاطئ أو تجاوز نافذة السياق |
401 | missing_key · invalid_key · key_revoked | لا يوجد مفتاح أو المفتاح خاطئ أو تم استبداله |
402 | no_credit | الرصيد فارغ — اشحن وتستأنف الطلبات فوراً |
403 | content_blocked | محتوى جنسي يتعلق بقاصرين — مرفوض دون احتساب |
404 | not_found | نقطة نهاية غير معروفة |
413 | request_too_large | جسم الطلب أكبر من 8 MB |
429 | rate_limited · concurrency | تجاوز 300 في الدقيقة أو 8 متزامنة — انتظر ثم أعد المحاولة |
503 | upstream_busy | النموذج مشغول — أعد المحاولة بعد ثوانٍ |
أسئلة وأجوبة
ما هو حجم نافذة السياق؟
حجم نافذة السياق هو 100,000 رمز، ويشمل كلًا من الموجّه والإكمال. يتيح ذلك إنشاء محتوى طويل مناسب للسيناريوهات والتسميات التفصيلية.
كيف أتعامل مع حدّ المعدل؟
محدود بـ 300 طلب في الدقيقة لكل مفتاح. إذا تجاوزت هذا الحد، ستتلقى خطأ 429. نفّذ استراتيجية التراجع الأسي في تطبيقك للتعامل مع إعادة المحاولة بسلاسة.
هل المحتوى غير خاضع للرقابة حقًا؟
لا يرفض النموذج مواضيع الكبار القانونيين، أو الخيالية، أو أبحاث الأمن، أو المثيرة للجدل. ومع ذلك، يتم حظر محتوى الجنس الذي ينطوي على القاصرين دائمًا. صُمم لحرية الإبداع ضمن الحدود القانونية.
مفتاحك على بُعد نموذج واحد
أنشئ حسابًا، انسخ المفتاح، غيّر URL الأساسي. هذا هو الإعداد بأكمله.
احصل على مفتاح API