Đăng bài

• X-Api-Keystring · headerbắt buộc

  API key của bạn, tạo ở trang API key trong tài khoản.

• teamIdstring (guid)bắt buộc

  Nhóm dùng để đăng — bài đi qua các tài khoản đã kết nối của nhóm

• platformsobject[]bắt buộc

  Mỗi nền tảng cần đăng một phần tử, ít nhất một

  Hiện thuộc tính conẨn thuộc tính con

  • platformstringbắt buộc

    Nền tảng, không phân biệt hoa thường. Nhận X thay cho Twitter. Phải đã kết nối trong nhóm

    Giá trị có thể:TikTokYouTubeInstagramFacebookThreadsTwitter

  • captionstring

    Nội dung bài — TikTok, Facebook, Instagram, Threads, X. Bắt buộc cho mọi nền tảng của bài chỉ có chữ

  • titlestring

    Tiêu đề video — YouTube

  • descriptionstring

    Mô tả video — YouTube

  • typestring

    Loại bài, để thay loại mặc định (bảng Loại bài mặc định bên dưới)

    Giá trị có thể:POSTREELSTORYSHORTVIDEOIMAGE

  • privacystring

    TikTok: PUBLIC_TO_EVERYONE, SELF_ONLY, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR. YouTube: PUBLIC, PRIVATE, UNLISTED. Bỏ trống: công khai

    Giá trị có thể:PUBLIC_TO_EVERYONESELF_ONLYMUTUAL_FOLLOW_FRIENDSFOLLOWER_OF_CREATORPUBLICPRIVATEUNLISTED

  • textFormatPresetIdstring

    Bài chỉ có chữ trên Facebook (không có jobId, videoUrl, imageUrls): nền màu phía sau phần chữ. Bỏ trống: bài chữ thường. Có ảnh hoặc video thì Facebook bỏ nền; nền tảng khác bỏ qua. Lấy ID từ GET /publishing/facebook/text-presets (trang Nền chữ Facebook). ID không có thật vẫn được nhận và hỏng lúc đăng

  • musicSoundIdstring

    Bài ảnh TikTok: songClipId của một bản nhạc lấy từ GET /publishing/tiktok/music (trang Nhạc TikTok). Bỏ trống: TikTok tự chọn. Bài video và nền tảng khác bỏ qua

• jobIdstring

  Một job video đã xong của bạn trên sangtao.ai: đăng video của job (và ảnh bìa, nếu bỏ trống thumbnailUrl). Được ưu tiên hơn videoUrl

• videoUrlstring

  URL công khai của video — tải được không cần đăng nhập và còn hạn tới lúc đăng

• imageUrlsstring[]

  URL ảnh công khai, tối đa 35; mỗi nền tảng chỉ lấy đến mức nó cho phép (TikTok 35, Instagram 20, Threads 20, Facebook 10, X 4)

• thumbnailUrlstring

  Ảnh bìa cho YouTube, Facebook, Instagram. TikTok lấy một khung hình trong video — xem coverTimeMs

• coverTimeMsnumber

  Video TikTok: thời điểm trong video làm ảnh bìa, tính bằng mili-giây, 0–600000. Bỏ trống: đầu video

• scheduleAtstring

  Thời điểm đăng (ISO 8601, UTC). Bỏ trống: đăng ngay

• firstCommentstring

  Bình luận tự động sau khi bài lên. Hiện chỉ áp dụng cho Facebook

• idempotencyKeystring

  Gửi lại cùng khoá, cùng nội dung trong 24 giờ: nhận lại đúng bài cũ (idempotentReplay: true), không đăng và không trừ tiền lần hai. Cùng khoá mà nội dung khác: 422 IDEMPOTENCY_KEY_REUSED. Gửi qua header Idempotency-Key cũng được

• webhookUrlstring

  URL https công khai (cổng 443) để nhận kết quả của bài này khi xong — xem Webhook. URL sai trả 422 INVALID_WEBHOOK_URL, trước khi tạo bài hay trừ tiền

• webhookSecretstring

  Dùng để ký các lần giao đó (X-Sangtao-Signature). Tối đa 200 ký tự. Không gửi thì không có chữ ký

Bỏ jobId, videoUrl và imageUrls để đăng chỉ có chữ. Khi đó mọi nền tảng phải là Facebook, X (Twitter) hoặc Threads — TikTok, YouTube, Instagram cần video hoặc ảnh (400 VALIDATION_ERROR nêu tên các nền tảng đó). Mỗi nền tảng cần caption; type là POST hoặc bỏ trống. Với Facebook, textFormatPresetId thêm nền màu; không có thì là bài chữ thường. Giá như một lượt đăng bình thường.

{
  "teamId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "platforms": [
    { "platform": "Facebook", "type": "POST", "caption": "Nội dung bài", "textFormatPresetId": "249307305544279" },
    { "platform": "X", "caption": "Nội dung bài" }
  ]
}

Mỗi nền tảng tự đặt giới hạn — độ dài video, tỉ lệ khung, độ dài caption. Không được kiểm trước khi đăng; bài vi phạm sẽ thất bại trên nền tảng đó, lý do ở platforms[].error.

• postIdstring (guid)bắt buộc

  ID bài đăng — theo dõi bằng Lấy một bài đăng

• statusstringbắt buộc

  Pending: đã nhận, đang chờ xử lý

• statusMessagestring | null

  Ghi chú ngắn về trạng thái

• idempotentReplayboolean

  Chỉ có (true) khi đây là lần gọi lại cùng idempotencyKey: bài đã tạo từ trước

Mỗi lần gọi endpoint này là một lượt đăng, dù đăng lên bao nhiêu nền tảng. Bài hẹn giờ được tính ngay lúc gọi.