Text Models (LLM)openai

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

معرفی مدل o3 از OpenAI - ارائه شده توسط ای آی کار (AI-KAR)

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

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

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

مدل o3 از OpenAI، که توسط ای آی کار (AI-KAR) ارائه شده است، یکی از قدرتمندترین مدل‌های استدلالی موجود است. این مدل در زمینه‌های مختلف از جمله برنامه‌نویسی، ریاضیات، علوم، درک بصری و غیره عملکرد بسیار خوبی از خود نشان می‌دهد. o3 به طور خاص برای وظایف پیچیده‌ای که نیازمند استدلال چندلایه و پاسخ‌های غیربدیهی هستند، مناسب است. در ارزیابی‌های انجام شده بر روی مسائل چالش‌برانگیز و واقعی، o3 نسبت به مدل o1، ۲۰٪ خطاهای بحرانی کمتری دارد. این بهبود قابل توجه، o3 را به ابزاری ارزشمند برای کاربردهایی تبدیل می‌کند که دقت و قابلیت اطمینان در آن‌ها از اهمیت بالایی برخوردار است. مدل o3 با درک عمیق‌تری از زبان و توانایی استدلال قوی‌تر، قادر است پاسخ‌های دقیق‌تر و مرتبط‌تری را ارائه دهد. این مدل می‌تواند در حل مسائل پیچیده، تولید محتوای خلاقانه، و انجام وظایف تحلیلی به کاربران کمک کند. همچنین، o3 از قابلیت‌های پیشرفته‌ای در زمینه درک بصری برخوردار است که به آن امکان می‌دهد تصاویر و ویدیوها را به طور دقیق تحلیل کرده و اطلاعات مفیدی را از آن‌ها استخراج کند. این ویژگی، o3 را به ابزاری قدرتمند برای کاربردهایی مانند تشخیص اشیاء، تحلیل صحنه‌ها و تولید توضیحات تصویری تبدیل می‌کند. علاوه بر این، o3 از APIهای متنوعی پشتیبانی می‌کند که به توسعه‌دهندگان امکان می‌دهد به راحتی این مدل را در برنامه‌ها و سرویس‌های خود ادغام کنند. این APIها شامل پارامترهای مختلفی هستند که به کاربران امکان می‌دهند رفتار مدل را به طور دقیق تنظیم کرده و نتایج مورد نظر خود را به دست آورند. ای آی کار (AI-KAR) با ارائه مستندات جامع و پشتیبانی فنی قوی، به کاربران کمک می‌کند تا به بهترین نحو از قابلیت‌های o3 بهره‌مند شوند و از این مدل قدرتمند در پروژه‌های خود استفاده کنند. این مدل با توانایی‌های استثنایی خود، می‌تواند به عنوان یک ابزار کلیدی در حل مسائل پیچیده و پیشبرد اهداف مختلف مورد استفاده قرار گیرد.

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

پارامتر	نوع	توضیحات و مقادیر
model	stringRequired	نام مدلی که برای تولید پاسخ استفاده می‌شود. مقدار این پارامتر باید `openai/o3-2025-04-16` باشد. مقادیر مجاز (کلیک برای کپی):
messages	one of[]Required	لیستی از پیام‌ها که مکالمه را تا این لحظه تشکیل می‌دهند. بسته به مدلی که استفاده می‌کنید، انواع مختلفی از پیام‌ها (modalities) مانند متن، اسناد (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/o3-2025-04-16',
    'messages': [
        {
            'role': 'user',
            'content': 'Hello'
        }
    ]
}

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

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