Text Models (LLM)openai

معرفی و مستندات مدل هوش مصنوعی gpt-4o-mini-search-preview

مستندات مدل gpt-4o-mini-search-preview ارائه شده توسط ای آی کار (AI-KAR)

معرفی و بررسی فنی

⚡ وضعیت پشتیبانی از زبان فارسی

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

مدل gpt-4o-mini-search-preview یک مدل هوش مصنوعی تخصصی است که برای درک و اجرای درخواست‌های جستجوی وب با استفاده از API تکمیل چت آموزش داده شده است. این مدل به طور خاص برای تولید پاسخ‌های مرتبط و دقیق به سوالات کاربران از طریق جستجوی اطلاعات در وب طراحی شده است. این مدل می‌تواند به عنوان یک ابزار قدرتمند برای توسعه‌دهندگانی که به دنبال ادغام قابلیت‌های جستجوی وب در برنامه‌های خود هستند، مورد استفاده قرار گیرد.

نحوه استفاده:
برای استفاده از این مدل، ابتدا باید یک حساب کاربری در وب‌سایت ای آی کار (AI-KAR) ایجاد کنید. پس از ایجاد حساب، یک کلید API تولید کنید و اطمینان حاصل کنید که این کلید در رابط کاربری فعال است. سپس، کد نمونه ارائه شده را کپی کرده و کلید API خود را در محل مشخص شده جایگزین کنید. سوال یا درخواست خود را در فیلد `content` وارد کنید. در صورت نیاز، می‌توانید پارامترهای اختیاری دیگر را نیز تنظیم کنید تا رفتار مدل را سفارشی‌سازی کنید. پس از انجام این تنظیمات، کد را اجرا کنید و پاسخ مدل را دریافت کنید.

قابلیت‌ها:
مدل gpt-4o-mini-search-preview قادر است تا با دریافت یک سوال یا درخواست، به طور خودکار یک جستجوی وب انجام داده و اطلاعات مرتبط را جمع‌آوری کند. سپس، با استفاده از این اطلاعات، یک پاسخ دقیق و جامع به سوال کاربر ارائه می‌دهد. این مدل می‌تواند در زمینه‌های مختلفی مانند پاسخگویی به سوالات عمومی، ارائه اطلاعات تخصصی، و کمک به کاربران در یافتن راه‌حل‌های مشکلات خود مورد استفاده قرار گیرد.

مزایا:
استفاده از مدل gpt-4o-mini-search-preview دارای مزایای متعددی است. این مدل می‌تواند به طور قابل توجهی در زمان و تلاش کاربران صرفه‌جویی کند، زیرا نیازی به انجام جستجوی دستی در وب نیست. همچنین، این مدل می‌تواند اطلاعات دقیق و جامعی را ارائه دهد که ممکن است به راحتی از طریق جستجوی دستی در دسترس نباشد. علاوه بر این، این مدل می‌تواند به توسعه‌دهندگان کمک کند تا برنامه‌های هوشمندتر و کارآمدتری را ایجاد کنند.

محدودیت‌ها:
مانند هر مدل هوش مصنوعی دیگری، مدل gpt-4o-mini-search-preview نیز دارای محدودیت‌هایی است. این مدل ممکن است در برخی موارد نتواند پاسخ‌های دقیق یا کاملی را ارائه دهد، به خصوص اگر سوال یا درخواست کاربر بسیار پیچیده یا مبهم باشد. همچنین، این مدل ممکن است در برخی موارد اطلاعات نادرست یا قدیمی را ارائه دهد، زیرا اطلاعات وب به طور مداوم در حال تغییر است. با این حال، با استفاده از تکنیک‌های مناسب، می‌توان این محدودیت‌ها را کاهش داد و عملکرد مدل را بهبود بخشید.

مشخصات فنی (API References)

پارامترنوعتوضیحات و مقادیر
model
stringRequired
مدل مورد استفاده برای تکمیل چت. مقدار این پارامتر باید `gpt-4o-mini-search-preview` باشد.
مقادیر مجاز (کلیک برای کپی):
messages
one of[]Required
لیستی از پیام‌ها که مکالمه را تا این لحظه تشکیل می‌دهند. بسته به مدلی که استفاده می‌کنید، انواع مختلف پیام ( modalities ) مانند متن، اسناد ( txt, pdf )، تصاویر و صدا پشتیبانی می‌شوند.
max_tokens
number
حداکثر تعداد توکن‌هایی که می‌توانند در تکمیل چت تولید شوند. این مقدار می‌تواند برای کنترل هزینه‌های متن تولید شده از طریق API استفاده شود.
stream
boolean
اگر روی True تنظیم شود، داده‌های پاسخ مدل به صورت جریانی (stream) به کلاینت ارسال می‌شوند، به این صورت که هر زمان تولید شدند، با استفاده از رویدادهای ارسال شده از سرور (server-sent events) ارسال می‌شوند.
stream_options
object
تنظیمات مربوط به استریم کردن پاسخ.

نمونه کدهای درخواست

نکته مهم برای توسعه‌دهندگان:

برای احراز هویت، حتما کلید API خود را جایگزین YOUR_API_KEY کنید. هدر Authorization الزامی است.

import requests
import json  # for getting a structured output with indentation
response = requests.post(
    "https://api.ai-kar.com/v1/chat/completions",
    headers={
        # Insert your AI-KAR API Key instead of <YOUR_AI-KARAPI_KEY>:
        "Authorization":"Bearer <YOUR_AI-KARAPI_KEY>",
        "Content-Type":"application/json"
    },
    json={
        "model":"gpt-4o-mini-search-preview",
        "messages":[
            {
                "role":"user",
                "content":"Hello"  # insert your prompt here, instead of Hello
            }
        ]
    }
)
data = response.json()
print(json.dumps(data, indent=2, ensure_ascii=False))

نمونه پاسخ موفق (JSON)

RESPONSE (200 OK)
{
  "id": "text",
  "object": "text",
  "created": 1,
  "choices": [
    {
      "index": 1,
      "message": {
        "role": "text",
        "content": "text",
        "refusal": null,
        "annotations": [
          {
            "type": "text",
            "url_citation": {
              "end_index": 1,
              "start_index": 1,
              "title": "text",
              "url": "text"
            }
          }
        ],
        "audio": {
          "id": "text",
          "data": "text",
          "transcript": "text",
          "expires_at": 1
        },
        "tool_calls": [
          {
            "id": "text",
            "type": "text",
            "function": {
              "arguments": "text",
              "name": "text"
            }
          }
        ]
      },
      "finish_reason": "stop",
      "logprobs": {
        "content": [
          {
            "bytes": [
              1
            ],
            "logprob": 1,
            "token": "text",
            "top_logprobs": [
              {
                "bytes": [
                  1
                ],
                "logprob": 1,
                "token": "text"
              }
            ]
          }
        ],
        "refusal": []
      }
    }
  ],
  "model": "text",
  "usage": {
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "total_tokens": 1,
    "completion_tokens_details": {
      "accepted_prediction_tokens": 1,
      "audio_tokens": 1,
      "reasoning_tokens": 1,
      "rejected_prediction_tokens": 1
    },
    "prompt_tokens_details": {
      "audio_tokens": 1,
      "cached_tokens": 1
    }
  }
}