الانتقال إلى الوثائق
الوثائق
فتح لوحة التحكم
في هذه الصفحة

تسعير توليد

tong_generation_quote

احصل على تسعير للنموذج والمدخلات والإعدادات الدقيقة قبل إرسال الإجراء.

POST/v1/tools/tong_generation_quote/operations

مثال طلب#

curl -X POST 'https://platform.tongai.io/v1/tools/tong_generation_quote/operations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "input": {    "body": {      "operation": "TEXT_TO_IMAGE",      "model": "tong_ea55aff4f3b5c8aba3a35569",      "routingParameters": {        "ratio": "16:9"      }    }  }}'
الإعدادات
curl --version

الأذونات#

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

generation:writequotes:write

محتوى الطلب#

تغلّف طلبات REST معاملات الأداة داخل input. ترسل استدعاءات MCP المعاملات نفسها مباشرة.

bodyobjectمطلوب
عرض الحقول المتداخلة
operationstringمطلوب

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

القيم المسموح بها"TEXT_TO_IMAGE""IMAGE_EDIT""CHARACTER_RECREATE""CHARACTER_RECREATE_SPICY""TEXT_TO_VIDEO""IMAGE_TO_VIDEO""CHARACTER_TO_VIDEO""CHARACTER_TO_VIDEO_SPICY""FIRST_LAST_TO_VIDEO"
مثال"TEXT_TO_IMAGE"
modelstringمطلوب

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

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

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

مثال"tong_ea55aff4f3b5c8aba3a35569"
resolutionstring | nullاختياري
القيم المسموح بها"480p""720p""768p""1080p""2k""4k"
quantityintegerاختياري

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

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

durationSecondsintegerاختياري

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

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

inputAssetIdsstring[]اختياري

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

characterProfileIdstringاختياري

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

annotationGuidebooleanاختياري
routingParametersobjectاختياري

استخدم الإعدادات المعادة لهذا النموذج والمسار. حافظ على الإعدادات نفسها عند التسعير والإرسال.

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

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

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

recreateReferenceRolesstring[]اختياري

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

ratiostringاختياري
القيم المسموح بها"21:9""16:9""4:3""1:1""3:4""9:16""adaptive"
مثال"16:9"
generateAudiobooleanاختياري
promptExtendbooleanاختياري
seedintegerاختياري

الحد الأدنى: -1.

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

negativePromptstringاختياري

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

negativePromptModestringاختياري
القيم المسموح بها"REPLACE"
referenceRequestobjectاختياري
عرض الحقول المتداخلة
ratiostringاختياري

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

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

generateAudiobooleanاختياري
promptstringمطلوب

صف النتيجة التي تريد إنشاءها.

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

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

directionobjectمطلوب
عرض الحقول المتداخلة
versionnumberمطلوب
القيم المسموح بها1
capabilityRevisionstringمطلوب

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

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

keepVideoSoundbooleanاختياري
seedintegerاختياري

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

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

automaticShotsbooleanاختياري
automaticDurationbooleanاختياري
outputResolutionstringاختياري
القيم المسموح بها"720p-SR""1080p-SR""1440p-SR"
bitratestringاختياري
القيم المسموح بها"standard""high"
returnLastFramebooleanاختياري
documentUrlstringاختياري

التنسيق: uri.

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

subjectSequenceintegerاختياري

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

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

subjectsobject[]اختياري

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

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

استخدم تسمية موضوع مرقّمة، مثل Subject1.

namestringمطلوب

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

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

descriptionstringاختياري

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

assetIdsstring[]مطلوب

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

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

shotsobject[]اختياري

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

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

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

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

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

promptstringمطلوب

صف النتيجة التي تريد إنشاءها.

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

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

durationSecondsintegerمطلوب

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

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

referencesobject[]مطلوب

استخدم معرّفات أصول تملكها وتوافق إمكانات المراجع للنموذج المحدد.

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

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

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

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

assetIdstringمطلوب

استخدم معرّف أصل يملكه الحساب المصرح له.

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

fieldstringمطلوب

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

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

labelstringمطلوب

استخدم تسمية مرجع مرقّمة، مثل Image1.

assetIdsstring[]مطلوب

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

filmSceneobjectاختياري
عرض الحقول المتداخلة
projectIdstringمطلوب

استخدم معرّف مشروع يملكه الحساب المصرح له.

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

shotIdstringمطلوب

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

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

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

revisionintegerمطلوب

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

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

filmReferenceobjectاختياري
عرض الحقول المتداخلة
projectIdstringمطلوب

استخدم معرّف مشروع يملكه الحساب المصرح له.

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

entityIdstringمطلوب

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

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

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

