تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

متطلبات فيديو TikTok لواجهة برمجة التطبيقات (API): الصيغة والحجم والمدة

يجب أن يكون الفيديو المنشور عبر واجهة TikTok API for Business ملفًا بصيغة MP4 أو MOV أو WebM بحجم يصل إلى 1 GB، ومدته من 3 إلى 600 ثانية (أو الحد الأدنى الذي يحدده حساب المستخدم)، وبارتفاع وعرض لا يقل كل منهما عن 360 بكسل، وبمعدل 23 إلى 60 إطارًا في الثانية. يُنزّل TikTok الملف بنفسه، لذا يجب أن يقع رابط الفيديو على نطاق أو بادئة رابط تحقّق منها تطبيق النشر.

ينشر easyCoexistence فيديوهات TikTok بواسطة publish_tiktok_post من Claude أو ChatGPT أو من كودك الخاص: مرّر رابط HTTPS للملف والتعليق وما إذا كانت التعليقات مفعّلة، وسيقدّم الملف إلى TikTok من مسار الوسائط المُتحقَّق منه الخاص به.

1 GB

أكبر فيديو تقبله نقطة النهاية (endpoint) للنشر، بصيغة MP4 أو MOV أو WebM.

3 to 600 s

أقصر مدة للفيديو وأطولها اللتان توثّقهما TikTok للنشر عبر API.

360 px

أدنى ارتفاع وعرض للفيديو المنشور، ويشترط أيضًا معدل 23 إلى 60 إطارًا في الثانية.

30 min

أقل مدة توصي بها TikTok لبقاء رابط الفيديو صالحًا، لأن TikTok ينزّل الملف بنفسه.

ما الذي يجب أن يستوفيه الفيديو؟

مواصفات TikTok للفيديو المنشور عبر POST /business/video/publish/، والتي تتحقق منها TikTok بعد تنزيل الملف:

  • الحاوية: MP4 أو MOV أو WebM.
  • الحجم: حتى 1 GB.
  • المدة: 3 ثوانٍ على الأقل و600 ثانية على الأكثر، أو أقل إذا كان الحد الأقصى للحساب أدنى.
  • الصورة: 360 بكسل على الأقل في الارتفاع والعرض معًا.
  • معدل الإطارات: من 23 إلى 60 إطارًا في الثانية.

هل يمكن لكل حساب نشر فيديوهات مدتها 600 ثانية؟

ليس دائمًا. تعيد GET /business/video/settings/ القيمة max_video_post_duration_sec، وهي أطول مدة يمكن للحساب نشرها بنفسه، ويفشل نشر أي فيديو أطول منها. يُخبرك الاستدعاء نفسه أيضًا بما إذا كانت إعدادات الحساب تسمح بالتعليقات والمشاركة عبر Duets وStitch على منشوراته. مع easyCoexistence، يقرأ كودك الخاص هذه القيمة بالرمز (token) وbusiness_id من get_social_credentials.

أين يجب أن يكون الفيديو؟

على عنوان URL عام عبر HTTP أو HTTPS، يجلبه TikTok بنفسه، وتوصي TikTok بأن يبقى صالحًا 30 دقيقة على الأقل. ومنذ 16 نوفمبر 2023، ترفض TikTok أيضًا عناوين الفيديو غير المُتحقَّق منها: يُثبت المطوّر ملكيته لنطاق عبر سجل DNS من نوع TXT، أو لبادئة عنوان URL عبر ملف توقيع يُوضع تحتها، ويمكن بعد ذلك النشر من أي عنوان يبدأ ببادئة مُتحقَّق منها.

كيف يصل ملفك إلى TikTok عبر easyCoexistence؟

عبر بادئة عنوان URL خاصة بـ easyCoexistence مُتحقَّق منها. تأخذ publish_tiktok_post رابط HTTPS الخاص بك، وتمرّر إلى TikTok رابطًا موقّعًا ضمن مسار الوسائط الخاص بـ easyCoexistence تنتهي صلاحيته بعد 6 ساعات، وتبثّ الملف من رابطك عندما ينزّله TikTok، دون أن تخزّنه في أي مرحلة. لا يحتاج رابطك إلى تحقق خاص به، لكن يجب أن يكون HTTPS ومفتوحًا دون تسجيل دخول حتى يُنشر المنشور.

ماذا يحدث بعد أن ينزّل TikTok الفيديو؟

تفحص TikTok الملف وتعيد ترميزه، وتنبّه إلى أن المنشور بعد نشره قد يظهر بدقة ومعدل بت أقل من الأصل، بحسب جهاز المشاهد وشبكته. الملف الذي يخالف قاعدة لا يُنشر: تصبح حالته FAILED مع سبب مثل file_format_check_failed أو frame_rate_check_failed أو picture_size_check_failed، وتصنّفها TikTok بأنها لا تقبل إعادة المحاولة بالملف نفسه.

الأخطاء الشائعة

  • إرسال رابط http://. ترفض publish_tiktok_post الروابط غير HTTPS، وترفض الاستدعاء قبل أن يصل إلى TikTok.
  • التصدير بأقل من 23 إطارًا في الثانية. تنزّل TikTok الملف فتجد معدل الإطارات منخفضًا وتُفشل المنشور برمز frame_rate_check_failed، لذا يلزم رفعه بمعدل 23 إطارًا على الأقل.
  • افتراض أن 600 ثانية متاحة لكل حساب. يفشل أي فيديو أطول من max_video_post_duration_sec الخاصة بالحساب، لذا تحقّق منها أولًا.
  • إزالة الملف فور الاستدعاء. تنزّله TikTok بعد قبول الطلب، وإذا توقف الرابط قبل ذلك فسيفشل النشر بالخطأ video_pull_failed، فأبقِ الملف متاحًا حتى يُنشر.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

ما صيغ الفيديو التي تقبلها واجهة TikTok API؟

ملفات بصيغة MP4 أو MOV أو WebM بحجم يصل إلى 1 GB، ومدتها من 3 إلى 600 ثانية، وبأبعاد لا تقل عن 360 بكسل في كل جانب، وبمعدل من 23 إلى 60 إطارًا في الثانية.

هل يمكنني رفع ملف فيديو من حاسوبي؟

ليس عبر هذه النقطة. تأخذ video_url وتنزّل الملف منه، لذا يلزم أولًا أن يكون الفيديو على رابط HTTPS عام.

لماذا تريد TikTok عنوان URL مُتحقَّقًا منه؟

تقول TikTok إن التحقق من ملكية عنوان URL يساعدها على الالتزام بسياساتها بشأن المحتوى المحمي بحقوق النشر وسلامة المستخدمين، ومنذ 16 نوفمبر 2023 ترفض عناوين الفيديو غير المُتحقَّق منها.

هل تخفض TikTok جودة الفيديو المنشور عبر API؟

قد تفعل. تعيد TikTok ترميز الفيديو، وقد يظهر المنشور بدقة ومعدل بت أقل من الملف، بحسب جهاز المشاهد واتصاله.

تابع القراءة

منشورات الصور وعروض الشرائح على TikTok عبر API: حتى 35 صورةكيف تنشر واجهة TikTok للأعمال منشورات الصور: من 1 إلى 35 صورة بصيغة JPEG أو WebP حتى 20 ميغابايت لكل صورة، مع عنوان وتعليق وصورة غلاف.حدود تعليقات TikTok عبر API: الطول والوسوم والإشاراتكم يمكن أن يكون تعليق فيديو TikTok عبر API for Business، وكيف تعمل الوسوم والإشارات، ومتى تظهر أسطر الفقرات، وحدود منشورات الصور.حدود نشر منشورات TikTok عبر واجهة برمجة التطبيقات (API): عدد المنشورات في اليومعدد المنشورات التي تنشرها واجهة TikTok لكل حساب: ستة في الدقيقة و15 في اليوم، وما يحدث عند تجاوز الحد.كيفية متابعة حالة نشر منشور TikTok عبر واجهة برمجة التطبيقات (API)متابعة منشور TikTok المرسل عبر واجهة برمجة التطبيقات (API): share_id، والحالات PROCESSING_DOWNLOAD وPUBLISH_COMPLETE وFAILED، ومعرّفات المنشور وأسباب الفشل.TikTok API for Business مقابل Content Posting APIلماذا TikTok API for Business بدلًا من developers.tiktok.com: التعليقات والتحليلات وتجديد رموز الوصول.خطأ TikTok 40002: خطأ في المعامل ضمن الطلبيعني الخطأ 40002 في TikTok أن معامل الطلب مفقود أو مشوه أو غير مسموح به. كيفية قراءة رسالة TikTok وقواعد Accounts API التي يجب التحقق منها.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في