مدل‌ها، قابلیت‌ها و قیمت

فهرست مدل‌های دات‌هوش پویا است: با هر درخواست از خود سرویس می‌پرسید «الان چه چیزی برای من در دسترس است؟». هیچ فهرست ثابتی وجود ندارد که در مستندات بنویسیم و بعد از کد عقب بیفتد.

گرفتن فهرست

curl "https://gateway.dothoosh.com/v1/models" \
  -H "Authorization: Bearer $DOTHOOSH_API_KEY"

پاسخ برای همین key ساخته می‌شود، پس مدلی که در فهرست نمی‌بینید برای این key مجاز یا قابل مسیردهی نیست. ساختار پاسخ:

{
  "object": "list",
  "catalog_version": "…",
  "data": [
    {
      "id": "…",
      "object": "model",
      "created": 1774000000,
      "owned_by": "dothoosh",
      "model_revision": "…",
      "status": "active",
      "capabilities": ["text", "streaming", "tools"],
      "protocols": [
        {
          "protocol": "openai-chat-completions",
          "conformance_status": "verified",
          "last_verified_at": "2026-09-20T00:00:00Z",
          "expires_at": "2026-12-19T00:00:00Z"
        }
      ],
      "context_window": 200000,
      "max_output_tokens": 64000,
      "policy": {
        "dothoosh_content_retention": "zero",
        "provider_retention": "provider-policy",
        "provider_training": "provider-policy",
        "provider_visibility": "hidden",
        "processing_regions": []
      }
    }
  ]
}

فیلدهای هر مدل

قابلیت‌ها

قابلیتی که در این فهرست نیست، برای این مدل قابل استفاده نیست: درخواستش با unsupported_capability رد می‌شود، نه اینکه بی‌صدا نادیده گرفته شود.

وضعیت چرخهٔ عمر

مدلی که در وضعیت unavailable، deprecated، removal-scheduled یا حذف‌شده باشد مسیردهی نمی‌شود. فراخوانی آن با model_temporarily_unavailable یا model_deprecated_scheduled_or_removed رد می‌شود.

پروتکل‌ها و تأیید

هر مدل فقط برای پروتکل‌هایی که تأیید شده‌اند سرو می‌شود. یک مدل می‌تواند روی openai-chat-completions تأیید شده باشد و روی anthropic-messages نه؛ در آن حالت مسیر Anthropic برای آن مدل باز نیست. مقدار protocols[].conformance_status همیشه verified است؛ تأیید منقضی یا لغوشده اصلاً منتشر نمی‌شود.

قیمت

قیمت به‌ازای هر میلیون توکن و به تومان، جدا از فهرست مدل‌ها منتشر می‌شود و با شناسهٔ مدل به آن وصل می‌شود: قیمت‌ها. هر قیمت نسخه دارد؛ درخواست شما با نسخهٔ معتبر در لحظهٔ شروع قیمت‌گذاری و رزرو می‌شود.

خطاهای مربوط به مدل

مطالب مرتبط

• مسیردهی و تلاش مجدد
• محدودیت‌ها
• حریم خصوصی و سیاست ارائه‌دهنده