Responses API

Responses API آشا دسترسی سازگار با OpenAI به چند مدل را از طریق یک رابط یکپارچه فراهم می‌کند و به‌عنوان جایگزینی یک‌به‌یک برای Responses API OpenAI طراحی شده است. این API بدون وضعیت، قابلیت‌های پیشرفته‌ای شامل استدلال، فراخوانی ابزار و یکپارچگی با جست‌وجوی وب ارائه می‌دهد؛ هر درخواست مستقل است و هیچ حالتی در سمت سرور ذخیره نمی‌شود.

Base URL

https://app.asha-ai.ir/v1/responses

احراز هویت

همهٔ درخواست‌ها نیاز به احراز هویت با کلید API آشا دارند:

const response = await fetch('https://app.asha-ai.ir/v1/responses', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <ASHA_API_KEY>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/o4-mini',
    input: 'Hello, world!',
  }),
});

import requests

response = requests.post(
    'https://app.asha-ai.ir/v1/responses',
    headers={
        'Authorization': 'Bearer <ASHA_API_KEY>',
        'Content-Type': 'application/json',
    },
    json={
        'model': 'openai/o4-mini',
        'input': 'Hello, world!',
    }
)

curl -X POST https://app.asha-ai.ir/v1/responses 
  -H "Authorization: Bearer $ASHA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "model": "openai/o4-mini",
    "input": "Hello, world!"
  }'

ویژگی‌های اصلی

کاربرد پایه

اصول کار با درخواست‌های سادهٔ متنی و مدیریت پاسخ‌ها را بیاموزید.

استدلال

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

فراخوانی ابزار

فراخوانی تابع را با پشتیبانی از اجرای موازی و تعاملات پیچیدهٔ ابزار یکپارچه کنید.

جست‌وجوی وب

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

مدیریت خطا

API پاسخ‌های خطای ساختاریافته برمی‌گرداند:

{
  "error": {
    "code": "invalid_prompt",
    "message": "Missing required parameter: 'model'."
  },
  "metadata": null
}

برای راهنمایی جامع در مورد مدیریت خطا، بخش Error Handling را ببینید.

محدودیت نرخ

محدودیت‌های نرخ استاندارد آشا اعمال می‌شوند. برای جزئیات بیشتر، بخش API Limits را ببینید.