revisionintegerمطلوب

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

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

ترويسات الطلب#

HTTP
Authorization: Bearer $TONG_API_KEYContent-Type: application/jsonIdempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03

احتفظ بمعرّف UUID واحد لكل إجراء وأعد استخدامه بعد انتهاء المهلة أو إعادة المحاولة. تُرفض المدخلات المختلفة بالمعرّف نفسه.

حقول الاستجابة#

قبول الطلب لا يعني اكتمال التوليد. تابع المهمة المحفوظة حتى تصبح النتيجة جاهزة.

القبول يعني حفظ الطلب. اقرأ عمليته لمتابعة التنفيذ.

JSON
{  "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",  "tool": "tong_generation_quote",  "category": "generation",  "channel": "api",  "state": "queued",  "status": "accepted",  "stage": "admission",  "dispatch_status": "pending",  "created_at": "2026-10-22T09:00:00.000Z",  "updated_at": "2026-10-22T09:00:00.000Z",  "detail_expires_at": null,  "detail_expired": false,  "timing": {    "dispatch_started_at": null,    "acknowledged_at": null,    "completed_at": null,    "dispatch_acknowledgement_ms": null,    "end_to_end_ms": null  },  "review": null,  "result": null,  "error": null,  "billing": {    "status": "pending",    "usage_credits": "0.000000",    "wallet_debited_credits": "0.000000"  }}
idstringمطلوب

المعرّف الفريد للعملية المحفوظة.

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

toolstringمطلوب
categorystringمطلوب
channelstringمطلوب
القيم المسموح بها"api""mcp"
statestringمطلوب

حالة التنفيذ الحالية للعمل المحفوظ.

القيم المسموح بها"queued""running""waiting""needs_review""paused""reconciling""succeeded""failed""cancelled"
statusstringمطلوب

الحالة العامة المستخدمة لتتبع العملية.

القيم المسموح بها"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"
stagestringمطلوب

المرحلة الحالية للعملية.

القيم المسموح بها"admission""dispatch""review""generation""reconciliation""complete"
dispatch_statusstringمطلوب

ما إذا كانت الأداة قد قبلت الطلب. لا يعني الإقرار أن التوليد اكتمل.

القيم المسموح بها"pending""unknown""acknowledged"
created_atstringمطلوب

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

updated_atstringمطلوب

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

detail_expires_atstring | nullمطلوب

موعد انتهاء صلاحية تفاصيل العملية المحفوظة. تعني القيمة null أنه لا يوجد انتهاء محدد حاليًا.

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

detail_expiredbooleanمطلوب

ما إذا كانت صلاحية تفاصيل العملية المحفوظة قد انتهت.

timingobjectمطلوب

الطوابع الزمنية والمدد المنقضية لتتبع هذه العملية.

عرض الحقول المتداخلة
dispatch_started_atstring | nullمطلوب

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

acknowledged_atstring | nullمطلوب

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

completed_atstring | nullمطلوب

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

dispatch_acknowledgement_msnumber | nullمطلوب

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

end_to_end_msnumber | nullمطلوب

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

reviewJSON | nullمطلوب

معلومات المراجعة عندما تحتاج العملية إلى تدخل بشري؛ وإلا تكون null.

resultJSON | nullمطلوب

المخرجات التي تعيدها هذه الأداة، أو null عندما لا تتوفر مخرجات.

errorobject | nullمطلوب

رمز الخطأ العام إذا فشلت العملية؛ وإلا تكون null.

عرض الحقول المتداخلة
codestringمطلوب
billingobjectمطلوب

استخدام أرصدة العميل ورسوم المحفظة. جاهزية المخرجات وتسوية الفوترة حالتان منفصلتان.

عرض الحقول المتداخلة
statusstringمطلوب
القيم المسموح بها"none""pending""settled""released""reconciling"
usage_creditsstringمطلوب

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

wallet_debited_creditsstringمطلوب

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

released_creditsstringاختياري

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

refunded_creditsstringاختياري

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

unfunded_creditsstringاختياري

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

pending_creditsstringاختياري

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

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

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

outputnumberاختياري

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

cachednumberاختياري

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

cache_writenumberاختياري

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

componentsobject[]اختياري
عرض الحقول المتداخلة
idstringاختياري
source_idstringمطلوب
toolstringمطلوب
modelstring | nullمطلوب
channelstringمطلوب
القيم المسموح بها"api""mcp"
credential_idstringمطلوب
kindstringمطلوب
القيم المسموح بها"text_pool""reasoning""generation"
usage_creditsstringمطلوب

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

wallet_debited_creditsstringمطلوب

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

evidence_atstringاختياري

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

updated_atstringاختياري

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

