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

المتطلبات المسبقة: تثبيت الـ SDK

قبل إرسال طلبك الأول، تأكد من تثبيت الـ SDK الرسمي لـ OpenAI للغة المفضلة لديك. تستخدم هذه الواجهة البرمجية بروتوكول chat/completions القياسي، لذا فإن أي عميل متوافق مع OpenAI يعمل. بالنسبة لـ Python، قم بتثبيت الحزمة عبر pip. بالنسبة لـ Node.js، استخدم npm. تحتاج فقط إلى مكتبة العميل؛ لا توجد متطلبات إضافية لتوليد النص الأساسي أو استدعاء الدوال.

المصادقة: ضبط مفتاح API

تتم المصادقة عبر رمز Bearer بسيط. أنشئ حسابًا على صفحة Get API key لتلقي مفتاحك الفريد. لا حاجة لبطاقة ائتمان للتجربة. احفظ هذا المفتاح في متغير بيئة أو ملف تكوين التطبيق. يمنح المفتاح الوصول إلى النموذج بدون رقابة وهو مرتبط برصيد الرصيد المسبق الدفع الخاص بك. يمكنك إعادة إنشاء المفتاح في أي وقت من لوحة التحكم إذا لزم الأمر.

إرسال طلب إكمال المحادثة

أرسل طلب POST إلى عنوان URL الأساسي. يجب تعيين حقل model إلى uncensored. قم بتضمين الموجّه الخاص بالنظام لتحديد الدور، ورسائل المستخدم لتوليد المحتوى. تتعامل نقطة النهاية هذه مع مهام كتابة النصوص التوضيحية والتعليقات ومعالجة ما بعد الإنتاج بكفاءة.

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

استجابات البث المتدفق للإخراج في الوقت الفعلي

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

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)

استخدام استدعاء الدوال للبيانات المهيكلة

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

Copyfrom openai import OpenAI

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

فهم الحدود والحصص

انتبه لرموز حالة HTTP القياسية. يعني الخطأ 401 أن مفتاح API الخاص بك غير صالح أو منتهي الصلاحية. يشير الخطأ 402 إلى عدم كفاية الرصيد المسبق الدفع؛ قم بالشراء للمتابعة. يشير الخطأ 429 إلى حدّ المعدل، المحدود بـ 300 طلب في الدقيقة لكل مفتاح. نافذة السياق هي 100,000 رمز إجمالي. سيتم رفض الطلبات التي تتجاوز 8 ميجابايت.

Copyimport OpenAI from "openai";

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