Skip to content

README.fa.md

Latest commit

 

History

History
295 lines (224 loc) · 9.71 KB

README.fa.md

File metadata and controls

295 lines (224 loc) · 9.71 KB

Rahyana AI API - مثال‌های کامل JavaScript برای توسعه‌دهندگان

این پوشه شامل مثال‌های کامل، کاربردی و آماده تولید برای استفاده از Rahyana AI API با JavaScript و Node.js است. با این مثال‌ها می‌توانید اپلیکیشن‌های هوش مصنوعی، چت‌بات‌ها، سیستم‌های تولید محتوا و ابزارهای کدنویسی بسازید.

فهرست مثال‌ها

1. chat-completions

چت کامپلیشن - مثال‌های کامل برای گفتگو با AI

  • basic-chat.js: چت ساده
  • streaming-chat.js: چت جریانی
  • image-analysis.js: تحلیل تصاویر
  • audio-processing.js: پردازش صدا
  • pdf-processing.js: پردازش PDF
  • web-search.js: جستجوی وب
  • tool-calling.js: فراخوانی ابزار
  • json-mode.js: حالت JSON

2. completions

تکمیل متن قدیمی - مثال‌های API completions

  • legacy-completions.js: تکمیل متن ساده و جریانی

3. models

مدل‌های موجود - دریافت و مدیریت مدل‌ها

  • get-models.js: دریافت لیست مدل‌ها

4. real-world-projects

پروژه‌های واقعی و کاربردی - پروژه‌های کامل آماده تولید

  • ai-content-generator.js: سیستم کامل تولید محتوای هوش مصنوعی برای بازاریابی دیجیتال
  • ai-chatbot.js: چت‌بات هوش مصنوعی پیشرفته با قابلیت‌های چندوجهی
  • ai-code-assistant.js: دستیار کدنویسی هوش مصنوعی برای توسعه‌دهندگان

5. advanced-examples

مثال‌های پیشرفته 2025 - تکنولوژی‌های نوآورانه و cutting-edge

  • ai-voice-assistant.js: دستیار صوتی هوش مصنوعی با تشخیص و تولید گفتار
  • ai-data-analyzer.js: تحلیل‌گر داده‌های هوش مصنوعی با تجسم و پیش‌بینی
  • ai-automation-suite.js: مجموعه اتوماسیون هوش مصنوعی برای فرآیندها
  • ai-web3-integration.js: ادغام Web3 و هوش مصنوعی برای بلاک‌چین

6. ai-testing

تست‌های هوش مصنوعی - تولید و اجرای تست‌های خودکار با AI

  • ai-test-generator.js: تولیدکننده تست‌های واحد، یکپارچگی و امنیتی

7. ai-monitoring

نظارت هوش مصنوعی - مانیتورینگ و تحلیل عملکرد با AI

  • ai-performance-monitor.js: مانیتور عملکرد و بهینه‌سازی خودکار

8. ai-docs

مستندات هوش مصنوعی - تولید مستندات خودکار با AI

  • ai-documentation-generator.js: تولیدکننده README، API docs و راهنماها

9. ai-review

بررسی کد هوش مصنوعی - بررسی کیفیت و امنیت کد با AI

  • ai-code-reviewer.js: بررسی‌کننده کد، امنیت و بهترین شیوه‌ها

10. ai-devops

DevOps هوش مصنوعی - اتوماسیون CI/CD و DevOps با AI

  • ai-cicd-assistant.js: دستیار CI/CD، Docker و Kubernetes

🚀 نصب و راه‌اندازی - شروع در 5 دقیقه

پیش‌نیازها

  • Node.js نسخه 14 یا بالاتر
  • کلید API معتبر از Rahyana - رایگان
  • npm یا yarn برای مدیریت پکیج‌ها

چرا Rahyana AI API؟

  • ✅ سازگار با OpenAI - جایگزین مستقیم OpenAI API
  • ✅ مدل‌های متنوع - GPT-5، GPT-4o، Claude، Gemini
  • ✅ قابلیت‌های پیشرفته - پردازش تصویر، صدا، جستجوی وب
  • ✅ آماده تولید - امنیت بالا، محدودیت نرخ، نظارت
  • ✅ مستندات کامل - راهنمای جامع و مثال‌های کاربردی

نصب

# کلون کردن پروژه
git clone https://github.com/rahyana/examples.git
cd examples/javascript

# نصب وابستگی‌ها (در صورت نیاز)
npm install

تنظیمات

// در فایل‌های مثال، این متغیرها را تغییر دهید
const API_KEY = 'YOUR_API_KEY_HERE';
const BASE_URL = 'https://rahyana.ir/api/v1';

اجرای مثال‌ها

مثال‌های چت کامپلیشن

