API أوصاف وهاشتاغات TikTok: نقاط النهاية والحدود
توفّر Koda ثلاث نقاط نهاية POST — /api/v1/caption و/api/v1/hashtags و/api/v1/script — مصادَق عليها بمفتاح API تنشئه وتلغيه بنفسك. الوصف أو مجموعة الهاشتاغات يكلّف 1 رصيد، والنص يكلّف 2، وكل استجابة تعيد credits_used وcredits_remaining كي يتوقف كودك قبل أن ينفد الرصيد. تُشترى الأرصدة في باقات، من $0.05 للرصيد الواحد نزولًا إلى $0.03، وهي منفصلة عن Koda Coins التي ينفقها الاستوديو.
كم تكلّف كل نقطة من النقاط الثلاث لكل استدعاء
كل استدعاء مسعّر بأرصدة كاملة، تُخصم بشكل ذرّي بمجرد نجاح التوليد — الاستدعاء الفاشل لا يُحتسب، لأن الخصم مشروط بأن يظل الرصيد كافيًا لحظة الكتابة.
| نقطة النهاية | الأرصدة |
|---|---|
| POST /api/v1/caption | 1 |
| POST /api/v1/hashtags | 1 |
| POST /api/v1/script | 2 |
كم يكلّف الرصيد الواحد فعلًا؟
أربعة أحجام للباقات، وسعر الوحدة ينخفض مع الحجم: $0.05 للرصيد عند 100، و$0.03 عند 5000. الوصف بأفضل سعر يكلّف ثلاثة سنتات.
الأرصدة لا تنتهي صلاحيتها مع فترة الفوترة، وليست Koda Coins. العملة الواحدة تمثل $0.001 من تكلفة المزوّد الحقيقية داخل الاستوديو؛ أما رصيد API فوحدة بيع ثابتة. لا يتحول أحدهما إلى الآخر أبدًا، ولهذا يُحتسبان بشكل منفصل في لوحة التحكم.
| الباقة | السعر لكل رصيد |
|---|---|
| 100 رصيد | $0.05 |
| 500 رصيد | $0.04 |
| 1000 رصيد | $0.035 |
| 5000 رصيد | $0.03 |
ما الذي تعطيك إياه الاستجابة إلى جانب النص
كل استجابة ناجحة تحمل credits_used وcredits_remaining. هذا هو الجزء الذي يستحق الربط: تستطيع مهمة الدفعات قراءة الرصيد المتبقي من آخر استدعاء بدلًا من استطلاع نقطة نهاية منفصلة، وإيقاف نفسها بشكل نظيف.
حين يكون الرصيد منخفضًا جدًا يعيد الاستدعاء HTTP 402 مع الرمز insufficient_credits والرصيد الحالي، فيكون الفشل قابلًا للمعالجة برمجيًا بدلًا من تحليل نص خطأ.
ما لا تفعله هذه الميزة
- لا تولّد فيديو ولا صورًا ولا صوتًا. واجهة v1 نصية فقط — أوصاف وهاشتاغات ونصوص. توليد الفيديو يبقى في الاستوديو، حيث يُسعَّر بالعملات لكل نموذج ولكل ثانية.
- لا تنشر. لا شيء في v1 ينشر على TikTok أو Instagram أو YouTube؛ ربط الحساب والنشر إجراءان في لوحة التحكم.
- حدّ المعدل 5 طلبًا في الدقيقة لكل نقطة نهاية، وهو سقف للدفعات المتتالية لا حصة شهرية. المهمة التي تحتاج إلى أكثر يجب أن تنظّم وتيرتها.
- لا توجد فئة مجانية في الواجهة البرمجية. تُشترى الأرصدة قبل أول استدعاء.
الأسئلة الشائعة
- هل تتقاسم أرصدة API وKoda Coins رصيدًا واحدًا؟
- لا. هما رصيدان منفصلان يُعرضان بشكل منفصل في لوحة التحكم. Koda Coins تدفع مقابل توليدات الاستوديو وتتبع تكلفة المزوّد الحقيقية؛ وأرصدة API وحدة بيع ثابتة تُشترى في باقات لنقاط نهاية v1.
- ماذا يحدث لاستدعاء يفشل؟
- لا يُحتسب. الخصم كتابة مشروطة لا تُطبَّق إلا إذا ظل الرصيد كافيًا، وتجري بعد عودة التوليد — فخطأ من المزوّد أو رفض بسبب حد المعدل يترك الرصيد كما هو.
- هل يمكن إلغاء مفتاح API؟
- نعم، من صفحة المطوّر. يُعرض المفتاح كاملًا مرة واحدة فقط، عند الإنشاء، ويمكن إلغاؤه في أي وقت؛ ويُسجَّل الاستخدام لكل مفتاح كي ترى أيها أنفق ماذا.
جرّب Koda
كيف أُعدّت هذه الصفحة: كُتبت بمساعدة الذكاء الاصطناعي اعتمادًا على الإعدادات والحدود التي تعمل بها Koda نفسها، وتم التحقق منها في .
