Text Models (LLM)openai

معرفی و مستندات مدل هوش مصنوعی o3-mini

مستندات مدل o3-mini ارائه شده توسط ای آی کار (AI-KAR)

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

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

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

مدل o3-mini یک مدل هوش مصنوعی پیشرفته است که برای انجام وظایف پیچیده استدلال طراحی شده است. این مدل در حل مسائل ریاضی، چالش‌های برنامه‌نویسی و تحقیقات علمی بسیار عالی عمل می‌کند. o3-mini با بهره‌گیری از قابلیت‌های استدلال پیشرفته، قادر است مسائل را به صورت منطقی تجزیه و تحلیل کرده و راه‌حل‌های مناسبی ارائه دهد. این مدل به ویژه برای کاربردهایی که نیاز به تفکر عمیق و استدلال منطقی دارند، مناسب است.

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

o3-mini در زمینه‌های مختلفی کاربرد دارد. در حوزه آموزش، این مدل می‌تواند به عنوان یک معلم خصوصی عمل کرده و به دانش‌آموزان در یادگیری مفاهیم پیچیده کمک کند. در حوزه تجارت، o3-mini می‌تواند به تحلیل داده‌های بازار و پیش‌بینی روندهای آینده کمک کند. در حوزه تحقیقات علمی، این مدل می‌تواند به دانشمندان در تجزیه و تحلیل داده‌های آزمایشگاهی و کشف الگوهای جدید کمک کند.

برای استفاده از o3-mini، کاربران می‌توانند از طریق API ارائه شده توسط ای آی کار (AI-KAR) به این مدل دسترسی پیدا کنند. API این مدل به کاربران امکان می‌دهد تا به راحتی درخواست‌های خود را ارسال کرده و پاسخ‌های مورد نظر را دریافت کنند. همچنین، ای آی کار (AI-KAR) مستندات کاملی را برای استفاده از API این مدل ارائه کرده است که به کاربران کمک می‌کند تا به سرعت و به آسانی با نحوه استفاده از این مدل آشنا شوند.

o3-mini به طور مداوم در حال بهبود و توسعه است. تیم توسعه‌دهنده ای آی کار (AI-KAR) به طور پیوسته در حال اضافه کردن ویژگی‌های جدید و بهبود عملکرد این مدل است. هدف از این توسعه‌ها، ارائه یک مدل هوش مصنوعی قدرتمند و کارآمد است که بتواند نیازهای مختلف کاربران را برآورده کند. با استفاده از o3-mini، کاربران می‌توانند به راحتی مسائل پیچیده را حل کرده و به نتایج دقیق و قابل اعتمادی دست یابند. این مدل یک ابزار قدرتمند برای هر کسی است که به دنبال استفاده از هوش مصنوعی برای حل مسائل و بهبود عملکرد خود است.

یکی دیگر از قابلیت‌های مهم o3-mini، توانایی آن در تولید محتوای خلاقانه است. این مدل می‌تواند متون، تصاویر و حتی موسیقی تولید کند. این ویژگی به کاربران امکان می‌دهد تا از o3-mini برای تولید محتوای جذاب و منحصر به فرد استفاده کنند. به عنوان مثال، یک شرکت تبلیغاتی می‌تواند از o3-mini برای تولید شعارهای تبلیغاتی جذاب و یک نویسنده می‌تواند از این مدل برای نوشتن داستان‌های خلاقانه استفاده کند.

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

