مدل‌ها

دریافت یک مدل

مشخصات یک مدل با شناسه‌ی آن، شامل توانایی‌ها، محدودیت‌ها و قیمت. شناسه با اسلش نوشته می‌شود، مثل openai/gpt-6-luna.

GET/v1/models/{slug}

شناسه‌ی مدل شامل نام سازنده و یک اسلش است (openai/gpt-6-luna). اسلش را همان‌طور در مسیر بنویسید؛ لازم نیست کدگذاری شود. حروف بزرگ و کوچک مهم نیستند و پاسخ همیشه شناسه‌ی استاندارد مدل را می‌دهد.

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

برای کلیدهای Anthropic، نام‌های claude-sonnet-5-5 یا claude-sonnet-5-5-20260301 هم به anthropic/claude-sonnet-5.5 تبدیل می‌شوند.

نمونه‌ها

curl https://1ai.ir/v1/models/openai/gpt-6-luna \
  -H "Authorization: Bearer $ONEAI_API_KEY"
200پاسخ
{
  "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
  }
}

پارامترهای مسیر

  • slugstringالزامی

    شناسه‌ی مدل با نام سازنده، مثل anthropic/claude-sonnet-5.5. اسلش جزء شناسه است.

خطاها

  • invalid_api_key401

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

  • model_not_found404

    چنین مدلی نیست یا کلید شما به آن دسترسی ندارد.

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