مستندات API & شروع سریع

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

استفاده https://api.glmdocs.com/v1 به‌عنوان آدرس پایه (base URL). کلید API خود را در Authorization: Bearer header. بلافاصله پس از ثبت‌نام یک کلید دریافت می‌کنید. نیازی به شماره تلفن نیست. کلید برای هر حساب منحصر به فرد است. کلید قدیمی را هنگام ایجاد کلید جدید جایگزین کنید. کلید خود را امن نگه دارید.

Copycurl https://api.glmdocs.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Explain how to parse JSON in Python"}]
  }'

احراز هویت استاندارد است. هر SDK OpenAI در اینجا کار می‌کند. آدرس پایه را تغییر دهید. کلید API را تنظیم کنید. این تنها کاری است که باید انجام دهید. خطاها کدهای HTTP استاندارد را برمی‌گردانند. برای کلیدهای نامعتبر از 401 و برای اعتبار کافی نباشنده از 402 استفاده کنید.

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

ارسان اولین پرامپت با استفاده از SDK رسمی Python. بسته را نصب کنید. URL پایه را تنظیم کنید. کلاینت را import کنید. تکمیل‌های چت را فراخوانی کنید. شناسه مدل "uncensored" است. ورودی متن را مدیریت کرده و خروجی متن برمی‌گرداند. نیاز به پیکربندی اضافی نیست. پاسخ شامل متن تولید شده است.

Copyfrom openai import OpenAI

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

با Node.js با استفاده از کلاینت استاندارد ادغام کنید. متغیر محیطی را تنظیم کنید. کلاینت را مقداردهی اولیه کنید. درخواست تکمیل دهید. پاسخ را مدیریت کنید. کد ساده است. از همان شناسه مدل استفاده کنید. SDK سریال‌سازی را انجام می‌دهد. داده‌های ساختاریافته دریافت می‌کنید.

Copyimport OpenAI from "openai";

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

کاربران Node.js همان تأخیر را دریافت می‌کنند. API به صورت پیش‌فرض سینک است. جریان‌دهی نیاز به پیکربندی اضافی دارد. مدیریت خطاها حیاتی است. مشکلات شبکه را بگیرید. محدودیت نرخ را بررسی کنید. URL پایه ثابت می‌ماند. کلید شما یکسان است.

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

برای خروجی بلادرنگ، جریان‌یابی را فعال کنید. پرچم stream را تنظیم کنید. قطعات را هنگام تولید دریافت کنید. آخرین قطله شامل مصرف توکن است. این به ردیابی هزینه‌ها کمک می‌کند. 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)

استریمینگ تأخیر ادراک‌شده را کاهش می‌دهد. با Python و Node کار می‌کند. تعداد توکن‌ها در انتها ظاهر می‌شود. آن‌ها را برای استفاده کلی جمع بزنید. خطاها استریم را قطع می‌کنند. افت اتصال را به صورت مناسب مدیریت کنید. پنجره زمینه بزرگ است. به توکن‌ها توجه داشته باشید.

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

از فراخوانی تابع برای خروجی‌های ساختاریافته استفاده کنید. ابزارها را در درخواست تعریف کنید. مدل JSON معتبر برمی‌گرداند. حالت JSON را برای خروجی دقیق فعال کنید. تنظیم response_format به json_object. دما تصادفی‌سازی را کنترل می‌کند. Top_p تنوع را محدود می‌کند. دنباله‌های توقف تولید را متوقف می‌کند. بذر قابلیت بازتولید را تضمین می‌کند.

مجازات‌های حضور و فرکانس تکرار را تنظیم می‌کنند. برای وظایف برنامه‌نویسی از آن‌ها استفاده کنید. ابزارها می‌توانند تصاویر را منتقل کنند. آرگومان‌های تابع اسناد را می‌پذیرند. نیاز به دور زدن OCR نیست. مدل ورودی‌های چندوجهی را مدیریت می‌کند. این برای عامل‌ها قدرتمند است. ابزارها را با دقت پیکربندی کنید. موارد مرزی را آزمایش کنید.

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

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

خطاها کدهای واضحی برمی‌گردانند. 401 به معنای کلید نامعتبر است. 402 به معنای عدم موجودی است. 429 به معنای محدودیت نرخ است. مصرف خود را در داشبورد بررسی کنید. اعتبار هرگز منقضی نمی‌شود. موجودی پیش‌پرداخت تمام درخواست‌ها را پوشش می‌دهد. کریپتو فقط برای شارژ. USDT یا USDC.