متطلبات فيديو 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 من مسار الوسائط المُتحقَّق منه الخاص به.
أكبر فيديو تقبله نقطة النهاية (endpoint) للنشر، بصيغة MP4 أو MOV أو WebM.
أقصر مدة للفيديو وأطولها اللتان توثّقهما TikTok للنشر عبر API.
أدنى ارتفاع وعرض للفيديو المنشور، ويشترط أيضًا معدل 23 إلى 60 إطارًا في الثانية.
أقل مدة توصي بها 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، فأبقِ الملف متاحًا حتى يُنشر.
من 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 ترميز الفيديو، وقد يظهر المنشور بدقة ومعدل بت أقل من الملف، بحسب جهاز المشاهد واتصاله.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في