الانتقال إلى المحتوى الرئيسي

​
معاملات المسار

​
model
string
مطلوب
معرّف النموذج المراد استرجاعه (على سبيل المثال، gpt-5.4 أو claude-sonnet-4-6).

​
الاستجابة

​
id
string
معرّف النموذج.
​
object
string
دائمًا model.
​
created
integer
طابع زمني للإنشاء.
​
owned_by
string
مزود النموذج.
​
aisonar
object
بيانات وصفية عامة خاصة بـ AI Sonar. قد تتضمن مسار التفاصيل category و pricing_unit و capability_flags و supported_operations و pricing_provenance و public_contract_summary و public_contract الكامل و agent_preferences على مستوى السيناريو للقطات التوصية غير chat.
curl "https://api.aisonar.dev/v1/models/gpt-5.4" \
  -H "Authorization: Bearer sk-your-api-key"

{
  "id": "gpt-5.4",
  "object": "model",
  "created": 1706000000,
  "owned_by": "openai"
}

​
معالجة الأخطاء

إذا لم يكن النموذج موجودًا، فستتلقى خطأ 404: 
{
  "error": {
    "message": "Model 'invalid-model' not found",
    "type": "invalid_request_error",
    "code": "model_not_found"
  }
}

​
بيانات التوصية للنماذج غير chat

بالنسبة للنماذج غير chat، تُرجع صفحة التفاصيل أيضًا aisonar.agent_preferences.<scene>. استخدمها لفحص:
  • preferred_rank
  • success_rate_24h
  • sample_count_24h
  • status
  • updated_at
تُبقي الاستجابة العامة basis.channel_id و basis.physical_model على null عمدًا حتى تتمكن الوكلاء من استهلاك إشارة التوصية دون معرفة معرّفات التوجيه الداخلية.

​
بيانات التفاصيل العامة

بالمقارنة مع GET /v1/models، يمكن لصفحة التفاصيل أن تعيد أيضًا:
  • aisonar.capability_flags
  • aisonar.supported_operations
  • aisonar.pricing_provenance
  • aisonar.public_contract_summary
  • aisonar.public_contract