`GET /v1/models`

اقرأ المورد المحدد الذي تملكه أو حالة المسار دون بدء توليد جديد.

مثال طلب#

curl 'https://platform.tongai.io/v1/models' \  -H "Authorization: Bearer $TONG_API_KEY"

الإعدادات

curl --version

المصادقة#

استخدم مفتاح API على الخادم لحسابك، أو OAuth لحساب كل عميل. لا ترسل المفاتيح في المطالبات أو وسيطات الأدوات.

catalog:read

المعاملات#

modelstringاختياري

اختر معرّف نموذج Tong عامًا من الاكتشاف الحالي.

operationstringاختياري

اختر مسارًا يدعمه النموذج المختار.

محتوى الطلب#

لا يوجد محتوى طلب لهذه النقطة.

مخطط الاستجابة#

الاستجابة

JSON

{  "workflows": []}

`HTTP 200`

application/json

text_modelsobject[]اختياري

عرض الحقول المتداخلة

idstringمطلوب

namestringمطلوب

context_tokensintegerمطلوب

الحد الأقصى: 9007199254740991.

max_output_tokensintegerمطلوب

الحد الأقصى: 9007199254740991.

unitstringمطلوب

القيم المسموح بها"THOUSAND_TOKENS"

input_creditsstringمطلوب

سلسلة عشرية بست منازل عشرية، مثل 1.250000.

output_creditsstringمطلوب

سلسلة عشرية بست منازل عشرية، مثل 1.250000.

cached_input_creditsstringمطلوب

سلسلة عشرية بست منازل عشرية، مثل 1.250000.

cache_write_creditsstringمطلوب

سلسلة عشرية بست منازل عشرية، مثل 1.250000.

pricingstringمطلوب

القيم المسموح بها"display_maximum"

requires_exact_quotebooleanمطلوب

القيم المسموح بهاtrue

workflowsobject[]مطلوب

الحد الأقصى للعناصر: 10000.

عرض الحقول المتداخلة

operationstringمطلوب

modelstringمطلوب

namestringمطلوب

model_namestringمطلوب

resolutionstring | nullمطلوب

unitstringمطلوب

creditsstring | nullمطلوب

سلسلة عشرية بست منازل عشرية، مثل 1.250000.

base_creditsstring | nullمطلوب

سلسلة عشرية بست منازل عشرية، مثل 1.250000.

requires_exact_quotebooleanاختياري

القيمة الافتراضية: false.

pricingstringاختياري

القيم المسموح بها"configuration_quote""display_rate"

القيمة الافتراضية: "display_rate".

discount_percentnumberمطلوب

الحد الأدنى: 0.

الحد الأقصى: 100.

الأخطاء والحدود#

HTTP	الخطأ	الاستئناف
`400`	طلب غير صالح`REQUEST_INVALID`	صحح الحقول المشار إليها في الخطأ قبل إعادة المحاولة.
`401`	بيانات اعتماد غير صالحة`CREDENTIAL_INVALID`	تحقق من بيانات الاعتماد وانتهائها وما إذا أُلغيت.
`402`	أرصدة غير كافية`INSUFFICIENT_CREDITS`	أضف أرصدة إلى الحساب المالك لبيانات الاعتماد ثم تابع العمل المحفوظ.
`403`	الإذن مرفوض`SCOPE_REQUIRED`	استخدم بيانات اعتماد بالأذونات المطلوبة والوصول إلى المورد المحدد.
`404`	المورد غير متاح`RESOURCE_UNAVAILABLE`	تحقق من معرّف المورد وملكيته للحساب المصرح له.
`409`	تعارض القصد`IDEMPOTENCY_CONFLICT`	أعد استخدام القصد مع طلبه الأصلي فقط. استخدم UUID جديدًا لإجراء مختلف.
`429`	تم بلوغ حد الطلبات`RATE_LIMITED`	انتظر المدة المحددة في Retry-After قبل إعادة الطلب نفسه.
`503`	غير متاح مؤقتًا`DEPENDENCY_UNAVAILABLE`	انتظر Retry-After وأعد المحاولة بالقصد نفسه. تحقق من العملية المحفوظة بعد انتهاء مهلة.

المصادقةتُخصم تكلفة مفاتيح API من حساب مالك المفتاح. ويتيح OAuth لكل مستخدم متصل استخدام أرصدته.الأخطاء وحدود الطلباتافهم استجابات الأخطاء وأعد المحاولة بأمان واستأنف عمليات التوليد الفاشلة.الطلبات والسجلاتقبول الطلب لا يعني اكتمال التوليد. تابع المهمة المحفوظة حتى تصبح النتيجة جاهزة.