`POST /v1/conversations`

استخدم حقول الطلب والأذونات الموثقة لنقطة HTTP هذه.

مثال طلب#

curl -X POST 'https://platform.tongai.io/v1/conversations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "entrypoint": "assistant",  "mode": "guided"}'

الإعدادات

curl --version

المصادقة#

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

assistant:runcredits:spend

المعاملات#

Idempotency-Keystringمطلوب

معرّف UUID، مثل e8aa0a87-6cd9-42eb-975a-b72bf43218c8.

محتوى الطلب#

application/json

entrypointstringمطلوب

القيم المسموح بها"assistant""filmmaker"

modestringمطلوب

تتوقف العمليات الموجّهة للمراجعة البشرية في Tong، وتستمر التلقائية. يُحاسب كلاهما أثناء العمل ويتوقفان عند نفاد الرصيد.

القيم المسموح بها"guided""automatic"

titlestringاختياري

الحد الأقصى للطول: 100 محرفًا.

project_idstringاختياري

معرّف سداسي عشري من 24 محرفًا.

model_preferencesobjectاختياري

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

imagestring | nullمطلوب

استخدم حروفًا أو أرقامًا أو شرطات سفلية أو نقاطًا أو نقطتين أو شرطات مائلة أو واصلات.

الحد الأدنى للطول: 1 محرفًا.

الحد الأقصى للطول: 150 محرفًا.

videostring | nullمطلوب

استخدم حروفًا أو أرقامًا أو شرطات سفلية أو نقاطًا أو نقطتين أو شرطات مائلة أو واصلات.

الحد الأدنى للطول: 1 محرفًا.

الحد الأقصى للطول: 150 محرفًا.

sourceobjectاختياري

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

kindstringمطلوب

القيم المسموح بها"director""text"

idstringمطلوب

معرّف سداسي عشري من 24 محرفًا.

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

الاستجابة

JSON

{}

`HTTP 201`

application/json

object

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

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 لكل مستخدم متصل استخدام أرصدته.الأخطاء وحدود الطلباتافهم استجابات الأخطاء وأعد المحاولة بأمان واستأنف عمليات التوليد الفاشلة.الطلبات والسجلاتقبول الطلب لا يعني اكتمال التوليد. تابع المهمة المحفوظة حتى تصبح النتيجة جاهزة.