TikTok Content Posting API: video va rasm e'lon qilish

Direct Post yoki Upload: qaysi biri kerak?

Direct Post va Upload taqqoslanishi

Direct Post bilan video qanday e'lon qilinadi

Tartib muhim: TikTok qoidalari init so'rovidan oldin creator info va maxsus e'lon oynasini talab qiladi.

1. 1

   video.publish ruxsatini oling

   Ijodkor Login Kit orqali ilovangizga video.publish ruxsatini bergan bo'lishi kerak. Access token 24 soat yashaydi — uni yangilab turing.

2. 2

   Creator info so'rang

   POST /v2/post/publish/creator_info/query/ ijodkor nickname va avatarini, privacy_level_options, comment_disabled, duet_disabled, stitch_disabled va max_video_post_duration_sec ni qaytaradi. spam_risk_too_many_posts yoki reached_active_user_cap xatosi kelsa, hozir e'lon qilishni taklif qilmang.

3. 3

   Qoidalarga mos e'lon oynasini ko'rsating

   Ijodkor nickname'i, standart qiymatsiz maxfiylik ro'yxati, standart holatda o'chiq interaktiv tugmalar (ijodkor o'chirgan bo'lsa — nofaol), tijoriy kontentni belgilash tugmasi, oldindan ko'rish va Music Usage Confirmation roziligi bo'lsin. Qayta ishlash bir necha daqiqa olishi mumkinligini ayting.

4. 4

   Postni ishga tushiring (init)

   post_info (title, privacy_level, disable_comment, disable_duet, disable_stitch, brend belgilari) va FILE_UPLOAD yoki PULL_FROM_URL manbali source_info yuboring. Javobda publish_id, fayl yuklashda esa upload_url ham keladi.

5. 5

   Mediani uzating

   FILE_UPLOAD da bo'laklarni bir soat ichida upload_url ga PUT qilasiz. PULL_FROM_URL da TikTok faylni tasdiqlangan manzilingizdan o'zi yuklab oladi.

6. 6

   Natijani kuzating

   publish_id bilan /v2/post/publish/status/fetch/ ni so'rang yoki Content Posting webhook'lariga obuna bo'ling va yakuniy natijani foydalanuvchiga ko'rsating.

privacy_level qiymatlari

Faqat creator info shu ijodkor uchun qaytargan qiymatni yuboring — boshqasi privacy_level_option_mismatch bilan rad etiladi.

Ro'yxat ijodkor akkauntining sozlamalariga bog'liq, shuning uchun uni kodda qattiq yozmang.

Python'da Direct Post

SDK init so'rovini yuboradi, fayl bo'laklarini yuklaydi va wait=True bo'lsa post e'lon qilinguncha yoki xato bo'lguncha holatni tekshiradi.

from socialift import TikTok

async def post_video(token: str, privacy: str, caption: str) -> dict:
    async with TikTok.from_env() as tt:
        info = await tt.creator_info(token)
        if privacy not in info["privacy_level_options"]:
            raise ValueError(f"{privacy} is not allowed for this creator")

        return await tt.publish_video(
            token,
            video="renders/launch.mp4",      # FILE_UPLOAD, SDK bo'laklab yuklaydi
            title=caption,
            privacy_level=privacy,           # auditgacha faqat SELF_ONLY
            disable_comment=info.get("comment_disabled", False),
            disable_duet=info.get("duet_disabled", False),
            disable_stitch=info.get("stitch_disabled", False),
            wait=True,
        )

Audit qilinmagan ilova nimani qila oladi va nimani yo'q

PULL_FROM_URL va FILE_UPLOAD farqi

Ikkala manba Direct Post va Upload videolari uchun ishlaydi. Rasm postlari faqat PULL_FROM_URL ni qo'llab-quvvatlaydi.

Media talablari

Rasm posti, qoralamalar va holatni tekshirish

Rasmlar har doim tasdiqlangan URL'dan olinadi. Inbox'ga yuklash SEND_TO_USER_INBOX bilan tugaydi, shuning uchun e'lonni kutmasdan publish_status bilan tekshiring.

from socialift import TikTok

async def carousel_and_draft(token: str) -> None:
    async with TikTok.from_env() as tt:
        # Direct Post'dan oldin creator_info() — video misolidagi kabi
        carousel = await tt.publish_photos(
            token,
            photo_urls=[
                "https://media.example.com/tiktok/look-1.jpg",
                "https://media.example.com/tiktok/look-2.jpg",
            ],
            title="Kuzgi lookbook",
            description="Yangi kolleksiyadan ikki obraz",
            privacy_level="SELF_ONLY",
            cover_index=0,
            wait=True,
        )
        print(carousel["status"]["status"])   # PUBLISH_COMPLETE

        draft = await tt.upload_video(token, video="renders/raw-cut.mp4")
        state = await tt.publish_status(draft["publish_id"], token)
        print(state["status"])                # PROCESSING_UPLOAD yoki SEND_TO_USER_INBOX

E'lon holatlari

publicaly_available_post_id (API'da aynan shunday yoziladi) faqat post ochiq bo'lib, tasdiqlangandan keyin qaytadi; shaxsiy postlarda ochiq ID bo'lmaydi.

TikTok'ga e'lon qilish: production tekshiruv ro'yxati

• ▸Har bir Direct Post'dan oldin creator info so'rang va maxfiylik ro'yxatini privacy_level_options dan quring.
• ▸Maxfiylik va interaktiv sozlamalarga standart qiymat qo'ymang; ijodkor o'chirganlarini nofaol qiling.
• ▸Bitta user token uchun daqiqasiga 6 ta init va 30 ta holat so'rovidan oshmang.
• ▸spam_risk_too_many_posts va spam_risk_too_many_pending_share ni qayta urinish sikli emas, pauza sifatida qabul qiling.
• ▸TikTok'ga yuboriladigan kontent ustiga logo, watermark, havola yoki reklama matni qo'shmang.
• ▸Media URL'larini redirect'siz, tasdiqlangan HTTPS prefiksida saqlang.
• ▸Har bir xato javobidagi log_id ni TikTok qo'llab-quvvatlashi uchun logga yozing.