توثيق API - KimiCode

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

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

يحتوي كل حساب على مفتاح نشط واحد في كل مرة؛ يؤدي إنشاء مفتاح جديد إلى استبدال المفتاح القديم. يتم مصادقة الطلبات عبر رأس المصادقة، مما يضمن وصولاً آمناً إلى رصيدك المدفوع مسبقاً.

الطلب الأول

أرسل أول رسالة باستخدام نقطة نهاية إكمال الدردشة القياسية بطلب POST بسيط. يؤكد هذا أن التكامل يعمل قبل الغوص في الميزات المتقدمة أو البيانات المتدفقة (streaming). تعيد الاستجابة مخرجات نصية من النموذج غير المقيد (uncensored).

• استبدل YOUR_API_KEY بمفتاحك من لوحة التحكم.
• حدد النموذج إلى 'uncensored' للنموذج مفتوح المصدر المحدد لدينا.

Copycurl https://api.kimicodepricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List available plan tiers and token costs"}]
  }'

تكامل واجهة برمجة تطبيقات Python

استخدم مكتبة بايثون الرسمية الخاصة بـ OpenAI للتفاعل مع واجهة برمجة التطبيقات الخاصة بنا عن طريق توجيهها إلى عنوان URL الأساسي الخاص بها. يستفيد هذا النهج من التركيب المألوف، مما يتيح لك التبديل بين المزودين دون إعادة كتابة منطق التطبيق بالكامل. تتولى المكتبة معالجة الترميز وتنسيق الطلبات تلقائيًا.

• ثبّت الحزمة openai عبر pip.
• قم بتكوين عنوان URL الأساسي ليشير إلى خدمتنا.

Copyfrom openai import OpenAI

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

تكامل Node SDK

دمج واجهة برمجة التطبيقات الخاصة بنا في تطبيقات JavaScript أو TypeScript باستخدام SDK Node. يضمن ذلك سلوكاً متسقاً عبر بيئات الواجهة الأمامية والخلفية. يمكنك تمرير الرسائل واستلام الاستجابات كما تفعل مع أي خدمة متوافقة مع OpenAI.

Copyimport OpenAI from "openai";

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

استخدام الرموز والبث

تمكين التدفق لتلقي توليد الرمز في الوقت الفعلي عبر أحداث Server-Sent (SSE). يقلل هذا من زمن الاستجابة المُدرَك للمستخدمين ويسمح بالعرض الفوري للنتائج الجزئية. بيانات استخدام الرمز، بما في ذلك عدادات الإدخال والإخراج، مدمجة في الكتلة الأخيرة من التدفق.

هذه الطريقة مثالية لواجهات الدردشة حيث يهم التغذية الراجعة الفورية. يمكنك تحليل التدفق لتحديث واجهة المستخدم تدريجياً دون انتظار الاستجابة الكاملة.

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)

حدود، أخطاء، والسياق

أدر استهلاكك بفهم حدود المعدلات وأكواد الأخطاء الشائعة. تدعم الواجهة نافذة سياق بحجم 100,000 توكن، مما يسمح بتاريخ محادثات عميق. أنت مقيد بـ 300 طلب في الدقيقة و8 طلبات متزامنة لكل مفتاح.

• تشير 401 إلى مفتاح API غير صالح أو مفقود.
• تشير 402 إلى استنفاد رصيدك المدفوع مسبقاً.
• تشير 429 إلى تجاوزك لحد المعدل.

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