البدء السريع

أنشئ مفتاح API واختر نموذجًا واحصل على تسعير الطلب وتابع نتيجته.

1. أنشئ مفتاح API#

أنشئ مفتاحًا لخادمك. تسري الصلاحيات على الحساب المالك له.

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

BASH

export TONG_API_KEY="YOUR_TONG_API_KEY"

تتطلب الأدوات المدفوعة أيضًا credits:spend. صلاحيات الحذف منفصلة.

2. اكتشف نموذجًا#

استبدل معرّفات النماذج وحقول المراجع ومراجعات القدرات في الأمثلة بقيم الاكتشاف الحالية. يختلف دعم المراجع حسب النموذج وسير العمل.

curl -X POST 'https://platform.tongai.io/v1/tools/tong_workflows/operations' \  -H "Authorization: Bearer $TONG_API_KEY" \  -H "Content-Type: application/json" \  -d '{  "input": {    "query": {      "operation": "TEXT_TO_VIDEO"    }  }}'

الإعدادات

curl --version

كتالوج النماذجاكتشف النماذج المتاحة وإمكاناتها والإعدادات المدعومة.سياسات النماذجراجع سياسة الإشراف المنشورة لكل نموذج قبل دمجه.

3. سعّر الإعدادات#

اطلب عرض السعر أولًا، ثم أرسل النموذج والإعدادات المطابقة له. تابع العملية حتى تنجح أو تفشل أو تحتاج إلى مراجعتك.

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

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

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

4. أرسل الطلب#

تستخدم الأمثلة نقطة الاتصال العامة. استبدل المعرّفات النموذجية بمعرّفاتك.

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

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

5. تابع النتيجة#

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

curl 'https://platform.tongai.io/v1/operations/e8aa0a87-6cd9-42eb-975a-b72bf43218c8' \  -H "Authorization: Bearer $TONG_API_KEY"

الإعدادات

curl --version

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"  }}

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