پارامتر	نوع	توضیحات و مقادیر
model	stringRequired	شناسه مدل مورد استفاده برای تولید پاسخ. مقدار این پارامتر باید 'o3-mini' باشد. مقادیر مجاز (کلیک برای کپی):
messages	one of[]Required	لیستی از پیام‌ها که مکالمه را تا کنون تشکیل می‌دهند. بسته به مدلی که استفاده می‌کنید، انواع مختلف پیام‌ها (modalities) مانند متن، اسناد (txt, pdf)، تصاویر و صدا پشتیبانی می‌شوند.
max_completion_tokens	integer	حد بالایی برای تعداد توکن‌هایی که می‌توانند برای یک تکمیل تولید شوند، از جمله توکن‌های خروجی قابل مشاهده و توکن‌های استدلال. حداقل مقدار: 1
max_tokens	number	حداکثر تعداد توکن‌هایی که می‌توانند در تکمیل چت تولید شوند. این مقدار می‌تواند برای کنترل هزینه‌ها برای متن تولید شده از طریق API استفاده شود. حداقل مقدار: 1
stream	boolean	اگر روی True تنظیم شود، داده‌های پاسخ مدل به صورت جریانی با استفاده از رویدادهای ارسال شده توسط سرور به کلاینت ارسال می‌شوند. مقدار پیش‌فرض: false
stream_options	object	تنظیمات مربوط به استریم کردن داده ها.
tools	object[]	لیستی از ابزارهایی که مدل ممکن است فراخوانی کند. در حال حاضر، فقط توابع به عنوان ابزار پشتیبانی می‌شوند. از این برای ارائه لیستی از توابعی استفاده کنید که مدل ممکن است ورودی‌های JSON را برای آنها تولید کند. حداکثر 128 تابع پشتیبانی می‌شود.
tool_choice	any of	کنترل می‌کند که کدام ابزار (در صورت وجود) توسط مدل فراخوانی شود. none به این معنی است که مدل هیچ ابزاری را فراخوانی نمی‌کند و به جای آن یک پیام تولید می‌کند. auto به این معنی است که مدل می‌تواند بین تولید یک پیام یا فراخوانی یک یا چند ابزار انتخاب کند. required به این معنی است که مدل باید یک یا چند ابزار را فراخوانی کند. تعیین یک ابزار خاص از طریق {"type": "function", "function": {"name": "my_function"}} مدل را مجبور می‌کند تا آن ابزار را فراخوانی کند. none مقدار پیش‌فرض است زمانی که هیچ ابزاری وجود نداشته باشد. auto مقدار پیش‌فرض است اگر ابزارها وجود داشته باشند. مقادیر مجاز (کلیک برای کپی):
n	integer	تعداد انتخاب‌های تکمیل چت که برای هر پیام ورودی تولید می‌شود. توجه داشته باشید که هزینه شما بر اساس تعداد توکن‌های تولید شده در تمام انتخاب‌ها محاسبه می‌شود. برای به حداقل رساندن هزینه‌ها، n را 1 نگه دارید.
stop	any of	حداکثر 4 دنباله که API تولید توکن‌های بیشتر را متوقف می‌کند. متن برگشتی شامل دنباله توقف نخواهد بود.
seed	integer	این ویژگی در نسخه بتا است. اگر مشخص شود، سیستم ما تمام تلاش خود را می‌کند تا به صورت قطعی نمونه‌برداری کند، به طوری که درخواست‌های مکرر با همان seed و پارامترها باید نتیجه یکسانی را برگردانند. حداقل مقدار: 1
reasoning_effort	string	تلاش برای استدلال را برای مدل‌های استدلال محدود می‌کند. مقادیر پشتیبانی شده در حال حاضر عبارتند از low، medium و high. کاهش تلاش استدلال می‌تواند منجر به پاسخ‌های سریع‌تر و توکن‌های کمتری شود که در استدلال در یک پاسخ استفاده می‌شوند. مقادیر مجاز (کلیک برای کپی):
response_format	one of	یک شیء که فرمتی را مشخص می‌کند که مدل باید خروجی دهد.

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

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

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

import requests
import json

url = 'https://api.ai-kar.com/v1/chat/completions'
headers = {
    'Authorization': 'Bearer <YOUR_AI-KARAPI_KEY>',
    'Content-Type': 'application/json'
}
data = {
    'model': 'o3-mini',
    'messages': [
        {
            'role': 'user',
            'content': 'Hello'
        }
    ]
}

response = requests.post(url, headers=headers, data=json.dumps(data))

if response.status_code == 200:
    print(response.json())
else:
    print(f'Error: {response.status_code}')
    print(response.text)

نمونه پاسخ موفق (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
    }
  }
}