الموجهات والنصوص عبر نقطة النهاية

عنوان URL الأساسي والمصادقة

استخدم عنوان URL الأساسي https://api.stableaudio.top/v1 مع أي عميل متوافق مع OpenAI. مرر مفتاح API الخاص بك في رأس Authorization بصيغة Bearer YOUR_API_KEY. يمكنك إنشاء مفتاح على الفور في صفحة الحصول على مفتاح API باستخدام Google أو البريد الإلكتروني وكلمة المرور. يدعم كل حساب مفتاحاً نشطاً واحداً فقط؛ إصدار مفتاح جديد يستبدل المفتاح السابق. تدعم نقطة النهاية POST /v1/chat/completions و GET /v1/models فقط. لا تتوفر هنا عمليات التضمين، أو توليد الصور، أو الصوت، أو الفيديو. هذه طبقة للنصوص فقط لمسار عمل الصوت الخاص بك.

إرسال طلبك الأول

أرسل طلب إكمال محادثة قياسي لتوليد النص. معرف النموذج هو uncensored. إنه نموذج مفتوح الأوزان مضبوط لرفض أقل للمحتوى في المواضيع القانونية للبالغين. يمكنك ضبط معلمات مثل temperature و top_p. للنموذج نافذة سياق بـ 100,000 رمز. يمكنك طلب ما يصل إلى 32,000 رمز لكل استجابة. التسع واضح: $0.15 لكل مليون رمز مدخل و $0.50 لكل مليون رمز مخرج. الأخطاء والرفض لا تستهلك الرصيد.

نسخcurl https://api.stableaudio.top/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."}]
  }'

تكامل SDK Python

استخدم حزمة تطوير البرمجيات (SDK) الخاصة بـ OpenAI للغة Python لدمج واجهة برمجة التطبيقات في نصوصك البرمجية. قم بتعيين base_url و api_key في تكوين العميل الخاص بك. يتيح لك ذلك الاستفادة من مجموعات الأكواد الموجودة التي تستخدم بالفعل واجهة OpenAI. يتعامل العميل مع تسلسل JSON وتحليل الاستجابات تلقائياً. يمكنك استقبال الاستجابات عبر البث المتدفق أو معالجتها في وضع الدفع/التجميع. يعمل هذا النهج لتوليد الموجّهات، أو كتابة النصوص البرمجية، أو استخراج البيانات المهيكلة من مدخلات النص لسير عمل الصوت الخاص بك.

نسخfrom openai import OpenAI

client = OpenAI(base_url="https://api.stableaudio.top/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)

تكامل SDK Node.js

ادمج واجهة برمجة التطبيقات في تطبيقات Node.js الخاصة بك باستخدام حزمة تطوير البرامج (SDK) لـ Node.js من OpenAI. قم بتكوين العميل بعنوان URL الأساسي ومفتاح API الصحيح. يضمن ذلك التوافق مع أنماط OpenAI القياسية. يمكنك إرسال طلبات متزامنة أو غير متزامنة. استخدم هذا لمعالجة النص في الوقت الفعلي في ربط الويب أو المهام الخلفية. تتعامل الحزمة مع منطق إعادة المحاولة وتحليل الاستجابة. هذا مثالي لبناء نصوص التعليق الصوتي أو مسارات التسميات التوضيحية التي تتطلب مخرجات نصية موثوقة وبدون رقابة دون رسوم اشتراك.

نسخimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.stableaudio.top/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);

الاستجابات المتدفقة (SSE)

فعّل البث المتدفق عن طريق تعيين stream: true في طلبك. تُرجع واجهة برمجة التطبيقات أحداث الإرسال من الخادم (SSE). يتم تضمين معلومات استخدام الرموز في الشريحة الأخيرة. يقلل هذا من زمن الاستجابة المُدرَك لتوليد النصوص الطويلة. استخدم هذا للتسميات التوضيحية المباشرة أو تحسين الموجّه التفاعلي. يبقى معرف النموذج uncensored. لا يغير البث المتدفق نموذج التسع. لا تزال تدفع فقط مقابل الرموز المولدة فعلياً. يتم التعامل مع الأخطاء أثناء البث المتدفق بسلاسة دون استهلاك رصيد إضافي.

نسخ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)

حدود الرموز والحصص

يدعم النموذج نافذة سياق بـ 100,000 رمز. الحد الأقصى للإخراج هو 32,000 رمز لكل طلب، أو 2,048 إذا لم يتم تعيين max_tokens. أنت محدود بـ 300 طلب في الدقيقة لكل مفتاح. تم تحديد الحد الأقصى للتزامن بـ 8 طلبات متزامنة لكل مفتاح. يجب ألا تتجاوز أجسام الطلبات 8 ميجابايت. إذا تجاوزت حد المعدل، ستتلقى خطأ 429. إذا كان مفتاحك غير صالح، ستتلقى خطأ 401. إذا لم يكن لديك رصيد مسبق كافٍ، ستتلقى خطأ 402. الأخطاء والرفض مجانية. الرصيد لا ينتهي. اشحن ببطاقة (Visa, Mastercard, Apple Pay, Google Pay) أو بالعملات المشفرة (USDT على TRC20، USDC على Base) من $20 إلى $500.