# چت ساده
node chat-completions/basic-chat.js

# چت جریانی
node chat-completions/streaming-chat.js

# تحلیل تصویر
node chat-completions/image-analysis.js

# پردازش صدا
node chat-completions/audio-processing.js

# پردازش PDF
node chat-completions/pdf-processing.js

# جستجوی وب
node chat-completions/web-search.js

# فراخوانی ابزار
node chat-completions/tool-calling.js

# حالت JSON
node chat-completions/json-mode.js

مثال‌های دیگر

# تکمیل متن قدیمی
node completions/legacy-completions.js

# دریافت مدل‌ها
node models/get-models.js

# پروژه‌های واقعی
node real-world-projects/ai-content-generator.js
node real-world-projects/ai-chatbot.js
node real-world-projects/ai-code-assistant.js

# مثال‌های پیشرفته 2025
node advanced-examples/ai-voice-assistant.js
node advanced-examples/ai-data-analyzer.js
node advanced-examples/ai-automation-suite.js
node advanced-examples/ai-web3-integration.js

استفاده در پروژه‌های خود

Import کردن مثال‌ها

// Import کردن مثال‌های چت
const { basicChatCompletion } = require('./chat-completions/basic-chat');
const { analyzeImage } = require('./chat-completions/image-analysis');

// Import کردن مثال‌های مدل
const { getAvailableModels } = require('./models/get-models');

استفاده در کد

// چت ساده
const response = await basicChatCompletion();

// تحلیل تصویر
const analysis = await analyzeImage(imageFile);

// دریافت مدل‌ها
const models = await getAvailableModels();

ساختار پروژه

javascript/
├── chat-completions/          # مثال‌های چت کامپلیشن
│   ├── basic-chat.js
│   ├── streaming-chat.js
│   ├── image-analysis.js
│   ├── audio-processing.js
│   ├── pdf-processing.js
│   ├── web-search.js
│   ├── tool-calling.js
│   ├── json-mode.js
│   └── README.fa.md
├── completions/               # مثال‌های تکمیل متن قدیمی
│   ├── legacy-completions.js
│   └── README.fa.md
├── models/                    # مثال‌های مدل‌ها
│   ├── get-models.js
│   └── README.fa.md
└── README.fa.md              # این فایل

ویژگی‌های کلیدی

پشتیبانی کامل از API

  • ✅ چت کامپلیشن (متن، تصویر، صدا، PDF)
  • ✅ جستجوی وب
  • ✅ فراخوانی ابزار
  • ✅ حالت JSON
  • ✅ پاسخ‌های جریانی
  • ✅ تکمیل متن قدیمی
  • ✅ مدیریت مدل‌ها

مثال‌های کاربردی

  • چت‌بات‌های تعاملی
  • سیستم‌های تحلیل تصویر
  • رونویسی صوتی
  • پردازش اسناد
  • جستجوی اطلاعات
  • تولید محتوا

بهترین شیوه‌ها

  • مدیریت خطاها
  • اعتبارسنجی ورودی‌ها
  • بهینه‌سازی عملکرد
  • امنیت کلید API
  • لاگ‌گیری و نظارت

تنظیمات پیشنهادی

برای محیط توسعه

const BASE_URL = 'http://localhost:3000/api/v1';
const API_KEY = 'your_development_api_key';

برای محیط تولید

const BASE_URL = 'https://rahyana.ir/api/v1';
const API_KEY = process.env.RAHYANA_API_KEY;

تنظیمات پیشرفته

const config = {
  baseUrl: 'https://rahyana.ir/api/v1',
  apiKey: process.env.RAHYANA_API_KEY,
  timeout: 30000,
  retries: 3,
  rateLimit: 100 // درخواست در دقیقه
};

عیب‌یابی

مشکلات رایج

  1. خطای 401: کلید API نامعتبر است
  2. خطای 429: محدودیت نرخ درخواست
  3. خطای 400: درخواست نامعتبر
  4. خطای شبکه: مشکل اتصال

راه‌حل‌ها

// بررسی کلید API
const validation = await validateApiKey();
if (!validation.valid) {
  console.error('کلید API نامعتبر است');
}

// مدیریت محدودیت نرخ
if (error.message.includes('429')) {
  await new Promise(resolve => setTimeout(resolve, 60000)); // انتظار 1 دقیقه
}

// بررسی درخواست
if (error.message.includes('400')) {
  console.error('درخواست نامعتبر:', requestBody);
}

مشارکت

برای مشارکت در این پروژه:

  1. Fork کنید
  2. شاخه جدید ایجاد کنید
  3. تغییرات را commit کنید
  4. Pull request ارسال کنید

مجوز

این پروژه تحت مجوز MIT منتشر شده است.

پشتیبانی

برای سوالات و پشتیبانی: