API أوصاف وهاشتاغات TikTok: نقاط النهاية والحدود

جرّب Koda آخر تحقق في

توفّر 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/caption1
POST /api/v1/hashtags1
POST /api/v1/script2
لكل استدعاء، لكل مفتاح. حد المعدل 5 طلبًا لكل 60 ثانية على كل نقطة نهاية.

كم يكلّف الرصيد الواحد فعلًا؟

أربعة أحجام للباقات، وسعر الوحدة ينخفض مع الحجم: $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

كيف أُعدّت هذه الصفحة: كُتبت بمساعدة الذكاء الاصطناعي اعتمادًا على الإعدادات والحدود التي تعمل بها Koda نفسها، وتم التحقق منها في .