مدل‌ها

فهرست مدل‌ها

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

GET/v1/models

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

بدنه‌ی هر مدل، فیلدهای OpenAI (id، object، created، owned_by) و فیلدهای Anthropic (type، display_name، created_at) را کنار هم دارد تا کتابخانه‌های هر دو قالب کار کنند. فیلدهای اضافه‌ی وان ای آی kind، capabilities، context_window، max_output_tokens، architecture، knowledge_cutoff و pricing هستند. pricing نقشه‌ی «واحد به اعتبار» است، مثل input_1k برای هر هزار توکن ورودی. اعتبار را ببینید.

فهرست صفحه‌بندی ساده دارد: limit تعداد را محدود می‌کند و after_id از بعد از یک مدل ادامه می‌دهد. has_more می‌گوید باز هم مدل هست و last_id را برای after_id بعدی بردارید. ترتیب فهرست ثابت است.

نمونه‌ها

curl "https://1ai.ir/v1/models?kind=chat&capability=tools&limit=2" \
  -H "Authorization: Bearer $ONEAI_API_KEY"
200پاسخ
{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-6-luna",
      "object": "model",
      "type": "model",
      "display_name": "GPT-6 Luna",
      "description": "A fast general model.",
      "created_at": "2026-01-01T00:00:00.000Z",
      "created": 1767225600,
      "owned_by": "openai",
      "name": "GPT-6 Luna",
      "kind": "chat",
      "capabilities": [
        "tools",
        "vision",
        "decisions"
      ],
      "context_window": 400000,
      "max_output_tokens": 64000,
      "architecture": {
        "input_modalities": [
          "text",
          "image"
        ],
        "output_modalities": [
          "text"
        ]
      },
      "knowledge_cutoff": "2026-03",
      "pricing": {
        "input_1k": 0.5,
        "output_1k": 2,
        "cached_input_1k": 0.05
      }
    },
    {
      "id": "anthropic/claude-haiku-5.5",
      "object": "model",
      "type": "model",
      "display_name": "Claude Haiku 5.5",
      "description": "A small, quick model.",
      "created_at": "2026-01-01T00:00:00.000Z",
      "created": 1767225600,
      "owned_by": "anthropic",
      "name": "Claude Haiku 5.5",
      "kind": "chat",
      "capabilities": [
        "tools",
        "vision"
      ],
      "context_window": 200000,
      "max_output_tokens": 32000,
      "architecture": {
        "input_modalities": [
          "text",
          "image"
        ],
        "output_modalities": [
          "text"
        ]
      },
      "knowledge_cutoff": "2026-02",
      "pricing": {
        "input_1k": 0.3,
        "output_1k": 1.5
      }
    }
  ],
  "has_more": true,
  "first_id": "openai/gpt-6-luna",
  "last_id": "anthropic/claude-haiku-5.5"
}

پارامترهای کوئری

  • kindstring

    فقط مدل‌های این نوع. مثلاً chat، image، embedding، tts، stt، video، music، rerank، moderation، ocr.

  • capabilitystring

    فقط مدل‌هایی که این توانایی را دارند، مثل tools یا vision.

  • limitinteger

    حداکثر تعداد مدل در پاسخ. عدد صحیح مثبت. بدون آن همه‌ی مدل‌ها (از after_id به بعد) می‌آیند.

  • after_idstring

    شناسه‌ی مدلی که فهرست از بعد از آن ادامه می‌یابد. اگر در فهرست نباشد، از ابتدا شروع می‌شود.

خطاها

  • invalid_api_key401

    کلید نامعتبر، لغوشده یا منقضی است.

صفحه‌های مرتبط