معرفی پیکربندی مدل ها
این آموزش نحوه پیکربندی مدل های مختلف زبان بزرگ را در ** توضیح می دهد.SelectTranslate** پسوند، از جمله API keys، نشانیهای وب نقطه پایانی، انتخاب مدل، پارامترهای عملکرد و تنظیمات سریع. پیکربندی مناسب مدل می تواند پایداری سرویس را بهبود بخشد و دقت ترجمه، سرعت پاسخگویی و تجربه کلی کاربر را در سناریوهای مختلف ترجمه افزایش دهد.
1. پیکربندی کنید API Key
یک API key اعتبار دسترسی رسمی ارائه شده توسط ارائه دهنده خدمات مدل است که برای فراخوانی ایمن آن استفاده می شود AI مدل ها و خدمات مرتبط
**متداول API Key مشکلات پیکربندی **
- نادرست است API Key قالب: API key ممکن است نویسههای گمشده، فاصلههای اضافی یا نادرست کوتاه شده باشد. اطمینان حاصل کنید که کلید کامل ارائه شده توسط سرویس را کپی کنید و از وارد کردن فاصله، شکست خط یا سایر کاراکترهای نامعتبر خودداری کنید.
- **API Key عدم تطابق با ارائه دهنده خدمات **: API keys ارائه دهندگان مدل های مختلف قابل تعویض نیستند. به عنوان مثال، یک OpenAI API key قابل استفاده با DeepSeek مدل ها
- API Key منقضی یا غیرفعال: شما API key ممکن است به دلیل انقضا، غیرفعال کردن دستی، مشکلات حساب، محدودیتهای استفاده یا دلایل امنیتی لغو شده باشد. لطفاً از کنسول ارائه دهنده خود دیدن کنید تا وضعیت فعلی خود را تأیید کنید API key.
- خطای URL نقطه پایانی: حتی با یک معتبر API Key، اگر نشانی وب نقطه پایانی نادرست باشد، مسیرهای نسخه را نداشته باشد یا با الزامات خاص ارائه دهنده مطابقت نداشته باشد، ممکن است آزمایشات اتصال با شکست مواجه شود.
- عدم تطابق نام مدل: مطمئن شوید که نام مدل به درستی نوشته شده است و به طور رسمی توسط ارائه دهنده شما پشتیبانی می شود. اشتباهات تایپی در اینجا اغلب به اشتباه شناسایی می شوند API Key مسائل
- مشکلات شبکه یا پروکسی: پایداری شبکه محلی، پیکربندی های پروکسی یا محدودیت های فایروال ممکن است درخواست ها را مسدود کند و در نتیجه احراز هویت با شکست مواجه شود یا درخواست ها به پایان برسد.
2. انتخاب مدل ترجمه
هنگام پیکربندی برنامه افزودنی، نام مدل باید با ارائه دهنده خدمات مرتبط با آن مطابقت داشته باشد API key; در غیر این صورت، مدل را نمی توان با موفقیت فراخوانی کرد.
ارائه دهندگان پشتیبانی شده و نقشه برداری مدل
| ارائه دهنده | نام مدل |
|---|---|
| OpenAI | gpt-5、gpt-5-mini、gpt-5-nano |
| Gemini | gemini-2.5-flash、gemini-2.0-flash-lite |
3. سفارشی API URL
افزونه از رسمی استفاده می کند API URL به طور پیش فرض، بنابراین معمولاً نیازی به تنظیمات نیست. ورود دستی URL فقط در موارد زیر ضروری است:
- فراخوانی مدل از طریق یک پروکسی معکوس یا سرویس رله،
- با استفاده از یک سرویس مدل بزرگ مستقر خصوصی،
- اتصال به شخص ثالث API سرویس هایی که به طور کامل از URL پیش فرض رسمی استفاده نمی کنند.
دستورالعمل های ورودی:
- URL باید یک نقطه پایانی کامل HTTPS باشد، به عنوان مثال:
https://api.your-company.com/v1/chat/completions - مسیر نقطه پایانی باید با مستندات فنی ارائه دهنده خدمات مطابقت داشته باشد API باید درخواست هایی را که از فرمت مشخص شده پیروی می کنند به درستی دریافت و رسیدگی کند.
4. تنظیم پارامتر مدل
پارامترهای زیر برای تنظیم کیفیت ترجمه، ثبات مدل و سرعت پاسخ استفاده می شود. تنظیمات پیش فرض بیشتر موارد استفاده را پوشش می دهد. آنها را در صورت نیاز برای نیازهای خاص تنظیم کنید.
| پارامترها | توضیحات | تنظیمات توصیه شده |
|---|---|---|
| حداکثر طول متن در هر درخواست | برای محدود کردن حداکثر تعداد نویسههایی که میتوان در یک درخواست ترجمه ارسال کرد استفاده میشود. تنظیم این مقدار خیلی زیاد ممکن است کند شود API پاسخ ها؛ نگه داشتن آن در محدوده معقول به بهبود ثبات و سرعت پاسخ کمک می کند. | - توصیه می شود 1000–1500 شخصیت ها- از زیاده روی خودداری کنید 2000 کاراکترها برای جلوگیری از تاخیر در پاسخ یا از دست دادن محتوا. |
| حداکثر تعداد پاراگراف در هر درخواست | تعداد پاراگراف هایی که می توان در یک درخواست ترجمه به یکباره ارسال کرد. ارسال بیش از حد پاراگراف ها به طور همزمان ممکن است بار پردازش را افزایش دهد و منجر به پاسخ های کندتر یا کاهش پایداری شود. تنظیم این مقدار به طور مناسب به بهبود کارایی و قابلیت اطمینان کلی ترجمه کمک می کند. | - متون فنی یا حقوقی:1(برای اطمینان از صحت اصطلاحات، پاراگراف به پاراگراف پردازش کنید)- رمان ها، دیالوگ ها یا وبلاگ ها: 3–5(تسلط را بهبود می بخشد) |
| حداکثر درخواست در ثانیه | تعداد درخواست های ترجمه ارسال شده در هر ثانیه. اگر نرخ درخواست خیلی زیاد باشد، درخواستهای اضافی برای جلوگیری از ضربه زدن در صف قرار میگیرند API محدودیت های نرخ و حفظ ثبات کلی سیستم. | - کاربرد عمومی:25- خدمات با نرخ محدود (به عنوان مثال، Gemini): 8–10 |
| دما | تصادفی بودن و تغییرپذیری خروجی مدل را کنترل می کند. مقادیر دمای بالاتر پاسخهای متنوعتر و خلاقانهتری ایجاد میکنند، در حالی که مقادیر پایینتر منجر به خروجیهای پایدارتر میشود که برای ترجمههای منسجم و دقیق ترجیح داده میشود. | - توصیه برای کارهای ترجمه: دمای توصیه شده رسمی بسته به مدل متفاوت است. پیشنهاد می شود از پیش فرض ارائه شده استفاده کنید و در صورت نیاز تنظیم کنید. |
5. درخواست های سفارشی (اعلام سیستم / درخواست کاربر)
برنامه افزودنی شامل اعلان های ترجمه عمومی داخلی و بهینه شده است که اکثر سناریوهای ترجمه رایج را پوشش می دهد. هنگامی که الزامات خاصی وجود دارد - مانند سبک ترجمه، سازگاری اصطلاحات، تخصص دامنه، یا ترجیحات لحن - می توان از دستورهای سفارشی برای تنظیم دقیق خروجی مدل استفاده کرد.
** هنگام ایجاد درخواست های ترجمه سفارشی، توصیه می شود این دستورالعمل ها را دنبال کنید:**
- **دستورالعمل های واضح و مشخص **: زبان مقصد، سبک ترجمه، دامنه، و هر گونه عبارت یا انتخاب کلمه ای که باید اجتناب شود را به وضوح مشخص کنید.
- دستورالعمل های عملی: برای اطمینان از اینکه مدل می تواند دستورالعمل ها را به درستی درک کند و از آنها پیروی کند، از توصیفات ملموس و دقیق، اجتناب از اظهارات مبهم یا انتزاعی استفاده کنید.
- پخشها را مختصر نگه دارید: اطمینان حاصل کنید که درخواست اطلاعات کافی را در عین مختصر بودن ارائه میدهد، و از جزئیات اضافی که میتواند در درک مدل اختلال ایجاد کند اجتناب کنید.
6. سلب مسئولیت
🔔 لطفاً برای جلوگیری از هزینه های غیرمنتظره، از ردیف رایگان و هرگونه هزینه ای که ارائه دهنده خدمات دریافت می کند، آگاه باشید.