Text Models (LLM)openai

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

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

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

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

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

مدل o3-pro از OpenAI، که توسط ای آی کار (AI-KAR) ارائه شده است، برای استدلال عمیق‌تر و پاسخگویی به سوالات دشوارتر طراحی شده است. این مدل با استفاده از قدرت محاسباتی بیشتر، پاسخ‌هایی با کیفیت بالاتر ارائه می‌دهد. o3-pro تنها از طریق API `/responses` قابل دسترسی است، که از تعاملات چند نوبتی مدل پشتیبانی می‌کند و امکانات پیشرفته‌تری را در آینده فراهم خواهد کرد. توجه داشته باشید که برخی از درخواست‌های پیچیده ممکن است چند دقیقه طول بکشد. برای استفاده از این مدل، ابتدا باید یک حساب کاربری در وب‌سایت ای آی کار (AI-KAR) ایجاد کنید و یک کلید API تولید کنید. سپس، می‌توانید از نمونه کد ارائه شده در این مستندات استفاده کنید و کلید API خود را جایگزین کنید. همچنین، می‌توانید سوال یا درخواست خود را در فیلد `input` وارد کنید. مدل o3-pro برای درک و پاسخگویی به سوالات پیچیده و نیازمند استدلال طراحی شده است. این مدل قادر است متون، تصاویر و فایل‌ها را به عنوان ورودی دریافت کرده و پاسخ‌های مرتبط و دقیق ارائه دهد. با استفاده از API `/responses`، می‌توانید تعاملات چند نوبتی با مدل داشته باشید و از امکانات پیشرفته آن بهره‌مند شوید. این مدل به طور خاص برای پاسخگویی به سوالات دشوار و نیازمند استدلال عمیق طراحی شده است و می‌تواند در زمینه‌های مختلفی مانند تحقیق، توسعه، و پشتیبانی مشتری مورد استفاده قرار گیرد. یکی از ویژگی‌های برجسته مدل o3-pro، توانایی آن در درک و پردازش زبان‌های مختلف است. این مدل قادر است متون را به زبان‌های مختلف ترجمه کرده و پاسخ‌هایی به زبان مورد نظر ارائه دهد. این ویژگی به کاربران امکان می‌دهد تا از مدل در سطح جهانی استفاده کنند و با مخاطبان مختلف ارتباط برقرار کنند. همچنین، مدل o3-pro از قابلیت‌های پیشرفته‌ای برای تشخیص و تصحیح خطاها برخوردار است. این مدل قادر است خطاهای املایی و گرامری را در متون ورودی تشخیص داده و آن‌ها را به طور خودکار تصحیح کند. این ویژگی به کاربران کمک می‌کند تا متون با کیفیت‌تری تولید کنند و از بروز اشتباهات جلوگیری کنند. در نهایت، مدل o3-pro یک ابزار قدرتمند و کارآمد برای پاسخگویی به سوالات دشوار و نیازمند استدلال است. این مدل با استفاده از قدرت محاسباتی بالا و الگوریتم‌های پیشرفته، پاسخ‌هایی با کیفیت بالا و دقیق ارائه می‌دهد و می‌تواند در زمینه‌های مختلفی مورد استفاده قرار گیرد.

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

پارامتر	نوع	توضیحات و مقادیر
model	stringRequired	مدلی که برای تولید پاسخ استفاده می‌شود. مقادیر مجاز (کلیک برای کپی):
input	any ofRequired	ورودی متن، تصویر یا فایل به مدل، که برای تولید پاسخ استفاده می‌شود.
include	string · enum[]	مشخص کنید که چه داده‌های خروجی اضافی در پاسخ مدل گنجانده شوند. مقادیر پشتیبانی شده در حال حاضر عبارتند از: مقادیر مجاز (کلیک برای کپی):
max_output_tokens	integer	حد بالایی برای تعداد توکن‌هایی که می‌توان برای یک پاسخ تولید کرد، از جمله توکن‌های خروجی قابل مشاهده و توکن‌های استدلال.
previous_response_id	string	شناسه یکتای پاسخ قبلی به مدل. از این برای ایجاد مکالمات چند نوبتی استفاده کنید.
prompt	object	ارجاع به یک قالب prompt و متغیرهای آن.
store	boolean	اینکه آیا پاسخ مدل تولید شده برای بازیابی بعدی از طریق API ذخیره شود یا خیر.
stream	boolean	اگر روی true تنظیم شود، داده‌های پاسخ مدل به صورت جریانی به کلاینت ارسال می‌شوند، زیرا با استفاده از رویدادهای ارسال شده توسط سرور تولید می‌شوند.
text	object	گزینه‌های پیکربندی برای یک پاسخ متنی از مدل. می‌تواند متن ساده یا داده‌های JSON ساختاریافته باشد.
truncation	string · enum	استراتژی برش برای استفاده در پاسخ مدل. مقادیر مجاز (کلیک برای کپی):
tools	one of[]	آرایه‌ای از ابزارهایی که مدل ممکن است هنگام تولید پاسخ فراخوانی کند. می‌توانید با تنظیم پارامتر tool_choice مشخص کنید که از کدام ابزار استفاده شود.
tool_choice	any of	نحوه انتخاب ابزار (یا ابزارها) توسط مدل هنگام تولید پاسخ.

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

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

برای احراز هویت، حتما کلید 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/responses",
    headers={
        "Content-Type":"application/json",
        # Insert your AI-KAR API Key instead of <YOUR_AI-KARAPI_KEY>:
        "Authorization":"Bearer <YOUR_API_KEY>",
        "Content-Type":"application/json"
    },
    json={
        "model":"openai/o3-pro",
        "input":"Hello"  # Insert your question for the model here, instead of Hello
    }
)
data = response.json()
print(json.dumps(data, indent=2, ensure_ascii=False))

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

RESPONSE (200 OK)

{
  "id": "resp_686ba45ce63481a2a4b1fad55d2bea8102a1cc22f1a1bcf1",
  "object": "response",
  "created_at": 1751884892,
  "error": null,
  "incomplete_details": null,
  "instructions": null,
  "max_output_tokens": 512,
  "model": "o3-pro-2025-06-10",
  "output": [
    {
      "id": "rs_686ba463d18481a29dde85cfd7b055bf02a1cc22f1a1bcf1",
      "type": "reasoning",
      "summary": []
    },
    {
      "id": "msg_686ba463d4e081a2b2e2aff962ab00f702a1cc22f1a1bcf1",
      "type": "message",
      "status": "in_progress",
      "content": [
        {
          "type": "output_text",
          "annotations": [],
          "logprobs": [],
          "text": "Hello! How can I help you today?"
        }
      ],
      "role": "assistant"
    }
  ],
  "parallel_tool_calls": true,
  "previous_response_id": null
}