البدء السريع لخطوط إنتاج Acestep

المتطلبات المسبقة: احصل على مفتاح API

قبل إرسال الطلبات، تحتاج إلى مفتاح API صالح. قم بزيارة صفحة الحصول على مفتاح API على acestep.cc. يمكنك التسجيل باستخدام المتابعة باستخدام Google أو بإنشاء حساب بالبريد الإلكتروني وكلمة المرور. لا يلزم رقم الهاتف. بعد التسجيل، يظهر مفتاح API الخاص بك على الفور. انسخ هذا المفتاح؛ ستستخدمه للمصادقة على جميع الطلبات اللاحقة. إذا لم يكن لديك رصيد، ستحتاج إلى شحن الرصيد. نقبل الدفع بالعملات المشفرة فقط (USDT على TRC20 أو USDC على Base) للمبالغ بين $10 و$500. تحصل الحسابات الجديدة على رصيد تجريبي مجاني بقيمة $0.50 صالح لمدة 7 أيام، دون الحاجة إلى بطاقة ائتمان للبدء. احتفظ بمفتاحك بأمان، فهو يصادق على استخدامك ضد حدود المعدل واستهلاك الرموز.

التثبيت

تستخدم واجهة API البروتوكول المتوافق مع OpenAI. يمكنك التفاعل معها باستخدام مكتبات OpenAI الرسمية للغتك المفضلة أو أي عميل HTTP. بالنسبة لـ Python، قم بتثبيت حزمة openai. بالنسبة لـ Node.js، قم بتثبيت openai. تأكد من استخدام إصدار حديث من المكتبة يدعم عناوين URL الأساسية المخصصة. عنوان URL الأساسي لخدمتنا هو https://api.acestep.cc/v1. يتيح لك ذلك إعادة استخدام أكواد خطوط الأنابيب الحالية التي تتوقع نقاط نهاية OpenAI، فقط عن طريق تغيير عنوان URL الأساسي ومفتاح API. معرف النموذج الذي يجب تحديده في طلباتك هو uncensored. هذا النموذج هو نموذج LLM مفتوح الأوزان مُعدّل لرفض الحد الأدنى للمواضيع القانونية للبالغين أو الخيالية أو المثيرة للجدل، مما يجعله مثاليًا لخطوط الأنابيب الإبداعية حيث قد تمنع فلاتر المحتوى المخرجات الإبداعية الصالحة.

الطلب الأساسي: توليد النص

أرسل طلب POST إلى /v1/chat/completions مع موجّه النظام ورسائل المستخدم. سيعيد النموذج النص المُولّد. تأكد من تعيين المعلمة model إلى uncensored. يمكنك التحكم في الإبداع باستخدام temperature و top_p. تدعم نافذة السياق ما مجموعه 100,000 رمز (الموجّه + الإكمال). الحد الأقصى للإخراج لكل طلب هو 32,000 رمز، أو 2,048 إذا لم تحدد max_tokens. لا تستهلك الأخطاء والرفضات الرصيد، لكن توليد الرموز الناجح يفعل. استخدم نقطة النهاية هذه لتوليد النصوص، أو التسميات، أو معالجة بيانات النص قبل تمريرها إلى واجهات برمجة النص الأخرى مثل تحويل النص إلى كلام أو توليد الصور.

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

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

استدعاء الدوال

تدعم الواجهة البرمجية استدعاء الدوال، مما يسمح للنموذج بإخراج بيانات هيكلية بناءً على الأدوات المحددة من قبلك. عرّف دوالك في المعلمة tools. قم بتعيين tool_choice إلى auto أو اسم دالة محدد. سيعيد النموذج كائن استدعاء الدالة إذا كان ذلك مناسباً. هذا قيم لاستخراج البيانات الهيكلية من النص أو تحضير المدخلات لطلبات واجهة برمجة النص اللاحقة. يمكنك أيضاً فرض إخراج JSON عن طريق تعيين response_format إلى {"type": "json_object"}. هذا يضمن أن يعيد النموذج JSON صالح، وهو أمر بالغ الأهمية للتكامل الموثوق في خط الإنتاج الآلي الخاص بك. استخدم هذه الميزات لتعزيز موثوقية خطوات معالجة النص الخاصة بك.

التسعير والحدود

التسعير هو $0.25 لكل مليون رمز إدخال و$1.00 لكل مليون رمز إخراج. الرصيد مسبق الدفع ولا ينتهي. الأخطاء مجانية. حدّ المعدل هو 300 طلب في الدقيقة لكل مفتاح و8 طلبات متزامنة في نفس الوقت لكل مفتاح. الحد الأقصى لحجم جسم الطلب هو 8 MB. إذا تجاوزت حدّ المعدل، ستتلقى خطأ 429. يشير خطأ 401 إلى مفتاح غير صالح أو منتهي الصلاحية. يعني خطأ 402 أن رصيدك غير كافٍ. لا يتم إصدار استرداد للرصيد؛ تتم معالجة النزاعات عبر صفحة الدعم. يُسمح بمفتاح نشط واحد لكل حساب؛ استبدال المفتاح القديم عند إنشاء مفتاح جديد. ضع هذه الحدود في الاعتبار عند تصميم منطق إعادة المحاولة في خط الإنتاج الخاص بك.

cURL

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

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

البث المتدفق

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)