مستندات API

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

ابتدا کلاینت خود را به URL پایه ما اشاره دهید و کلید خود را در هدر Authorization ارسال کنید. ما از یک مدل اعتبار پیش‌پرداخت ساده استفاده می‌کنیم که بر اساس مصرف واقعی توکن‌ها محاسبه می‌شود، بنابراین خطاها و رد شدن درخواست‌ها رایگان هستند. می‌توانید کلید را به‌طور فوری از طریق گوگل یا ایمیل (بدون نیاز به شماره تلفن) ایجاد کنید و کلید بلافاصله پس از ثبت‌نام نمایش داده می‌شود.

اولین درخواست

یک درخواست POST به نقطه پایانی تکمیل چت ارسال کنید تا پاسخ متنی از مدل uncensored دریافت کنید. از شناسه مدل 'uncensored' استفاده کنید تا مطمئن شوید به سرور وزن‌باز اختصاصی ما متصل می‌شوید و نه یک پروکسی عمومی. سیستم پارامترهای استاندارد مانند temperature و top_p را برای کنترل تصادفی‌سازی می‌پذیرد.

Copyfrom openai import OpenAI

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

پاسخ‌های استریم

با تنظیم پارامتر stream روی true، قابلیت streaming را فعال کنید تا توکن‌ها را همان‌طور که تولید می‌شوند دریافت کنید. قطعه نهایی شامل مصرف کل توکن برای درخواست است که ما برای کسر از اعتبار پیش‌پرداخت شما استفاده می‌کنیم. این رویکرد تأخیر ادراک‌شده را برای تولید محتوای بلند کاهش می‌دهد.

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 و فراخوانی تابع

از پارامتر response_format برای اجبار خروجی JSON دقیق جهت تجزیه قابل‌اعتماد در برنامه‌های خود استفاده کنید. همچنین می‌توانید ابزارها (tools) و tool_choice را تعریف کنید تا به مدل اجازه دهید تصمیم بگیرد چه زمانی توابع خاصی را فراخوانی کند. این کار دقیقاً مانند رابط SDK استاندارد OpenAI عمل می‌کند.

Copyimport OpenAI from "openai";

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

محدودیت‌های نرخ و سهمیه‌ها

کلید API شما محدود به 300 درخواست در دقیقه است و فقط هشت درخواست همزمان را اجازه می‌دهد. حداکثر اندازه بدنه درخواست 8 مگابایت است و می‌توانید تا 16,000 توکن در هر تکمیل درخواست دهید. اگر از این محدودیت‌ها تجاوز کنید، سرور کد وضعیت 429 را برمی‌گرداند.

خطاهای رایج و زمینه

خطای 401 به این معنی است که کلید شما نامعتبر یا منقضی شده است، در حالی که خطای 402 نشان‌دهنده تخلیه اعتبار پیش‌پرداخت است. می‌توانید با USDT (TRC20) یا USDC (Base) از مبلغ 20$ شروع به شارژ کنید تا به استفاده از سرویس ادامه دهید. پنجره زمینه برای پرامپت و تکمیل به صورت ترکیبی 100,000 توکن است.

cURL

Copycurl https://api.keyapiclaude.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List 3 steps to validate an API key"}]
  }'