ن

github.com/netarz

کد باز و نمونه‌کد نِت اَرز در گیت‌هاب

برای وصل شدن به دو وب‌سرویس نِت اَرز، API هوش مصنوعی سازگار با OpenAI و API نرخ ارز، نمونه‌کد نوشته‌ایم و آن را با یک افزونهٔ وردپرس در گیت‌هاب گذاشته‌ایم. خود کد رایگان است و با مجوز MIT یا GPL در پروژهٔ خودتان به کارش می‌برید. سرویس‌ها جدا حساب می‌شوند: API هوش مصنوعی با اعتباری کار می‌کند که به تومان می‌خرید و API نرخ ارز طرح رایگان دارد.

$ git clone https://github.com/netarz/ai-api-examples
Cloning into 'ai-api-examples'... done.
$ python python/chat.py
سلام، چطور می‌توانم کمکتان کنم؟

پنج مخزن، برای دو وب‌سرویس

هر مخزن (repository) یک README فارسی دارد که قدم‌به‌قدم می‌گوید کلید را کجا بگذارید. کنار هر کارت، صفحهٔ معرفی سرویس و مستندات فنی همان سرویس را هم گذاشته‌ایم.

نمونه‌کد API هوش مصنوعی

netarz/ai-api-examples مجوز MIT

نمونه‌کد API هوش مصنوعی نِت اَرز، یک API سازگار با OpenAI. اگر برای OpenAI کد نوشته‌اید، فقط نشانی پایه (base URL) و کلید عوض می‌شود و با همان کد مدل‌های GPT، Claude، Gemini و DeepSeek را صدا می‌زنید.

چه دارد: گفت‌وگو، پاسخ تکه‌به‌تکه (استریم)، خروجی JSON، فراخوانی تابع، امبدینگ، ساخت تصویر، تبدیل متن و گفتار به هم و مدیریت خطا؛ به‌علاوهٔ یک ربات تلگرام، workflow آمادهٔ n8n و تنظیم Cursor و Cline.

به کار چه کسی می‌آید: برنامه‌نویسی که می‌خواهد مدل زبانی را به سایت، اپ، ربات تلگرام یا ابزار خودکارسازی خودش وصل کند.

  • Python
  • Node.js
  • PHP
  • Laravel
  • cURL
  • LangChain
  • n8n
  • Telegram
Python
from openai import OpenAI

client = OpenAI(base_url="https://netarz.ir/api/ai/v1", api_key="sk-ntz-v1-...")
r = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "سلام"}],
    max_tokens=200,
)
print(r.choices[0].message.content)

اعتبار API را به تومان می‌خرید و هزینهٔ هر درخواست به دلار از همان اعتبار کم می‌شود.

نمونه‌کد API نرخ ارز

netarz/fx-api-examples مجوز MIT

نمونه‌کد وب‌سرویس نرخ ارز نِت اَرز برای نمایش نرخ دلار، یورو، درهم و لیر به تومان. هر نمونه کش دارد تا سهمیهٔ روزانهٔ شما زود تمام نشود.

چه دارد: جدول نرخ در صفحهٔ سایت، مبدل ارز، تابع =NETARZ_RATE("USD") در Google Sheets، نرخ در Excel با Power Query و کد کوتاه وردپرس؛ به‌علاوهٔ راهنمای قفل دامنه و IP برای سروری که IP ثابت ندارد یا پشت Cloudflare است.

به کار چه کسی می‌آید: صاحب سایت یا اپ که نرخ ارز را به تومان نشان می‌دهد، و کسی که نرخ روز را در اکسل یا گوگل شیت لازم دارد.

  • PHP
  • JavaScript
  • Python
  • Laravel
  • WordPress
  • Google Sheets
  • Excel
cURL
curl "https://netarz.ir/api/fx/v1/rates?codes=USD,EUR,AED" \
  -H "Authorization: Bearer $NETARZ_FX_KEY"

طرح رایگان API نرخ ارز با عضویت و تأیید دامنه فعال می‌شود و نرخ را با ۱۵ دقیقه تأخیر می‌دهد.

افزونهٔ نرخ ارز وردپرس

netarz/netarz-fx-wordpress مجوز GPL-2.0

افزونه‌ای کوچک که نرخ دلار و ارزهای دیگر را به تومان، با کد کوتاه (شورت‌کد) یا ابزارک، در سایت وردپرسی نشان می‌دهد. کلیدش را در پنل API نرخ ارز نِت اَرز می‌سازید.

چه دارد: کل تابلوی نرخ را در هر دورهٔ کش یک بار می‌گیرد، اگر API در دسترس نباشد آخرین نرخ سالم را نشان می‌دهد، رقم فارسی یا لاتین را مطابق زبان سایت می‌نویسد و ترجمهٔ فارسی دارد. زیر نرخ‌ها یک لینک کوچک «نرخ از نِت اَرز» می‌گذارد که از تنظیمات افزونه خاموش می‌شود. به وردپرس ۶ و PHP 7.4 به بالا نیاز دارد.

به کار چه کسی می‌آید: صاحب سایت وردپرسی که نرخ ارز را بدون نوشتن کد، داخل نوشته، برگه یا ستون کناری می‌خواهد.

  • PHP
  • WordPress
شورت‌کد
[netarz_rate currency="usd"]
[netarz_rate currency="eur" field="buy" show_name="1"]
[netarz_rates currencies="usd,eur,aed,try"]

افزونه در مخزن افزونه‌های وردپرس (wordpress.org) نیست. فایل ZIP را از گیت‌هاب بگیرید و از «افزونه‌ها ← افزودن ← بارگذاری افزونه» نصبش کنید.

