API codex را سریع یکپارچه کنید

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

هر درخواست را با اشاره کلاینت خود به URL پایه اختصاصی شروع کنید. این نقطه پایدار هدرهای استاندارد را می‌پذیرد و پراکسی پیش‌فرض OpenAI را بدون نیاز به تغییر کد در اکثر SDKها جایگزین می‌کند.

• URL پایه: https://api.apicodex.cc/v1
• هدر Auth: Authorization: Bearer YOUR_API_KEY

کلید API بلافاصله پس از ثبت‌نام ایجاد می‌شود. می‌توانید کلیدها را در صورت نیاز تغییر دهید، اما هر حساب فقط یک کلید فعال در هر زمان دارد.

Copycurl https://api.apicodex.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fix syntax error in python loop"}]
  }'

پارامترهای POST /v1/chat/completions

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

• پنجره زمینه: مجموعاً ۱۰۰,۰۰۰ توکن.
• حداکثر خروجی: ۱۶,۰۰۰ توکن در هر درخواست.
• max_tokens پیش‌فرض: 2,048 اگر مشخص نشده باشد.

توکن‌های ورودی و خروجی جداگانه محاسبه می‌شوند. خطاها اعتبار مصرف نمی‌کنند.

Copyfrom openai import OpenAI

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

جزئیات اندپوینت GET /v1/models

مدل‌های موجود را جستجو کنید تا اتصال را تأیید نمایید. این endpoint متاداده‌ای درباره مدل uncensored میزبانی‌شده بر روی سرورهای ما را برمی‌گرداند.

• شناسه مدل: uncensored
• Type: chat-completion

از این اندپوینت برای بررسی کارکرد کلید API خود قبل از ارسال بارهای سنگین استفاده کنید. این اندپوینت بلافاصله با تأخیر کم پاسخ می‌دهد.

Copyimport OpenAI from "openai";

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

پاسخ‌های استریم‌شده و مصرف توکن

استریمینگ را با تنظیم stream: true. سرور برای هر توکن تولید شده، رویدادهای ارسالی سرور (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)

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

خروجی ساختاریافته را با تنظیم response_format به {"type": "json_object"}. این موضوع مدل را مجبور می‌کند تا JSON معتبر بدون بسته‌های مارک‌داون بازگرداند.

• فراخوان تابع: از طریق فرمت استاندارد ابزارها پشتیبانی می‌شود.
• انتخاب ابزار: قابل پیکربندی.

حالت JSON برای پارس داده‌ها به برنامه‌ها ایده‌آل است. فراخوانی تابع، جریان‌های عامل را با ابزارهای خارجی امکان‌پذیر می‌سازد.

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

خطاها را با بررسی کدهای وضعیت HTTP استاندارد مدیریت کنید. خطای 401 به این معنی است که کلید API شما نامعتبر یا فاقد آن است. خطای 402 نشان‌دهنده اعتبار پیش‌پرداخت ناکافی است. خطای 429 نشان می‌دهد که از محدودیت نرخ تجاوز کرده‌اید.

• محدودیت نرخ: ۳۰۰ درخواست در دقیقه به ازای هر کلید.
• درخواست‌های موازی: حداکثر 8 برای هر کلید.
• حداکثر بدنه درخواست: ۸ مگابایت.

استردادها برای اعتبار صادر نمی‌شوند، اما خطاها رایگان هستند. برای مشکلات مالی با پشتیبانی تماس بگیرید.