نقاط النهاية

النماذج

استخدم GET /models لعرض كل النماذج المتاحة في api14 مع فئتها وطول سياقها والمعاملات المدعومة وأسعارها بالدولار، مع التصفية بالفئة.

اعرض قائمة بكل نموذج يمكنك استدعاؤه، مع فئته وطول سياقه وأنماطه (modalities) والمعاملات التي يدعمها وأسعاره بالدولار الأمريكي. تستخدم القائمة صيغة GET /models الخاصة بـ OpenAI إضافةً إلى حقول إضافية، لذا يعمل client.models.list().

لا يلزم مفتاح API لنقاط نهاية قائمة النماذج. تُخزَّن الاستجابات مؤقتًا لمدة 5 دقائق.

عرض قائمة النماذج

GET https://api14.com/api/v1/models

معامل الاستعلام	الوصف
`category`	التصفية حسب الفئة: `text` أو `image` أو `video` أو `speech` أو `transcription` أو `audio` أو `embeddings` أو `rerank` أو `decisions` أو `all`.
`output_modalities`	اسم بديل لـ `category`.

curl https://api14.com/api/v1/models
curl "https://api14.com/api/v1/models?category=image"

الاستجابة

{
  "object": "list",
  "data": [
    {
      "id": "anthropic/claude-sonnet-4.5",
      "object": "model",
      "created": 1758672000,
      "owned_by": "anthropic",
      "name": "Anthropic: Claude Sonnet 4.5",
      "description": "Anthropic's most capable Sonnet model...",
      "category": "text",
      "context_length": 1000000,
      "architecture": {
        "input_modalities": ["text", "image", "file"],
        "output_modalities": ["text"]
      },
      "pricing": {
        "prompt": "0.000003",
        "completion": "0.000015",
        "input_cache_read": "0.0000003",
        "input_cache_write": "0.00000375"
      },
      "supported_parameters": ["tools", "tool_choice", "reasoning", "max_tokens", "temperature"],
      "endpoint": "/api/v1/chat/completions"
    }
  ]
}

الحقل	الوصف
`id`	معرّف النموذج الذي ترسله في `model` بصيغة `provider/model`. راجع معرّفات النماذج.
`category`	الفئة الأساسية، وهي التي تحدد نقطة النهاية التي تستدعيها.
`pricing`	الأسعار بالدولار كسلاسل نصية، لكل token ما لم يُشِر المفتاح إلى غير ذلك (`request` و`image` ووحدات SKU الخاصة بالفيديو). هذه هي الأسعار التي تدفعها.
`supported_parameters`	معاملات الطلب التي يقبلها النموذج (`tools` و`reasoning` و`response_format` و...).
`endpoint`	نقطة نهاية البوابة الخاصة بفئة هذا النموذج.

لا تُدرج سوى النماذج المفعَّلة على api14.

الحصول على نموذج واحد

GET https://api14.com/api/v1/models/{id}

curl https://api14.com/api/v1/models/openai/gpt-5-mini

يُعيد كائن نموذج واحد بالصيغة نفسها. تُحَل لواحق المتغيّرات إلى النموذج الأساسي (openai/gpt-5-mini:nitro → openai/gpt-5-mini). وتُعيد المعرّفات غير المعروفة أو المعطَّلة 404 model_not_found.

كتالوجات الفئات

تتضمن هذه الكتالوجات معاملات إضافية مثل الدقّات والمدد ونسب العرض إلى الارتفاع المدعومة وأسعار الفيديو لكل SKU. وهي عامة، ولا تتطلب مفتاحًا:

curl https://api14.com/api/v1/images/models
curl https://api14.com/api/v1/videos/models
curl https://api14.com/api/v1/embeddings/models

مثال: أرخص نماذج النصوص

curl -s "https://api14.com/api/v1/models?category=text" \
  | jq -r '.data | sort_by(.pricing.prompt | tonumber) | .[:5][] | "\(.id)  \(.pricing.prompt)"'

الأخطاء

الحالة	الرمز	متى
404	`model_not_found`	`GET /models/{id}` لنموذج غير معروف أو معطَّل.
502	`upstream_unavailable`	تعذّر جلب كتالوج ممرَّر (`/images/models` وغيره).

راجع الأخطاء.