إرسال توليد

tong_generation_submit

أرسل الإجراء المهيأ باستخدام حسابك وأرصدة Tong. تابع العملية المحفوظة حتى انتهائها.

POST/v1/tools/tong_generation_submit/operations

مثال طلب#

curl -X POST 'https://platform.tongai.io/v1/tools/tong_generation_submit/operations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -H "Idempotency-Key: 45be69f1-c266-4a09-a82c-bf3c6303eb03" \  -d '{  "input": {    "params": {      "id": "000000000000000000000001"    },    "body": {      "quoteId": "fixture-image-quote-token",      "prompt": "A quiet street at blue hour",      "operation": "TEXT_TO_IMAGE",      "inputAssetIds": [],      "parameters": {        "textToImageModel": "tong_ea55aff4f3b5c8aba3a35569",        "ratio": "16:9"      }    }  }}'

الإعدادات

curl --version

الأذونات#

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

generation:writecredits:spend

محتوى الطلب#

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

paramsobjectمطلوب

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

idstringمطلوب

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

مثال"000000000000000000000001"

bodyobjectمطلوب

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

quoteIdstringمطلوب

استخدم قيمة إرسال التسعير المعادة لهذه الإعدادات الدقيقة.

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

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

مثال"fixture-image-quote-token"

promptstringمطلوب

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

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

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

مثال"A quiet street at blue hour"

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"

inputAssetIdsstring[]مطلوب

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

مثال[]

parametersobjectمطلوب

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

directorRequiredReferenceCountintegerاختياري

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

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

referenceDirectionobjectاختياري

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

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.

autoEnhancePromptbooleanاختياري

promptEnhancementIdstringاختياري

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

negativePromptModestringاختياري

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

cameraMotionstringاختياري

القيم المسموح بها"AUTO""ORBIT_RIGHT""ORBIT_LEFT""PUSH_IN""PULL_BACK""RISE"

qualityPresetstringاختياري

القيم المسموح بها"REALISTIC""DRAFT"

casualPhoneFinishbooleanاختياري

recreateReferenceRolesstring[]اختياري

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

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

characterVideoReferenceRolesstring[]اختياري

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

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

imageModelstringاختياري

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

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

textToImageModelstringاختياري

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

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

مثال"tong_ea55aff4f3b5c8aba3a35569"

videoModelstringاختياري

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

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

durationSecondsintegerاختياري

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

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

resolutionstringاختياري

القيم المسموح بها"480p""720p""768p""1080p""2k""4k"

ratiostringاختياري

القيم المسموح بها"21:9""16:9""4:3""1:1""3:4""9:16""adaptive"

مثال"16:9"

videoStylestringاختياري

القيم المسموح بها"NATURAL_PHONE""CINEMATIC""FOLLOW_PROMPT"

generateAudiobooleanاختياري

seedintegerاختياري

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

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

promptExtendbooleanاختياري

negativePromptstringاختياري

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

workspaceProjectIdstring | nullاختياري

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

characterProfileIdstringاختياري

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

annotationsobject[]اختياري

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

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

xnumberمطلوب

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

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

ynumberمطلوب

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

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

radiusnumberمطلوب

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

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

commentstringمطلوب

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

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

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_submit",  "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_submit",    "arguments": {      "params": {        "id": "000000000000000000000001"      },      "body": {        "quoteId": "fixture-image-quote-token",        "prompt": "A quiet street at blue hour",        "operation": "TEXT_TO_IMAGE",        "inputAssetIds": [],        "parameters": {          "textToImageModel": "tong_ea55aff4f3b5c8aba3a35569",          "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_submit",      "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_submit\",\"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. تابع العملية المحفوظة حتى انتهائها.جلب الأمر المحسّناقرأ المورد المحدد الذي تملكه أو حالة المسار دون بدء توليد جديد.

إرسال توليد

مثال طلب#

الأذونات#

محتوى الطلب#

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

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

استدعاء MCP#

الاستجابة

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

أدوات ذات صلة#