اسرد نماذج Rivya API وافهم معرفات النماذج، والفئات، وحدود الموجهات، والوسائط المرجعية، وحالات الجاهزية، واعتمادات Files API.

استخدم GET /api/v1/models لسرد نماذج Rivya مع جاهزيتها لـ Public API.

curl https://rivya.ai/api/v1/models

هذا endpoint عام وقراءة فقط. يعيد طبقة النماذج العامة نفسها المستخدمة في وثائق API والمصحح على الإنترنت، بما في ذلك النماذج التي ليست قابلة للاستدعاء بالكامل بعد.

شكل الاستجابة

تستخدم الاستجابة هذا الشكل:

{
  "object": "list",
  "data": [
    {
      "id": "z-image",
      "display_name": "Z-Image",
      "category": "image",
      "runtime": "async_task",
      "base_credits": 1,
      "billing_type": "FIXED",
      "supported_modes": ["text-to-image"],
      "max_prompt_length": 1000,
      "reference_media": null,
      "params": [],
      "api_status": "available",
      "api_input_status": "available_text",
      "supported_api_inputs": ["text"],
      "requires_files_api": false,
      "requires_upload_for_modes": [],
      "url_input_supported": false,
      "file_kinds": [],
      "chat_capabilities": null,
      "notices": []
    }
  ]
}

استخدم id كقيمة model في POST /api/v1/generations لنماذج التوليد غير المتزامنة. بالنسبة إلى نماذج الدردشة، استخدم POST /api/v1/chat/completions وتحقق من chat_capabilities.

حالات التوافر

يستخدم مرجع النماذج هذه الحالات العامة:

available: يوجد مسار توليد واحد على الأقل متاح عبر Public API
coming_soon: نموذج توليد غير متزامن، لكنه غير مكشوف حاليا عبر Public API
studio_only: النموذج متاح عبر Studio أو سطح منتج آخر، وليس عبر Public API v1

حقل جاهزية الإدخال أكثر تحديدا:

available_text: يمكن اختبار الطلبات المعتمدة على الموجه مباشرة
available_url_input: يمكن اختبار URL عام أو معاملات scalar مباشرة
partial_requires_files: يمكن استدعاء بعض الأوضاع من دون رفع؛ ويجب أن تستخدم أوضاع الوسائط المرجعية Files API
requires_files_api: يعتمد النموذج على وسائط مرجعية مرفوعة عبر /api/v1/files

استخدم Files API قبل استدعاء الأوضاع التي تتطلب مراجع صور أو فيديو أو صوت مرفوعة.

بالنسبة إلى نماذج الدردشة، يوثق chat_capabilities ما إذا كان Chat API يدعم الاستجابات غير المتدفقة، والاستجابات المتدفقة، والبحث في الويب، ومرفقات الصور file_id، وthoughts، وreasoning effort.

سياسة عدد النماذج

تتغير قائمة النماذج العامة عندما تضيف Rivya نماذج أو تزيلها أو تقيدها.

لا تعتمد على عدد نماذج ثابت في تكاملك. اقرأ دائما /api/v1/models أو مرجع Model API الديناميكي.

نماذج API

شكل الاستجابة

حالات التوافر

سياسة عدد النماذج

صفحات ذات صلة

جدول المحتويات