افزونهٔ هوش مصنوعی WHMCS

netarz/netarz-ai-whmcs مجوز MIT

ماژول WHMCS برای چت آنلاین و پاسخ تیکت با هوش مصنوعی، که فقط از اطلاعات WHMCS خودتان جواب می‌دهد و کار حساس را به همکاران شما می‌سپارد.

چه دارد: پنجرهٔ چت در ناحیهٔ کاربری، صندوق چت همکاران، پیش‌نویس یا پاسخ خودکار تیکت و اعتبار هوش مصنوعی نِت اَرز داخل پنل مدیریت. به WHMCS 8 و PHP 7.4 به بالا نیاز دارد.

به کار چه کسی می‌آید: شرکت هاستینگ یا نمایندگی که پشتیبانی‌اش روی WHMCS است.

  • PHP
نصب
modules/addons/netarz_ai/
System Settings → Addon Modules → NetArz AI
Addons → NetArz AI → Settings → API key

افزونه رایگان است؛ هزینهٔ هوش مصنوعی به اندازهٔ مصرف از اعتبار «API هوش مصنوعی» نِت اَرز شما کم می‌شود.

افزونهٔ هوش مصنوعی وردپرس

netarz/netarz-ai-wordpress مجوز GPL-2.0

چت پشتیبانی که از دانش خودتان و مطالب سایت جواب می‌دهد و کار حساس را به همکار می‌سپارد، به‌همراه تیکت برای عضو و مهمان و ابزار نوشتن در ویرایشگر وردپرس.

چه دارد: ویجت چت و صندوق گفت‌وگوی همکاران، تیکت با پیوست و زبانهٔ «پشتیبانی» در حساب ووکامرس، پیش‌نویس یا پاسخ خودکار تیکت، ابزار نوشتن و سئو و نمایش اعتبار هوش مصنوعی. به وردپرس ۶ و PHP 7.4 به بالا نیاز دارد. با افزونهٔ نرخ ارز بالا فرق دارد.

به کار چه کسی می‌آید: صاحب فروشگاه ووکامرس یا سایت وردپرسی که می‌خواهد بخشی از کار پشتیبانی و نوشتن محتوا را به هوش مصنوعی بسپارد.

  • PHP
  • WordPress
کد کوتاه
[netarz_ai_tickets]
<a href="#netarz-chat">گفت‌وگو با پشتیبانی</a>

افزونه رایگان است؛ هزینهٔ هوش مصنوعی به اندازهٔ مصرف از اعتبار «API هوش مصنوعی» نِت اَرز شما کم می‌شود.

صفحهٔ نِت اَرز در گیت‌هاب خلاصهٔ دو وب‌سرویس و فهرست همهٔ مخزن‌ها. مخزن تازه‌ای که منتشر کنیم، اول آن‌جا دیده می‌شود.

اگر به کارتان آمد، ستاره بدهید

ستارهٔ شما در گیت‌هاب به برنامه‌نویس‌های دیگر کمک می‌کند این نمونه‌ها را پیدا کنند. اگر نمونه‌ای کم است یا کدی بهتر نوشته‌اید، Issue یا Pull Request بفرستید.

دیدن مخزن‌ها

پرسش‌های رایج

این کدها رایگان‌اند؟

بله. نمونه‌کدها با مجوز MIT و افزونهٔ وردپرس با مجوز GPL نسخهٔ ۲ منتشر شده‌اند؛ می‌توانید در پروژهٔ شخصی یا تجاری از آن‌ها استفاده کنید و تغییرشان دهید. خود سرویس‌ها جدا حساب می‌شوند: API هوش مصنوعی مدل رایگان ندارد و با اعتباری کار می‌کند که به تومان می‌خرید، و API نرخ ارز طرح رایگانی دارد که با عضویت فعال می‌شود.

کلید API را از کجا بگیرم؟

کلید API هوش مصنوعی را در پنل /ai و کلید API نرخ ارز را در پنل /fx نِت اَرز می‌سازید. کلید کامل را فقط همان یک بار می‌بینید؛ آن را در متغیر محیطی نگه دارید و در گیت کامیت نکنید. در هیچ‌کدام از مخزن‌ها کلید واقعی نیست.

برای Claude هم همین کتابخانهٔ OpenAI کافی است؟

بله. Claude را با همان کتابخانهٔ OpenAI و شناسه‌ای که با openrouter/anthropic/ شروع می‌شود صدا می‌زنید؛ کتابخانهٔ Anthropic روی این نشانی کار نمی‌کند. نمونهٔ هر سازنده در پوشهٔ providers مخزن ai-api-examples است.

افزونهٔ وردپرس را از کجا نصب کنم؟

افزونه در مخزن افزونه‌های وردپرس نیست. فایل ZIP را از صفحهٔ گیت‌هاب آن دانلود کنید، از «افزونه‌ها ← افزودن ← بارگذاری افزونه» نصب و فعالش کنید، و در «تنظیمات ← NetArz FX» کلید API نرخ ارز را بگذارید.

اگر در کد اشکالی دیدم به کجا خبر بدهم؟

در بخش Issues همان مخزن در گیت‌هاب بنویسید. مشکل حساب، اعتبار یا کلید را با تیکت از پنل نِت اَرز بپرسید تا همکاران پشتیبانی بررسی کنند.

اشکال در کد را در بخش Issues همان مخزن بنویسید. برای حساب، اعتبار و کلید از صفحهٔ مستندات شروع کنید یا از پنل تیکت بزنید.