راهنمای شروع سریع API مدل‌ها

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

نقطه پایانی API https://api.modelsapi.cc/v1. تمام درخواست‌ها نیاز به یک کلید API معتبر دارند که در Authorization header. این کلید را در داشبورد با کلیک روی 'دریافت کلید API' ایجاد می‌کنید. بلافاصله پس از ثبت‌نام با گوگل یا ایمیل ظاهر می‌شود. برای این فرآیند نیازی به شماره تلفن نیست. کلید به موجودی حساب و محدودیت‌های استفاده شما مرتبط است.

ارسال اولین درخواست تکمیل چت شما

یک درخواست POST به /v1/chat/completions با شناسه مدل uncensored. بدنه درخواست باید شامل یک messages آرایه‌ای شامل پرامپت شما. API پاسخ متنی را مستقیماً برمی‌گرداند. خطاها اعتبار پیش‌پرداخت شما را مصرف نمی‌کنند. می‌توانید با ارسال یک سلام ساده، از کارکرد endpoint اطمینان حاصل کنید.

Copycurl https://api.modelsapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List five python libraries for data visualization"}]
  }'

یکپارچه‌سازی SDK پایتون

از کتابخانه رسمی پایتون OpenAI برای ارتباط با API استفاده کنید. آدرس پایه را به انتهای کار ما تنظیم کرده و کلید API خود را ارائه دهید. این روش سازگاری با کدهای موجود را تضمین می‌کند. می‌توانید کلاینت را ایجاد کرده و روش تکمیل چت را فراخوانی کنید. شیء پاسخ شامل متن تولید شده و آمار مصرف توکن است.

Copyfrom openai import OpenAI

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

SDK Node.js الگوی پیکربندی یکسانی را دنبال می‌کند. بسته OpenAI را وارد کنید و URL پایه را پیکربندی کنید. کلید API خود را در شیء پیکربندی ارسال کنید. این تنظیم به شما اجازه می‌دهد از روش‌های آشنا برای تولید متن استفاده کنید. کتابخانه درخواست‌های HTTP را به طور خودکار مدیریت می‌کند.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.modelsapi.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 در درخواست شما. API چندین قطعه داده را همان‌طور که تولید می‌شوند ارسال می‌کند. هر قطعه شامل یک پاسخ ناقص است. قطعه نهایی شامل کل مصرف توکن است. این روش تأخیر ادراک‌شده برای خروجی‌های طولانی را کاهش می‌دهد. این روش برای برنامه‌های بلادرنگ ایده‌آل است.

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)

Limits, errors, and context window

پنجره زمینه (context window) از مجموعاً ۱۰۰,۰۰۰ توکن پشتیبانی می‌کند. می‌توانید تا ۱۶,۰۰۰ توکن در هر درخواست خروجی دهید. خطاها وضعیت 401 را برای کلیدهای نامعتبر و 402 را برای اعتبار ناکالی برمی‌گردانند. محدودیت‌های نرخ پس از ۳۰۰ درخواست در دقیقه وضعیت 429 را برمی‌گردانند. خطای 429 موقتی است. اعتبار پیش‌پرداخت شما هرگز منقضی نمی‌شود. خطاها موجودی شما را شارژ نمی‌کنند. از این کدها برای مدیریت شکست‌ها به‌طور شایسته در منطق برنامه خود استفاده کنید.