quoteobjectاختياري

الإعدادات والسعر وقيم الإرسال عند توفر عرض سعر.

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

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

operation_idstringمطلوب

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

toolstringمطلوب
operationstring | nullمطلوب
modelstring | nullمطلوب
configurationobjectمطلوب
submit_valuestringمطلوب
submit_fieldstringمطلوب
quoted_creditsstring | nullمطلوب

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

expires_atstring | nullمطلوب

تاريخ ووقت بتنسيق ISO 8601، مثل 2026-10-22T09:00:00Z.

الطلبات والسجلاتقبول الطلب لا يعني اكتمال التوليد. تابع المهمة المحفوظة حتى تصبح النتيجة جاهزة.الأرصدة والفوترةتابع الأسعار المعروضة والاستهلاك الفعلي والأرصدة المسوّاة.

استدعاء MCP#

JSON
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "tong_generation_quote",    "arguments": {      "body": {        "operation": "TEXT_TO_IMAGE",        "model": "tong_ea55aff4f3b5c8aba3a35569",        "routingParameters": {          "ratio": "16:9"        }      }    },    "_meta": {      "io.tongai/idempotency-key": "45be69f1-c266-4a09-a82c-bf3c6303eb03"    }  }}

تغلّف طلبات REST معاملات الأداة داخل input. ترسل استدعاءات MCP المعاملات نفسها مباشرة.

الاستجابة

JSON
{  "jsonrpc": "2.0",  "id": 1,  "result": {    "structuredContent": {      "id": "e8aa0a87-6cd9-42eb-975a-b72bf43218c8",      "tool": "tong_generation_quote",      "category": "generation",      "channel": "mcp",      "state": "queued",      "status": "accepted",      "stage": "admission",      "dispatch_status": "pending",      "created_at": "2026-10-22T09:00:00.000Z",      "updated_at": "2026-10-22T09:00:00.000Z",      "detail_expires_at": null,      "detail_expired": false,      "timing": {        "dispatch_started_at": null,        "acknowledged_at": null,        "completed_at": null,        "dispatch_acknowledgement_ms": null,        "end_to_end_ms": null      },      "review": null,      "result": null,      "error": null,      "billing": {        "status": "pending",        "usage_credits": "0.000000",        "wallet_debited_credits": "0.000000"      }    },    "content": [      {        "type": "text",        "text": "{\"id\":\"e8aa0a87-6cd9-42eb-975a-b72bf43218c8\",\"tool\":\"tong_generation_quote\",\"category\":\"generation\",\"channel\":\"mcp\",\"state\":\"queued\",\"status\":\"accepted\",\"stage\":\"admission\",\"dispatch_status\":\"pending\",\"created_at\":\"2026-10-22T09:00:00.000Z\",\"updated_at\":\"2026-10-22T09:00:00.000Z\",\"detail_expires_at\":null,\"detail_expired\":false,\"timing\":{\"dispatch_started_at\":null,\"acknowledged_at\":null,\"completed_at\":null,\"dispatch_acknowledgement_ms\":null,\"end_to_end_ms\":null},\"review\":null,\"result\":null,\"error\":null,\"billing\":{\"status\":\"pending\",\"usage_credits\":\"0.000000\",\"wallet_debited_credits\":\"0.000000\"}}"      }    ]  }}

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

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 وأعد المحاولة بالقصد نفسه. تحقق من العملية المحفوظة بعد انتهاء مهلة.
الأخطاء وحدود الطلباتافهم استجابات الأخطاء وأعد المحاولة بأمان واستأنف عمليات التوليد الفاشلة.ثبات أثر إعادة الطلباحتفظ بمعرّف UUID واحد لكل إجراء وأعد استخدامه بعد انتهاء المهلة أو إعادة المحاولة. تُرفض المدخلات المختلفة بالمعرّف نفسه.
إعادة استخدام توليدجهّز مصدرًا تملكه للخطوة التالية في هذا المسار.إرسال توليدأرسل الإجراء المهيأ باستخدام حسابك وأرصدة Tong. تابع العملية المحفوظة حتى انتهائها.تسعير بديلاحصل على تسعير للنموذج والمدخلات والإعدادات الدقيقة قبل إرسال الإجراء.توليد بديلأرسل الإجراء المهيأ باستخدام حسابك وأرصدة Tong. تابع العملية المحفوظة حتى انتهائها.إعادة محاولة التوليدأرسل الإجراء المهيأ باستخدام حسابك وأرصدة Tong. تابع العملية المحفوظة حتى انتهائها.جلب الأمر المحسّناقرأ المورد المحدد الذي تملكه أو حالة المسار دون بدء توليد جديد.