راهنمای جامع استفاده از API ChatExperts

در دنیای امروز که هوش مصنوعی به سرعت در حال توسعه و گسترش است، نیاز به بسترهایی مانند ChatExperts که قابلیت دسترسی و مدیریت مدل‌های زبان بزرگ (LLM) را به صورت یکپارچه ارائه می‌دهند، بیش از پیش احساس می‌شود. در این پست وبلاگ، با نقاط پایانی API در ChatExperts آشنا می‌شویم و نحوه استفاده کامل از قابلیت‌های آن را بررسی می‌کنیم.

امنیت و احراز هویت

برای اطمینان از تعامل امن با API، احراز هویت لازم است. کاربران می‌توانند از طریق مکانیزم Bearer Token به API دسترسی پیدا کنند. برای دریافت کلید API خود، لطفاً در ChatExperts ثبت‌نام کرده و به Settings > Account > API Key مراجعه نمایید.

نقاط پایانی کلیدی API

بازیابی تمامی مدل‌ها

• نقطه پایانی: GET /api/models
• توضیحات: این نقطه پایانی به شما امکان می‌دهد تا تمام مدل‌های ایجاد شده یا اضافه شده از طریق ChatExperts را بازیابی کنید.

مثال در Curl:

curl -H "Authorization: Bearer YOUR_API_KEY" https://chat.binaexperts.com/api/models

تکمیل چت

• نقطه پایانی: POST /api/chat/completions
• توضیحات: این نقطه پایانی به عنوان یک API سازگار با OpenAI برای تکمیل چت با مدل‌های موجود در ChatExperts عمل می‌کند.

مثال در Curl:

curl -X POST https://chat.binaexperts.com/api/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
      "model": "llama3.1",
      "messages": [
        {
          "role": "user",
          "content": "چرا آسمان آبی است؟"
        }
      ]
    }'

پشتیبانی از پروکسی Ollama API

اگر می‌خواهید مستقیماً با مدل‌های Ollama تعامل داشته باشید (شامل تولید جاسازی یا جریان خام پرسش‌ها)، ChatExperts یک مسیر پروکسی شفاف به Ollama API ارائه می‌دهد.

تولید کامل‌سازی (جریان‌دار):

curl https://chat.binaexperts.com/ollama/api/generate -d '{
  "model": "llama3.2",
  "prompt": "چرا آسمان آبی است؟"
}'

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

curl https://chat.binaexperts.com/ollama/api/tags

تولید جاسازی‌ها:

curl -X POST https://chat.binaexperts.com/ollama/api/embed -d '{
  "model": "llama3.2",
  "input": ["ChatExperts بی‌نظیر است!", "بیایید جاسازی‌ها تولید کنیم."]
}'

تولید مبتنی بر بازیابی (RAG)

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

آپلود فایل‌ها:

• نقطه پایانی: POST /api/v1/files/

مثال در Curl:

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" -H "Accept: application/json" \
-F "file=@/path/to/your/file" https://chat.binaexperts.com/api/v1/files/

مثال در Python:

import requests

def upload_file(token, file_path):
    url = 'https://chat.binaexperts.com/api/v1/files/'
    headers = {
        'Authorization': f'Bearer {token}',
        'Accept': 'application/json'
    }
    files = {'file': open(file_path, 'rb')}
    response = requests.post(url, headers=headers, files=files)
    return response.json()

افزودن فایل‌ها به مجموعه دانش:

• نقطه پایانی: POST /api/v1/knowledge/{id}/file/add

مثال در Curl:

curl -X POST https://chat.binaexperts.com/api/v1/knowledge/{knowledge_id}/file/add \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"file_id": "your-file-id-here"}'

استفاده از فایل‌ها و مجموعه‌ها در تکمیل چت

استفاده از فایل منفرد:

• نقطه پایانی: POST /api/chat/completions

مثال در Curl:

curl -X POST https://chat.binaexperts.com/api/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
      "model": "gpt-4-turbo",
      "messages": [
        {"role": "user", "content": "مفاهیم موجود در این سند را توضیح دهید."}
      ],
      "files": [
        {"type": "file", "id": "your-file-id-here"}
      ]
    }'

استفاده از مجموعه دانش:

مثال در Curl:

curl -X POST https://chat.binaexperts.com/api/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
      "model": "gpt-4-turbo",
      "messages": [
        {"role": "user", "content": "دیدگاه‌های تاریخی موجود در مجموعه را ارائه دهید."}
      ],
      "files": [
        {"type": "collection", "id": "your-collection-id-here"}
      ]
    }'

مزایا و کاربردهای ChatExperts

ChatExperts به عنوان یک ارائه‌دهنده LLM یکپارچه، مزایای قابل توجهی برای توسعه‌دهندگان و کسب‌وکارها فراهم می‌کند:

• رابط کاربری یکپارچه: ایجاد ارتباطات ساده و کارآمد با LLM‌های مختلف از طریق یک پلتفرم.
• سهولت در پیاده‌سازی: ادغام سریع و بدون مشکلات با مستندات جامع و پشتیبانی فعال.
• تجربه کاربری بهتر: ارائه تجربه کاربری بهبود یافته برای توسعه‌دهندگان با استفاده از API‌های قدرتمند.