Text Models (LLM)openai

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

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

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

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

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

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

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

برای استفاده از o4-mini، ابتدا باید یک حساب کاربری در وب‌سایت ای آی کار (AI-KAR) ایجاد کنید و یک کلید API دریافت کنید. سپس، می‌توانید از طریق API به مدل دسترسی پیدا کنید و درخواست‌های خود را ارسال کنید. API از فرمت JSON برای ارسال و دریافت داده‌ها استفاده می‌کند و به راحتی می‌توان آن را با زبان‌های برنامه‌نویسی مختلف ادغام کرد. ای آی کار (AI-KAR) مستندات کاملی را برای API ارائه کرده است که شامل نمونه کدها و توضیحات مفصل در مورد پارامترهای مختلف است.

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

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

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

پارامتر	نوع	توضیحات و مقادیر
model	stringRequired	شناسه مدل مورد استفاده برای تولید پاسخ. مقادیر مجاز (کلیک برای کپی):
messages	one of[]Required	لیستی از پیام‌ها که مکالمه را تا کنون تشکیل می‌دهند. بسته به مدلی که استفاده می‌کنید، انواع مختلف پیام (حالت‌ها) مانند متن، اسناد (txt، pdf)، تصاویر و صدا پشتیبانی می‌شوند.
max_completion_tokens	integer	حد بالایی برای تعداد توکن‌هایی که می‌توان برای تکمیل تولید کرد، از جمله توکن‌های خروجی قابل مشاهده و توکن‌های استدلال.
max_tokens	number	حداکثر تعداد توکن‌هایی که می‌توان در تکمیل چت تولید کرد. این مقدار می‌تواند برای کنترل هزینه‌های متن تولید شده از طریق API استفاده شود.
stream	boolean	اگر روی True تنظیم شود، داده‌های پاسخ مدل با استفاده از رویدادهای ارسال شده توسط سرور به صورت جریانی به کلاینت ارسال می‌شوند.
stream_options	object	تنظیمات مربوط به استریم کردن پاسخ.
tools	object[]	لیستی از ابزارهایی که مدل ممکن است فراخوانی کند. در حال حاضر، فقط توابع به عنوان ابزار پشتیبانی می‌شوند. از این برای ارائه لیستی از توابعی که مدل ممکن است ورودی‌های JSON را برای آن‌ها تولید کند، استفاده کنید. حداکثر 128 تابع پشتیبانی می‌شود.
tool_choice	any of	کنترل می‌کند که کدام ابزار (در صورت وجود) توسط مدل فراخوانی شود. none به این معنی است که مدل هیچ ابزاری را فراخوانی نمی‌کند و در عوض یک پیام تولید می‌کند. auto به این معنی است که مدل می‌تواند بین تولید یک پیام یا فراخوانی یک یا چند ابزار انتخاب کند. required به این معنی است که مدل باید یک یا چند ابزار را فراخوانی کند. تعیین یک ابزار خاص از طریق {"type": "function", "function": {"name": "my_function"}} مدل را مجبور می‌کند که آن ابزار را فراخوانی کند. مقادیر مجاز (کلیک برای کپی):
n	integer	تعداد انتخاب‌های تکمیل چت که برای هر پیام ورودی باید تولید شود. توجه داشته باشید که هزینه بر اساس تعداد توکن‌های تولید شده در تمام انتخاب‌ها محاسبه می‌شود. مقدار n را 1 نگه دارید تا هزینه‌ها به حداقل برسد.
seed	integer	اگر مشخص شود، سیستم ما تمام تلاش خود را می‌کند تا به طور قطعی نمونه‌برداری کند، به طوری که درخواست‌های مکرر با همان seed و پارامترها باید نتیجه یکسانی را برگردانند.
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': 'openai/o4-mini-2025-04-16',
    'messages': [
        {
            'role': 'user',
            'content': 'Hello'
        }
    ]
}

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

if response.status_code == 200:
    print(json.dumps(response.json(), indent=2))
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
    }
  }
}