اكتشاف النماذج والاستعلام عن التكلفة

اكتشاف النماذج المتاحة عبر البروتوكولات، وتشغيل الإشراف، والاستعلام عن تكاليف المهام المنفذة.

نظرة عامة

توفر AnyInt نقاط نهاية موحدة لاكتشاف النماذج لحزم SDK الخاصة بـ OpenAI و Anthropic و Gemini، مع الإشراف وفحص التكاليف المتوافقة مع OpenAI.

اكتشاف النماذج

GET /openai/v1/models GET /v1/models

json
{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715367049,
      "owned_by": "openai"
    }
  ]
}
  • قائمة النماذج: ترجع GET /openai/v1/models و GET /v1/models قائمة نماذج قياسية متوافقة مع OpenAI مفلترة حسب صلاحيات مفتاح API.
  • هيكل الاستجابة: ترجع البوابة غلافاً خارجياً { "object": "list", "data": [ ... ] }. يحتوي كل عنصر داخل data على معرف id وخاصية ثابتة object: "model" ووقت الإنشاء created وهوية المالك owned_by لتعكس بيانات المزود الرئيسي أو الإعدادات الافتراضية للمنصة.
  • الأسعار والأرصدة: لا تتضمن قائمة النماذج بيانات التسعير وأرصدة المحفظة، ويتم الاستعلام عنها عبر نقاط نهاية الفوترة المخصصة أو فحص تكاليف المهام.

الإشراف على المحتوى

POST/openai/v1/moderations
  • عقد نقطة النهاية: تقبل POST /openai/v1/moderations (operationId: openai.moderations) الحقل الإلزامي input (سلسلة نصية أو مصفوفة نصوص/كائنات تصل إلى 1,024 عنصراً) ونموذجاً اختيارياً model.
  • هيكل الاستجابة: ترجع id و model ومصفوفة results حيث يحتوي كل عنصر على flagged (قيمة منطقية) وكائن categories (إشارات منطقية لكل فئة) وكائن category_scores (درجات ثقة رقمية لكل فئة).
  • مسار التوافق: تدعم البوابة POST /v1/moderations (operationId: openai.moderations.alias) كاسم مستعار قياسي للتوافق.

الاستعلام عن تكلفة المهمة

POST/v1/tasks/request-costs
  • عقد نقطة النهاية: منشور في Developer OpenAPI عند POST /v1/tasks/request-costs (operationId: chatroom.request_costs).
  • استعلام مجمع: إرسال مصفوفة من request_ids (من 1 إلى 100 معرف، بطول 8 إلى 160 حرفاً) لاسترداد الرسوم المستقرة للمهام المكتملة.
  • هيكل الاستجابة: يرجع كائناً مثل { "request_costs": [{ "request_id": "...", "credits": 1.25 }] }.
  • الفوترة بالرصيد: يتم الإبلاغ عن التكاليف بوحدات credits (حيث 100 credits تعادل دولاراً أمريكياً واحداً) بدقة 4 منازل عشرية في توافق تام مع دفتر الأستاذ.

نقاط نهاية البروتوكولات

  • بروتوكول OpenAI: مسار GET /openai/v1/models ومسار التوافق GET /v1/models.
  • بروتوكول Anthropic: مسار GET /anthropic/v1/models لـ Claude Code وحزم SDK الرسمية.
  • بروتوكول Gemini: مسار GET /gemini/v1beta/models لعملاء Google GenAI SDK.