راهنمای یکپارچه‌سازی API Ki

URL پایه و احراز هویت

API در https://api.kiapi.cc/v1. یک کلید فعال به ازای هر حساب کاربری، بلافاصله پس از ثبت‌نام از طریق Google یا ایمیل نمایش داده می‌شود. کلید base_url در کلاینت خود قرار دهید و Authorization هدر به Bearer YOUR_KEY. با هر SDK استاندارد OpenAI کار می‌کند.

• URL پایه: https://api.kiapi.cc/v1
• هدر: Authorization: Bearer YOUR_KEY

Copycurl https://api.kiapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch latest version from github repo"}]
  }'

نقطه پایانی تکمیل چت

پیام‌ها را به POST /v1/chat/completions. از شناسه مدل uncensored برای خروجی‌های نامحدود. اندپوینت فرمت‌های استاندارد چت را با پنجره زمینه (context window) 100,000 توکن در مجموع می‌پذیرد. پاسخ‌های متنی را بدون رد محتوای بزرگسالان قانونی برمی‌گرداند. اینجا قابلیت تولید امبدینگ یا تصویر وجود ندارد.

Copyfrom openai import OpenAI

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

پاسخ‌های استریم (SSE)

استریمینگ را با تنظیم stream: true. رویدادهای ارسال‌شده توسط سرور (SSE) را برای تحویل بلادرنگ توکن‌ها دریافت می‌کنید. آخرین قطعه شامل آمار کامل استفاده برای صورت‌حساب است. این برای رابط‌های چت که نیاز به پاسخ‌های جزئی فوری دارند ایده‌آل است. می‌توانید جریان SSE را تجزیه کنید تا رابط کاربری بلافاصله به‌روزرسانی شود.

Copyimport OpenAI from "openai";

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

فراخوانی تابع و حالت JSON

استفاده response_format: {"type": "json_object"} برای خروجی‌های JSON دقیق. API از تعاریف ابزار و انتخاب ابزار برای فراخوانی تابع پشتیبانی می‌کند. می‌توانید ابزارهای سفارشی را در tools آرایه. مدل در صورت نیاز با داده‌های ساختاریافته پاسخ می‌دهد. این در کنار تولید متن استاندارد کار می‌کند.

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)

پارامترها و محدودیت‌های مدل

پشتیبانی می‌کند temperature, top_p, stop, seed, و پارامترهای جریمه. حداکثر خروجی ۱۶,۰۰۰ توکن در هر درخواست است. می‌توانید تا ۳۰۰ درخواست در دقیقه ارسال کنید. همزمانی به ۸ درخواست همزمان در هر کلید محدود شده است. بدنه درخواست باید کمتر از ۸ مگابایت باشد. این محدودیت‌ها عملکرد پایدار را برای وظایف تولید بدون سانسور تضمین می‌کنند.

مصرف توکن و صورت‌حساب

توکن‌های ورودی هر میلیون ۰.۱۵ دلار و توکن‌های خروجی هر میلیون ۰.۵۰ دلار هزینه دارند. خطاها و رد شدن‌ها رایگان هستند. اعتبار فقط از طریق ارز دیجیتال شارژ می‌شود. اعتبار پیش‌پرداخت هرگز منقضی نمی‌شود. شما فقط بابت مصرف واقعی توکن پرداخت می‌کنید. هزینه اشتراک ماهانه‌ای اعمال نمی‌شود. سیستم مصرف را برای صورت‌حساب به دقت ردیابی می‌کند.