Reels dan jadual berulang melalui API & MCP

Semua yang boleh anda lakukan dalam kalendar Posto untuk video Reels dan jadual berulang juga boleh dijalankan daripada n8n, Zapier, sistem agensi, atau pembantu AI. Semuanya tidak menggunakan Kredit AI, kecuali variasi kapsyen AI pada jadual berulang jika dihidupkan. Cara mencipta kunci API dan menyambungkan pembantu AI ada dalam API dan MCP.

Siapa yang boleh menggunakannya?

• Anda memerlukan akses API & MCP (pelan Agency, atau tambahan API & MCP).
• Video Reels hanya untuk pelan Pro, Ultimate dan Agency, dengan had video baharu sehari mengikut pelan. Lihat Hasilkan video Reels daripada karusel.
• Jadual berulang untuk pelan berbayar, dengan bilangan siri aktif mengikut pelan. Lihat Jadual berulang.
• Kunci API memerlukan kebenaran Jadual untuk jadual dan siri, serta Cipta kandungan untuk membuat video.

Menjadualkan sebagai Reels

1. Panggil POST /api/v1/schedules seperti biasa, kemudian tambah "format": "reels".
2. Pilihan: tetapkan video melalui "video", contohnya {"secondsPerSlide": 3, "transition": "fade"}. Kosong = tetapan lalai.
3. Pantau dengan GET /api/v1/schedules/{id}. Setiap akaun mempunyai reelsStep: video (video sedang dibuat), upload, processing (diproses platform), kemudian published.

Mahu menukar masa, kapsyen atau format sebelum diterbitkan? Gunakan PATCH /api/v1/schedules/{id}. Akaun sasaran tidak boleh ditukar; batalkan dan buat jadual baharu.

Mencipta jadual berulang

1. Panggil POST /api/v1/schedule-series dengan karusel, platform, peraturan (rule) dan tarikh mula (startsOn).
2. Peraturan: freq daily, weekly (isi byWeekday, 0 = Ahad hingga 6 = Sabtu), atau monthly (isi byMonthDay, 1–28 atau -1 untuk hari terakhir), masa time dalam zon waktu jenama, dan pengakhiran pilihan until (tarikh) atau count (bilangan siaran).
3. Siaran untuk 14 hari akan datang terus muncul dalam kalendar (GET /api/v1/schedules, dengan seriesId). Selebihnya dijadualkan secara automatik.

curl -X POST https://posto.id/api/v1/schedule-series \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Idempotency-Key: seri-promo-gajian" \
  -H "Content-Type: application/json" \
  -d '{"carouselId":"<id carousel>","platforms":["instagram"],"rule":{"freq":"weekly","interval":1,"byWeekday":[1,4],"time":"19:00","count":8},"startsOn":"2026-10-26","format":"reels"}'

Urus siri dengan PATCH /api/v1/schedule-series/{id} (berkuat kuasa untuk siaran seterusnya), POST …/pause, POST …/resume dan DELETE /api/v1/schedule-series/{id} untuk menamatkannya. Siaran yang sudah diterbitkan tidak dipadam.

Memuat turun video Reels

1. Panggil POST /api/v1/carousels/{id}/video-exports. Respons mengandungi id dan status queued.
2. Semak GET /api/v1/carousels/{id}/video-exports/{exportId} sehingga ready, kemudian muat turun daripada video.url.
3. Pautan sah selama 24 jam (video.expiresAt). Permintaan yang sama tidak membuat video baharu dan tidak menambah kiraan had harian.

curl -X POST https://posto.id/api/v1/carousels/<id carousel>/video-exports \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"secondsPerSlide":3,"transition":"fade"}'

Melalui pembantu AI (MCP)

Minta pembantu anda, contohnya "Jadualkan karusel ini sebagai Reels hari Jumaat jam 7 malam" atau "Siarkan semula karusel ini setiap Isnin dan Khamis jam 7 malam, 8 kali". Alat yang digunakan: schedule_post (dengan format Reels), create_schedule_series, list_schedule_series, pause_schedule_series, resume_schedule_series, end_schedule_series dan export_reels_video. Pembantu mengulang peraturan jadual kepada anda sebelum mencipta siri dan meminta pengesahan sebelum menamatkannya.

Alat pembantu AI lain

• Akaun & siaran: list_accounts (akaun bersambung setiap jenama, had kapsyen setiap platform), get_tiktok_creator_info (pilihan privasi TikTok yang dibenarkan), list_posts, get_post (status & pautan setiap platform, sebab gagal), update_post dan cancel_post.
• Kredit AI selamat: create_carousel dengan planOnly: true memberi anggaran bilangan slaid & Kredit AI tanpa menolak Kredit AI; strictSlides: true menolak jika slaid perlu dikurangkan. idempotencyKey menjadikan cubaan semula selamat (tiada potongan berganda). get_carousel mengandungi captionLimits setiap platform.
• Tanpa kunci API dalam Claude: tambah Posto sebagai custom connector di claude.ai dengan URL https://posto.id/mcp. Lihat Sambungkan Posto ke Claude sebagai custom connector.

Makluman melalui webhook

Pasang webhook untuk acara series.paused (siri dijeda, automatik atau manual) dan series.ended (siri selesai atau ditamatkan). Acara post.published dan post.failed kini juga mengandungi format dan seriesId.

Masih keliru? Hubungi [email protected].