Suno API: الموجّهات والبرامج النصية عبر نقطة نهاية واحدة

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

تستخدم واجهة برمجة التطبيقات الخاصة بنا مصادقة OpenAI القياسية. تحتاج فقط إلى مفتاح API، والذي يمكنك إنشاؤه في صفحة Get API key. لا يتطلب الأمر رقم هاتف أو بطاقة ائتمان للبدء؛ يتلقى كل حساب جديد رصيدًا تجريبيًا مجانيًا بقيمة $0.50 صالحًا لمدة 7 أيام.

عيّن عنوان URL الأساسي إلى https://api.sunoapis.com/v1 في إعدادات العميل الخاص بك. معرف النموذج الذي يجب إرساله في كل طلب هو uncensored. هذا نموذج مفتوح الأوزان مستضاف على خوادم GPU الخاصة بنا، ومضبوط للاستخدام القانوني للبالغين والإبداعي بدون الرفض المعتاد لدى المزودين الكبار.

• عنوان URL الأساسي: https://api.sunoapis.com/v1
• معرف النموذج: uncensored
• رأس المصادقة: Authorization: Bearer YOUR_API_KEY

الطلب الأول

ابدأ فورًا بطلب إكمال محادثة قياسي. تقبل نقطة النهاية حمولات JSON التي تحتوي على الموجّه الخاص بالنظام، وتعليمات المستخدم، وأي بيانات تعريفية مطلوبة لسلسلة عملك الخاصة بتحويل النص إلى فيديو أو الموسيقى بالذكاء الاصطناعي.

هذه واجهة للنصوص فقط. لا تولد الصوت أو الفيديو أو الصور؛ إنها تولد تعليمات النص التي تقود تلك الأدوات. استخدم نقطة النهاية هذه لكتابة سيناريوهات المشاهد، أو كتابة كلمات الأغاني، أو استخراج بيانات منظمة من أصولك الإبداعية.

Copycurl https://api.sunoapis.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."}]
  }'

SDK Python

قم بتكامل واجهة برمجة التطبيقات في تطبيقات Python الخاصة بك باستخدام SDK الرسمي لـ OpenAI. نظرًا لأننا متوافقون مع OpenAI، يمكنك إعادة استخدام التعليمات البرمجية الحالية الخاصة بك عن طريق تغيير عنوان URL الأساسي ومفتاح API فقط.

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

Copyfrom openai import OpenAI

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

SDK Node.js

لمطوري JavaScript/TypeScript، تعمل حزمة @anthropic-ai/sdk أو الحزمة الرسمية openai مع تعديلات تكوين بسيطة. وجّه عميلك إلى Base URL الخاص بنا واستخدم معرف النموذج uncensored.

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

Copyimport OpenAI from "openai";

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

الاستجابات المتدفقة

للبرامج النصية الطويلة أو بيانات التعريف المفصلة، استخدم أحداث SSE (Server-Sent Events) لتلقي الرموز في الوقت الفعلي. قم بتعيين stream: true في جسم الطلب الخاص بك. سترسل واجهة برمجة التطبيقات سلسلة من القطع، مما يتيح لك عرض النص أثناء إنشائه.

هذا مفيد بشكل خاص للأدوات الإبداعية التفاعلية حيث يريد المستخدمون رؤية تطور الموجّه أثناء كتابته. تحتوي كل قطعة على نص التغيير فقط، لذا يجب عليك دمج الأجزاء لإعادة بناء الاستجابة الكاملة.

Copystream = 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)

الحدود والأخطاء والنافذة السياقية

كل حساب محدود بمفتاح API واحد، يمكن إعادة إنشائه في أي وقت (إبطال القديم). يُسمح بـ 300 طلب في الدقيقة لكل مفتاح، مع حجم جسم طلب أقصى 8 MB.

تشمل الأخطاء الشائعة 401 للمفاتيح غير الصالحة، 402 إذا كان لديك رصيد مسبق دفع غير كافٍ، و429 لحدود المعدل. يدعم النموذج نافذة سياق بحجم 100,000 رمز لكل من الإدخال والإخراج معًا.

Content Note: لا يرفض النموذج المواضيع المثيرة للجدل أو البالغين، لكنه يحظر بدقة المحتوى الجنسي الذي يتضمن قاصرين في جميع الطلبات.